1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
|
Rdzenne widżety
===============
Niektóre z tych widżetów ma ograniczenia, które mogą ograniczać typ strony, na której można umieszczać widżet lub mogą wymagać logowania
* clock - wyświetla aktualny czas
* args: military (1 or 0) - use 24 hour time as opposed to AM/PM
<br /> <br />
* profile - wyświetla boczny pasek profilu na stronach, które ładują profile (strony z pseudonimem w adresie URL)
* tagcloud - wyświetla tagcloud elementów strony
* args: count - liczba elementów do jednoczesnego wyświetlenia (domyślnie 24)
<br /> <br />
* collections - selektor grupy prywatności dla aktualnie zalogowanego kanału
* args: mode - może to być "conversation", "group" albo "abook" w zależności od modułu
<br /> <br />
* suggestions - sugestie znajomych dla aktualnie zalogowanego kanału
* follow - przedstawia pole tekstowe do śledzenia innego kanału
* notes - obszar prywatnych notatek dla aktualnie zalogowanego kanału, jeśli funkcja private_notes jest włączona
* savedsearch - wyszukiwanie sieci lub matrycy z zapisem - trzeba być zalogowanym i musi być włączona funkcjonalność savedsearch
* filer - wybór elementów pola ze strumienia sieci lub matrycy - musi się być zalogowanym
* archive - selektor zakresu dat dla stron sieci i kanałów
* args: 'wall' - 1 or 0, ograniczenie do wpisów ściennych lub wpisów sieciowych/matrycowych (domyślnie)
<br /> <br />
* fullprofile - taki sam jak obecny profil
* categories - filtr kategorii (strona kanału)
* tagcloud_wall - tagcloud tylko dla strony kanału
* args: 'limit' - ilość tagów do wyświetlenie (domyślnie 50)
<br /> <br />
* catcloud_wall - tagcloud dla kategorii stron kanału
* args: 'limit' - liczba kategorii do wyświetlenia na jednej stronie (domyślnie 50)
<br /> <br />
* affinity - suwak powinowactwa na stronie sieciowej, trzeba być zalogowanym
* settings_menu - menu paska bocznego dla strony ustawień, trzeba być zalogowanym
* mailmenu - menu paska bocznego dla strony z prywatnymi wiadomościami, trzeba sie zalogować
* design_tools - menu narzędzi projektowych do tworzenia stron internetowych, trzeba sie zalogować
* findpeople - narzędzia do wyszukiwania innych kanałów
* photo_albums - wyświetla listę albumów ze zdjęciami aktualnego właściciela strony za pomocą menu wyboru
* vcard - mini pasek boczny profilu dla osoby, którą się jest zainteresowanym (właściciel strony, cokolwiek)
* dirsafemode - narzędzie do wyboru katalogu - tylko na stronach katalogów
* dirsort - narzędzie do wyboru katalogu - tylko na stronach katalogów
* dirtags - narzędzie katalogowe - tylko na stronach katalogów
* menu_preview - wyświetlanie podgląd menu - tylko na stronach edycji menu
* chatroom_list - lista czatów dla właściciela strony
* bookmarkedchats - lista zakładek do czatów zebranych na tej stronie dla obecnego obserwatora
* suggestedchats - "ciekawe" czaty wybrane dla obecnego obserwatora
* item - wyświetla pojedynczą stronę internetową zgodnie z argumentem mid lub title
* args:
* channel_id - kanał, do którego należy treść, domyślnie jest to profile_uid
* mid - message_id strony do wyświetlenia (musi być to strona internetowa a nie element konersacji)
* title - argument title w adresie URL strony internetowej (musi zawierać tutuł lub mid)
<br /> <br />
* photo - wyświetla pojedyncze zdjęcie
* args:
* url - adres URL zdjęcia, musu zawierać schemat http lub https
* zrl - uwierzytelniony link zid
* style - łańcuch stylu CSS
<br /> <br />
* cover_photo - wyświetla zdjęcie okładkowe dla wybranego kanału
* args:
* channel_id - zastosowany kanał, domyślnie jest to profile_uid
* style - łańcuch stylu CSS (domyślnie jest dynamicznie ustawiane na szerokość regionu)
<br /> <br />
* photo_rand - wyświetla losowe zdjęcie z jednego z albumów fotograficznych. Honorowane są uprawnienie dostępu do zdjęć
* args:
* album - nazwa albumu (bardzo gorąco zalecane, jeśli ma się dużo zdjęć)
* scale - zazwyczaj 0 (oryginalna wielkość), 1 (1024px), 2, (640px) lub 3 (320px)
* style - łańcuch stylu CSS
* channel_id - jeśli nie Twój
<br /> <br />
* random_block - wyświetlić losowy element blokowy z kolekcji narzędzi do projektowania stron internetowych. Honorowane są uprawnienia dostępu.
* args:
* contains - zwraca tylko bloki, które zawierają łańcuch cotains w nazwie bloku
* channel_id - jeśłi nie Twój
<br /> <br />
* tasklist - podać listę zadań lub spraw do załatwienia dla aktualnie zalogowanego kanału.
* args:
* all - jeśłi nie 0, to wyświetla ukończone zadania.
<br /> <br />
* forums - podać listę połączonych forów publicznych z niewidocznymi liczbami dla aktualnie zalogowanego kanału.
<br /> <br />
* activity - podać listę autorów nieprzeczytanych treści sieciowych dla aktualnie zalogowanego kanału.
* album - udostępnia widget zawierający pełny album ze zdjęciami z albumów należących do właściciela strony; może być zbyt duży, aby wyświetlić go w regionie paska bocznego, więc najlepiej jest zaimplementować to jako widżet obszaru treści.
* args:
* album - nazwa albumu
* title - opcjonalny tytuł, używana jest nazwa albumu, jeśli nie jest dostęþna
<br /> <br />
Tworzenie własnych widżetów
===========================
### Widżety oparty na klasie
Aby utworzyć widżet oparty, na przykład, na klasie o nazwie "slugfish", utwórz plik o następującej zawartości:
````
<?php
namespace Zotlabs\Widget;
class Slugfish {
function widget($args) {
... Wstaw tutaj kod widżetu.
... Funkcja ta zwraca łańcuch, który jest treścią HTML widżetu.
... $args to nazwa tablicy, która przekazuje sowolne zmienne [var] z edytora układu
... Na przykład [widget=slugfish][var=count]3[/var][/widget] wypełni $args tak:
... [ 'count' => 3 ]
}
````
Wynikowy plik można umieścić w widget/Slugfish/Slugfish.php lub Zotlabs/SiteWidgets/Slugfish.php. Można go również połączyć z repozytorium git za pomocą pliku util/add_widget_repo.
### Tradycyjny widget oparty na funkcjach
Jeśli chcesz mieć widżet o nazwie, na przykład, "slugfish", utwórz `widget/widget_slugfish.php` zawierający
<?php
function widget_slugfish($args) {
.. wstaw tu kod widżetu. Zobacz powyższe informacje o widżetach opartych na klasie, aby uzyskać szczegółowe informacje.
}
#include doc/macros/main_footer.bb;
|
