Tagi
Z JoggerWiki
Lista i opisy dostępnych tagów Joggera 2.0. Nowe tagi są odpowiednio zaznaczone.
Spis treści
- 1 Wpis (ENTRY)
- 1.1 ENTRY_BLOCK
- 1.2 ENTRY_DAY_BLOCK
- 1.3 ENTRY_SUBJECT
- 1.4 ENTRY_DATE
- 1.5 ENTRY_HOUR
- 1.6 ENTRY_ID
- 1.7 ENTRY_LEVEL
- 1.8 ENTRY_CONTENT
- 1.9 ENTRY_CONTENT_SHORT (NOWY)
- 1.10 ENTRY_CONTENT_SHORT_EXIST (NOWY)
- 1.11 ENTRY_CONTENT_SHORT_NOT_EXIST (NOWY)
- 1.12 ENTRY_CONTENT_LONG (NOWY)
- 1.13 ENTRY_COMMENT_HREF
- 1.14 ENTRY_COMMENT_HREF_DESCR
- 1.15 ENTRY_CLASS
- 1.16 ENTRY_CLASS_RESET
- 1.17 ENTRY_CATEGORY_BLOCK (NOWY)
- 1.18 ENTRY_CATEGORY_CLASS (NOWY)
- 1.19 ENTRY_CATEGORY_HREF (NOWY)
- 1.20 ENTRY_CATEGORY_HREF_DESCR (NOWY)
- 1.21 ENTRY_CATEGORY_HREF_DESCR2 (NOWY)
- 1.22 ENTRY_CATEGORY_NOT_LAST (NOWY)
- 2 Archwium wpisów (ARCHIVE)
- 3 Kategorie wpisów (CATEGORY) (NOWY)
- 4 Linki (LINK)
- 5 Komentarze (COMMENT)
- 6 Formularz komentarzy (COMMENT_FORM)
- 6.1 COMMENT_FORM
- 6.2 COMMENT_FORM2 (w starym stylu, oparty na tabeli)
- 6.3 COMMENT_FORM_BLOCK (NOWY)
- 6.4 COMMENT_FORM_ACTION (NOWY)
- 6.5 COMMENT_FORM_BODY (NOWY)
- 6.6 COMMENT_FORM_CODE (NOWY)
- 6.7 COMMENT_FORM_NICKID (NOWY)
- 6.8 COMMENT_FORM_NICKURL (NOWY)
- 6.9 COMMENT_FORM_NOTIFY_START_BLOCK (NOWY)
- 6.10 COMMENT_FORM_NOTIFY_STOP_BLOCK (NOWY)
- 6.11 COMMENT_FORM_NOUSER_BLOCK (NOWY)
- 6.12 COMMENT_LOGGED_BLOCK (NOWY)
- 6.13 COMMENT_NONE_BLOCK (NOWY)
- 7 Admin (ADMIN)
- 8 Niezalogowany użytkownik (NOUSER)
- 9 Zalogowany użytkownik (LOGGED_USER)
- 10 status i opis Jabbera
- 11 Inne
- 12 Lista pozostałych tagów
Wpis (ENTRY)
ENTRY_BLOCK
- typ
- wymagany tag otwierający i tag zamykający (
<ENTRY_BLOCK> ... </ENTRY_BLOCK>
) - stosowanie
- strona główna joggera
- działanie
- wstawia wpisy
- przykład
<ENTRY_BLOCK> <div class="entry"> <h2 id="&ENTRY_ID;"><a href="&ENTRY_COMMENT_HREF;"><ENTRY_SUBJECT/></a></h2> <p><ENTRY_LEVEL/> poziom | <ENTRY_DATE/>, <ENTRY_HOUR/><br /> kategoria: <ENTRY_CATEGORY_BLOCK> <a href="&ENTRY_CATEGORY_HREF;"><ENTRY_CATEGORY_HREF_DESCR/></a> <ENTRY_CATEGORY_NOT_LAST>, </ENTRY_CATEGORY_NOT_LAST> </ENTRY_CATEGORY_BLOCK></p> <p><ENTRY_CONTENT/></p> <ADMIN_BLOCK> <span> <a href="&ADMIN_ENTRY_EDIT_HREF;">Edytuj</a>, <a href="&ADMIN_ENTRY_REMOVE_HREF;">Usuń</a>. </span> </ADMIN_BLOCK> <p><a href="&ENTRY_COMMENT_HREF;"><ENTRY_COMMENT_HREF_DESCR/></a></p> </div> </ENTRY_BLOCK>
ENTRY_DAY_BLOCK
- typ
- znacznik opcjonalny; wymagany tag otwierający i tag zamykający (
<ENTRY_DAY_BLOCK> ... </ENTRY_DAY_BLOCK>
) - stosowanie
- strona główna joggera
- działanie
- użycie tego znacznika nie jest obowiązkowe. Służy on do grupowania wpisów z jednego dnia, zatem jeśli w projekcie szablonu każdy wpis jest oddzielną jednostką, ten znacznik nie będzie przydatny.
- przykład
<ENTRY_BLOCK> <div class="dzien"> <h2>dzień <ENTRY_DATE/></a> roku:</h2> <ENTRY_DAY_BLOCK> <div class="entry"> <h2 id="&ENTRY_ID;"><a href="&ENTRY_COMMENT_HREF;"><ENTRY_SUBJECT/></a></h2> <p><ENTRY_LEVEL/> poziom |<ENTRY_HOUR/><br /> kategoria: <ENTRY_CATEGORY_BLOCK> <a href="&ENTRY_CATEGORY_HREF;"><ENTRY_CATEGORY_HREF_DESCR/></a> <ENTRY_CATEGORY_NOT_LAST>, </ENTRY_CATEGORY_NOT_LAST> </ENTRY_CATEGORY_BLOCK></p> <p><ENTRY_CONTENT/></p> <p><a href="&ENTRY_COMMENT_HREF;"><ENTRY_COMMENT_HREF_DESCR/></a></p> </div> <ADMIN_BLOCK> <span> <a href="&ADMIN_ENTRY_EDIT_HREF;">Edytuj</a>, <a href="&ADMIN_ENTRY_REMOVE_HREF;>Usuń</a>. </span> </ADMIN_BLOCK> </ENTRY_DAY_BLOCK> <hr /> </div> </ENTRY_BLOCK>
- uwagi
- Należy zwrócić uwagę na położenie nagłówka h2 zawierającego znacznik ENTRY_DATE oraz na położenie poziomej linii
<hr />
ENTRY_SUBJECT
- typ
- pojedynczy, zapis:
<ENTRY_SUBJECT/>
lub&ENTRY_SUBJECT;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
- działanie
- wstawia tytuł wpisu (tytuły dodaje się wysyłając w kliencie Jabbera wpis jako wiadomość, a nie jako czat).
ENTRY_DATE
- typ
- pojedynczy, zapis:
<ENTRY_DATE/>
lub&ENTRY_DATE;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
- działanie
- wstawia datę (dzień, miesiąc (słownie) i rok) wysłania wpisu lub wpisów.
ENTRY_HOUR
- typ
- pojedynczy, zapis:
<ENTRY_HOUR/>
lub&ENTRY_HOUR;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
- działanie
- wstawia godzinę wysłania wpisu (w formacie GG:MM:SS).
ENTRY_ID
- typ
- pojedynczy, zapis:
<ENTRY_ID/>
lub&ENTRY_ID;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
- działanie
- wstawia numer ID wpisu w bazie Joggera. Można tego użyć, by stworzyć zakotwiczenie do wpisu (ang. anchor link). Wstawiany tekst wygląda np. tak:
e32726
- przykłady
- znacznika mozna użyć po prostu w atrybucie id np. nagłowka wpisu:
<h2 id="&ENTRY_ID;"><ENTRY_SUBJECT/></h2>
Można także zrobić od razu odnośnik do danego wpisu, na wypadek, gdyby ktoś chciał podać doń URL:
<h2 id="&ENTRY_ID;"><a href="#&ENTRY_ID;"><ENTRY_SUBJECT/></a></h2>
ENTRY_LEVEL
- typ
- pojedynczy, zapis:
<ENTRY_LEVEL/>
lub&ENTRY_LEVEL
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
- działanie
- wstawia liczbę oznaczającą poziom dostępności wpisu. Poziom ten określa się poprzedzając treść wpisu znacznikiem
<LEVELx>
, gdzie x to liczba od 0 do 10. Poziom 0 oznacza, że wpis będzie widoczne dla każdego, a oprócz tego (i tym różni się od poziomu 1.) zostanie wyświetlony na stronie głównej Joggera, w częsci "Ostatnio dodane wpisy". Poziomy od 2 do 10 są już prywatne, by przeczytać takie wpisy, należy się zalogować. - przykład
- Znacznika
<ENTRY_LEVEL>
można użyć na przykład do określenia koloru tła tytułu w zależności od poziomu dostępności wpisu.
<h2 class="poziom&ENTRY_LEVEL;" id="&ENTRY_ID;"><ENTRY_SUBJECT/></h2>
- CSS:
.poziom0 { background-color: #fff; } .poziom1 { background-color: #eee; } .poziom2 { background-color: #ddd; } .poziom3 { background-color: #ccc; } (...)
- uwagi
- Znacznika można użyć na wiele sposobów. Można po prostu przy każdym wpisie wyświetlić jego poziom dostępności, można (tak jak wyżej) zmieniać kolory tła wpisów, można użyć atrybutu title, lub pseudoelementów CSS :before i :after (np.
.poziom2:after { content: " (Wpis ukryty)" }
- pomysł XyCastego. Wszystko jest dozwolone.
ENTRY_CONTENT
- typ
- pojedynczy, zapis:
<ENTRY_CONTENT/>
lub&ENTRY_CONTENT;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
- działanie
- Wstawia treść wpisu.
ENTRY_CONTENT_SHORT (NOWY)
- typ
- pojedynczy, zapis:
<ENTRY_CONTENT_SHORT/>
lub&ENTRY_CONTENT_SHORT;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
- działanie
- Znacznik działa podobnie do ENTRY_CONTENT (wstawia treść wspisu), lecz, gdy w treści tej napotka
<EXCERPT>
, to obcina wszystko co jest za tym tagiem (praktyczne użycie może sprowadzać się tylko do strony głównej szablonu, na stronie komentarzy zalecany byłby znacznik ENTRY_CONTENT).
ENTRY_CONTENT_SHORT_EXIST (NOWY)
- typ
- wymagany tag otwierający i tag zamykający (
<ENTRY_CONTENT_SHORT_EXIST> ... </ENTRY_CONTENT_SHORT_EXIST>
) - stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) (lecz działa także w szablonie komentarzy)
- działanie
- Zawartość bloku będzie pokazana jedynie wtedy, gdy istnieje skrót wpisu (działa znacznik ENTRY_CONTENT_SHORT czyli we wpisie jest EXCERPT).
- uwagi
- Główne wykorzystanie znacznika sprowadza się do ukrywania / pokazywania linka "Czytaj dalej" dla wpisów skróconych na stronie głównej
- przykład
<ENTRY_CONTENT_SHORT/> <ENTRY_CONTENT_SHORT_EXIST> <p class="readmore"> <a href="&ENTRY_COMMENT_HREF;#more">Czytaj dalej...</a> </p> </ENTRY_CONTENT_SHORT_EXIST>
ENTRY_CONTENT_SHORT_NOT_EXIST (NOWY)
- typ
- wymagany tag otwierający i tag zamykający (
<ENTRY_CONTENT_SHORT_NOT_EXIST> ... </ENTRY_CONTENT_SHORT_NOT_EXIST>
) - stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) (lecz działa także w szablonie komentarzy)
- działanie
- Zawartość bloku będzie pokazana jedynie wtedy, gdy nie istnieje skrót wpisu (nie działa znacznik ENTRY_CONTENT_SHORT bo we wpisie nie ma EXCERPT).
ENTRY_CONTENT_LONG (NOWY)
- typ
- pojedynczy (
<ENTRY_CONTENT_LONG/>)
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK), szablon komentarzy
- działanie
- Działa tak samo jak ENTRY_CONTENT_SHORT lecz pokazuje treść wpisu po EXCERPT.
- uwagi
- Wykorzystując znacznik możemy rozbić wpisy wykorzystujące skróty EXCERPT na dwie części. Można dzięki temu utworzyć dowiązanie do drugiej części i utworzyć link przeskakujący od razu do niej ze strony głównej joggera (przykład dostępny w opisie znacznika ENTRY_CONTENT_SHORT_EXIST.
- przykład
<ENTRY_CONTENT_SHORT/> <ENTRY_CONTENT_SHORT_EXIST> <div id="more"> <ENTRY_CONTENT_LONG/> </div> </ENTRY_CONTENT_SHORT_EXIST>
ENTRY_COMMENT_HREF
- typ
- pojedynczy, zapis: <code><ENTRY_COMMENT_HREF/> lub
&ENTRY_COMMENT_HREF;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) i na stronie komentarzy
- działanie
- Wstawia URL / permalink do wpisu. Może być używany jako link do strony z komentarzami na stronie głównej joggera oraz wskaźnik na aktualny wpis na stronie komentarzy.
ENTRY_COMMENT_HREF_DESCR
- typ
- pojedynczy, zapis:
<ENTRY_COMMENT_HREF_DESCR/>
lub&ENTRY_COMMENT_HREF_DESCR;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK) oraz strona z komentarzami
- działanie
- Wstawia tekst odnośnika do stron z komentarzami. Jeśli nie ma żadnych komentarzy, wtedy jest to "Dodaj komentarz". Jeśli komentarze są - np. "1 komentarz", "3 komentarze", "5 komentarzy". Jeśli komentarze są wyłączone, pojawi się napis "Komentarze zablokowane".
- uwagi
- Ponieważ możliwe jest, że kilka wpisów nie będzie miało żadnego komentarza lub będą miały taką samą ich liczbę, może się zdarzyć, że na stronie będzie kilka odnośników tak samo opisanych, a prowadzących do różnych stron. Może to spowodować nieporozumienia, szczególnie w przeglądarkach tekstowych lub dźwiękowych. Dlatego zalecany jest zapis:
<a href="&ENTRY_COMMENT_HREF;"> <ENTRY_COMMENT_HREF_DESCR/><span class="ukryj"> do wpisu <em><ENTRY_SUBJECT/></em></span> </a>
- Klasa "ukryj" powinna zostać w CSS zdefiniowana następująco:
.ukryj { text-indent: -1000em; }
- Dzieki temu, przeglądając stronę bez CSS, zamiast napisu "2 komentarze" w trzech różnych miejscach, zobaczymy: "2 komentarze do wpisu Pierwszy", "2 komentarze do wpisu Drugi", "2 komentarze do wpisu Trzeci". Zastosowanie
display: none
jest o tyle złe, że pozbawimy użytkowników czytników ekranu tej treści także.
ENTRY_CLASS
- typ
- pojedynczy, zapis:
<ENTRY_CLASS>
lub&ENTRY_CLASS;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK)
- działanie
- Działa analogicznie do znacznika COMMENT_CLASS - naprzemiennie wstawia tekst
entry1
ientry2
. Można go użyć zarówno do wpisów jak i do całych dni, o ile w szablonie zastosowano znacznik ENTRY_DAY_BLOCK. ENTRY_CLASS zawsze wstawia wspomniane teksty naprzemiennie - bez względu na liczbę wpisów zgrupowanych pod jedną datą. - uwagi
- patrz ENTRY_CLASS_RESET
ENTRY_CLASS_RESET
- typ
- pojedynczy, zapis:
<ENTRY_CLASS_RESET>
lub&ENTRY_CLASS_RESET;
- stosowanie
- strona główna joggera (w bloku ENTRY_BLOCK)
- działanie
- Działa tylko w połączeniu z ENTRY_CLASS. Nie ma ściśle wyznaczonego miejsca, może zostać wpisany gdziekolwiek w bloku ENTRY_BLOCK. Powoduje zignorowanie dotychczasowego porządku działania ENTRY_CLASS i ponowne rozpoczęcie od
entry1
. Znacznik ten może być przydatny, jeśli wpisy zgrupowane pod wspólną datą mają zmieniać klasy lokalnie, a nie globalnie. W takim przypadku każdy pierwszy wpis danego dnia miałby klasęentry1
.
ENTRY_CATEGORY_BLOCK (NOWY)
- typ
- wymagany tag otwierający i zamykający (
<ENTRY_CATEGORY_BLOCK> ... </ENTRY_CATEGORY_BLOCK>
) - stosowanie
- szablon strony głównej i szablon komentarzy (pomiędzy znacznikami
<ENTRY_BLOCK> ... </ENTRY_BLOCK>
) - działanie
- w tym bloku umieszczona jest kategoria danego wpisu
- przykład
<ENTRY_BLOCK> <div class="entry"> <h2 id="&ENTRY_ID;"><a href="&ENTRY_COMMENT_HREF;"><ENTRY_SUBJECT/></a></h2> <p><ENTRY_LEVEL/> poziom | <ENTRY_DATE/>, <ENTRY_HOUR/><br /> kategoria: <ENTRY_CATEGORY_BLOCK> <a href="&ENTRY_CATEGORY_HREF;"><ENTRY_CATEGORY_HREF_DESCR/></a> <ENTRY_CATEGORY_NOT_LAST>, </ENTRY_CATEGORY_NOT_LAST> </ENTRY_CATEGORY_BLOCK></p> <p><ENTRY_CONTENT/></p> <p><a href="&ENTRY_COMMENT_HREF;"><ENTRY_COMMENT_HREF_DESCR/></a></p> </div> </ENTRY_BLOCK>
ENTRY_CATEGORY_CLASS (NOWY)
- typ
- pojedynczy, zapis:
&ENTRY_CATEGORY_CLASS;
lub<ENTRY_CATEGORY_CLASS/>
- stosowanie
- blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia naprzemiennie tekst
entrycategory1
ientrycategory2
; działa analogicznie do ENTRY_CLASS i COMMENT_CLASS (wykorzystywany, gdy w użyciu jest ENTRY_CATEGORY_HREF_DESCR2)
ENTRY_CATEGORY_HREF (NOWY)
- typ
- pojedynczy, zapis:
&ENTRY_CATEGORY_HREF;
lub<ENTRY_CATEGORY_HREF/>
- stosowanie
- blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia URL do kategorii (przy notce)
ENTRY_CATEGORY_HREF_DESCR (NOWY)
- typ
- pojedynczy, zapis:
&ENTRY_CATEGORY_HREF_DESCR;
lub<ENTRY_CATEGORY_HREF_DESCR/>
- stosowanie
- blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia tytuł (opis) linku kategorii (przy notce)
ENTRY_CATEGORY_HREF_DESCR2 (NOWY)
- typ
- pojedynczy, zapis:
&ENTRY_CATEGORY_HREF_DESCR2;
lub<ENTRY_CATEGORY_HREF_DESCR2/>
- stosowanie
- blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- Wstawia tytuły jednej lub więcej kategorii przy wpisie; każda z nich odzielona jest przecinkiem. Wykorzystywane, gdy użytkownik chce dodawać wpisy nie tylko do jednej kategorii).
ENTRY_CATEGORY_NOT_LAST (NOWY)
- typ
- wymagany tag otwierający i tag zamykający (
<ENTRY_CATEGORY_NOT_LAST> ... </ENTRY_CATEGORY_NOT_LAST>
) - stosowanie
- blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- Jego zawartość zostanie wstawiona, jeśli kategoria wpisu nie jest ostatnią z kategorii, do których należy wpis. Wykorzystywane, gdy użytkownik chce dodawać wpisy nie tylko do jednej kategorii).
Archwium wpisów (ARCHIVE)
ARCHIVE_BLOCK
- typ
- wymagany tag otwierający i tag zamykający (
<ARCHIVE_BLOCK> ... </ARCHIVE_BLOCK>
) - stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- w tym bloku należy umieścić kod odpowiadający za wyświetlanie linków do stron z poprzednimi wpisami.
- przykład
Starsze wpisy: <ul> <ARCHIVE_BLOCK> <li><a href="&ARCHIVE_HREF;"><ARCHIVE_HREF_DESCR/></a></li> </ARCHIVE_BLOCK> </ul>
ARCHIVE_ENTRIES (NOWY)
- typ
- pojedynczy, zapis
&ARCHIVE_ENTRIES;
lub<ARCHIVE_ENTRIES/>
- stosowanie
- blok ARCHIVE_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia liczbę wpisów w danym okresie archiwum
ARCHIVE_HREF
- typ
- pojedynczy, zapis:
<ARCHIVE_HREF/>
lub&ARCHIVE_HREF;
- stosowanie
- blok ARCHIVE_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia URL do stron archiwum.
ARCHIVE_HREF_DESCR
- typ
- pojedynczy, zapis:
<ARCHIVE_HREF_DESCR/>
lub&ARCHIVE_HREF_DESCR;
- stosowanie
- blok ARCHIVE_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia nazwy stron archiwum (np. Styczeń 2004 lub - jeśli sortujemy wpisy według ich liczby na stronie - np. 17.02.2004 - 27.01.2004).
ARCHIVE_CLASS (NOWY)
- typ
- pojedynczy, zapis:
&ARCHIVE_CLASS;
lub<ARCHIVE_CLASS/>
- stosowanie
- blok ARCHIVE_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia naprzemiennie tekst
archive1
iarchive2
; działa analogicznie do ENTRY_CLASS i COMMENT_CLASS
ARCHIVE_CURRENT_DESCR (NOWY)
- typ
- pojedynczy, zapis:
&ARCHIVE_CURRENT_DESCR;
lub<ARCHIVE_CURRENT_DESCR/>
- stosowanie
- szablon strony głównej i szablon komentarzy (nie musi znajdywać się w bloku ARCHIVE_BLOCK)
- działanie
- wstawia opis (zależnie od wyboru użytkownika w panelu administracyjnym, czyli albo podział na miesiące, albo na dni) archwium, które jest obecnie oglądane
Kategorie wpisów (CATEGORY) (NOWY)
CATEGORY_BLOCK (NOWY)
- typ
- wymagany tag otwierający i zamykający (
<CATEGORY_BLOCK> ... </CATEGORY_BLOCK>
) - stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- w tym bloku umieszczana jest lista z kategoriami
- przykład
<ul id="categories"> <CATEGORY_BLOCK> <li class="&CATEGORY_CLASS;" id="&CATEGORY_ID;"> <a href="&CATEGORY_HREF;"><CATEGORY_HREF_DESCR/> (<CATEGORY_ENTRIES/>)</a></li> </CATEGORY_BLOCK> </ul>
CATEGORY_CLASS (NOWY)
- typ
- pojedynczy, zapis:
&CATEGORY_CLASS;
lub<CATEGORY_CLASS/>
- stosowanie
- blok CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia naprzemiennie tekst
category1
icategory2
; działa analogicznie do ENTRY_CLASS, COMMENT_CLASS, CATEGORY_CLASS i LINK_CLASS
CATEGORY_ENTRIES (NOWY)
- typ
- pojedynczy, zapis
&CATEGORY_ENTRIES;
lub<CATEGORY_ENTRIES/>
- stosowanie
- blok CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia liczbę wpisów w danej kategorii
CATEGORY_HREF (NOWY)
- typ
- pojedynczy, zapis:
&CATEGORY_HREF;
lub<CATEGORY_HREF/>
- stosowanie
- blok CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia URL do kategorii (lista kategorii)
CATEGORY_HREF_DESCR (NOWY)
- typ
- pojedynczy, zapis
&CATEGORY_HREF_DESCR;
lub<CATEGORY_HREF_DESCR/>
- stosowanie
- blok CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia tytuł (opis) linku prowadzącego do danej kategorii
CATEGORY_ID (NOWY)
- typ
- pojedynczy, zapis
&CATEGORY_ID;
lub<CATEGORY_ID/>
- stosowanie
- blok CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia identyfikator do kategorii
Linki (LINK)
LINK_BLOCK_EXIST (NOWY)
- typ
- wymagany tag otwierający i tag zamykający (
<LINK_BLOCK_EXIST> ... </LINK_BLOCK_EXIST>
) - stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- w tym bloku należy umieścić LINK_BLOCK - jeśli dodaliśmy jakieś linki w panelu administracyjnym, pojawi się wszystko co jest w środku tego bloku
- przykład
<LINK_BLOCK_EXIST> <h3>Linki:</h3> <ul> <LINK_BLOCK> <li><a href="&LINK_HREF;"><LINK_HREF_DESCR/></a></li> </LINK_BLOCK> </ul> </LINK_BLOCK_EXIST>
LINK_GROUP_BLOCK (NOWY)
- typ
- wymagany tag otwierający i zamykający (
<LINK_GROUP_BLOCK> ... </LINK_GROUP_BLOCK>
)
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- w tym bloku umieszczana jest lista kategorii linków oraz linki należące do tej kategorii
- przykład
<ul id="links"> <LINK_GROUP_BLOCK> <li><LINK_GROUP_DESCR/> <LINK_CLASS_RESET/> <ul> <LINK_BLOCK> <li class="&LINK_CLASS;"><a href="&LINK_HREF;"><LINK_HREF_DESCR/></a></li> </LINK_BLOCK> </ul> </li> </LINK_GROUP_BLOCK> </ul>
- uwagi
- należy zauważyć, że blok LINK_BLOCK znajduje się pomiędzy blokiem LINK_GROUP_BLOCK (w innym przypadku jogger wywołuje błąd)
- najlepszym rozwiązaniem tego jest użycie nieuporządkowanej listy
<ul>...</ul>
(jak podano w przykładzie)
LINK_GROUP_DESCR (NOWY)
- typ
- pojedynczy, zapis
&LINK_GROUP_DESCR;
lub<LINK_GROUP_DESCR/>
- stosowanie
- blok LINK_GROUP_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia tytuł (opis) kategorii (grupy) linków
LINK_BLOCK
- typ
- wymagany tag otwierający i tag zamykający (
<LINK_BLOCK> ... </LINK_BLOCK>
) - stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- w tym bloku należy umieścić kod odpowiadający za wyświetlanie linków do stron, które zapamiętamy w panelu konfiguracyjnym Joggera. Odnośniki zostaną wyświetlone w kolejności alfabetycznej. Dzięki tej funkcji można dodawać i usuwać linki do ulubionych stron bez konieczności zmiany kodu szablonu.
- przykład
<ul> <LINK_BLOCK> <li><a href="&LINK_HREF;"><LINK_HREF_DESCR/></a></li> </LINK_BLOCK> </ul>
LINK_HREF
- typ
- pojedynczy, zapis:
<LINK_HREF/>
lub&LINK_HREF;
- stosowanie
- blok LINK_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia URL do polecanych stron. (patrz: wyjaśnienie przy LINK_BLOCK)
LINK_HREF_DESCR
- typ
- pojedynczy, zapis:
<LINK_HREF_DESCR/>
lub&LINK_HREF_DESCR;
- stosowanie
- blok LINK_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia nazwy polecanych stron. (patrz: wyjaśnienie przy LINK_BLOCK)
LINK_TITLE (NOWY)
- typ
- pojedynczy, zapis:
<LINK_TITLE/>
lub&LINK_TITLE;
- stosowanie
- blok LINK_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia opis polecanych stron. (patrz: wyjaśnienie przy LINK_BLOCK)
LINK_CLASS (NOWY)
- typ
- pojedynczy, zapis:
<LINK_CLASS/>
lub&LINK_CLASS;
- stosowanie
- blok LINK_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia naprzemiennie
link1
ilink2
. pomocne przy stylowaniu menu z linkami innym kolorem co drugi link
LINK_CLASS_RESET (NOWY)
- typ
- pojedynczy, zapis:
<LINK_CLASS_RESET/>
- stosowanie
- blok LINK_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- resetuje wypisywanie
link1
,link2
- przydatne gry nowa grupa linków ma być na przykład kolorowana naprzemiennie, ale samodzielnie, a nie jako całość z resztą grup
Komentarze (COMMENT)
COMMENT_BLOCK
- typ
- wymagany tag otwierający i tag zamykający (
<COMMENT_BLOCK>... </COMMENT_BLOCK>
) - stosowanie
- szablon komentarzy
- działanie
- blok służy wyświetlaniu kolejnych komentarzy.
- przykład
<h2>Komentarze:</h2> <COMMENT_BLOCK> <div class="&COMMENT_CLASS;"> <p> <COMMENT_NICK/> | dnia <COMMENT_DATE/>, o godzinie <COMMENT_HOUR/> <ADMIN_BLOCK> <span> <a href="&ADMIN_COMMENT_REMOVE_HREF;">Usuń</a>, <a href="&ADMIN_COMMENT_BLOCKIP_HREF;">Zablokuj IP</a>. </span> </ADMIN_BLOCK> </p> <p><COMMENT_CONTENT/></p> </div> </COMMENT_BLOCK>
COMMENT_CLASS
- typ
- pojedynczy , zapis:
<COMMENT_CLASS/>
lub&COMMENT_CLASS;
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia na zmianę
comment1
lubcomment2
. Dzięki temu można za pomocą CSS zróżnicować wygląd sąsiadujących komentarzy, i tym samym ułatwić ich czytanie. Najczęściej definiuje się odmienne kolory tła lub style obramowania.
COMMENT_NICK
- typ
- pojedynczy, zapis:
<COMMENT_NICK/>
lub&COMMENT_NICK;
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia podpis komentującego. Jeśli komentujący jest użytkownikiem Joggera i w chwili dodawania komentarza był zalogowany do Joggera (zalogować się można na stronie głównej Joggera), wstawiony zostanie podpis będący odnośnikiem do joga komentującego.
COMMENT_DATE
- typ
- pojedynczy, zapis:
<COMMENT_DATE/>
lub&COMMENT_DATE;
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia datę dodania komentarza.
COMMENT_HOUR
- typ
- pojedynczy, zapis:
<COMMENT_HOUR/>
lub&COMMENT_HOUR;
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia godzinę dodania komentarza.
COMMENT_CONTENT
- typ
- pojedynczy, zapis:
<COMMENT_CONTENT/>
lub&COMMENT_CONTENT;
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia treść komentarza.
COMMENT_FAVICON (NOWY)
- typ
- pojedynczy, zapis
&COMMENT_FAVICON;
lub<COMMENT_FAVICON/>
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- znacznik jest podmieniany na favikone zarejestrowanego użytwkownika; wymagany plik w katalogu: favicon.png, favicon.gif, favicon.jpg lub favicon.ico; maksymalna wielkość favikony to 32x32 piksele
- typ
- pojedynczy, zapis
&COMMENT_FAVICON2;
lub<COMMENT_FAVICON2/>
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia czysty link do obrazka (favikony)
- typ
- pojedynczy, zapis
&COMMENT_ID;
lub<COMMENT_ID/>
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia identyfikator komentarza - jego numer w systemie
aby zapobiec rozwalidowaniu się szablonu należy dostawić prefiks, na przykład "comm": <a id="comm&COMMENT_ID;" href="#comm&COMMENT_ID;" title="Permalink do komentarza">Permalink</a>
- typ
- pojedynczy, zapis
&COMMENT_NICK_CLASS;
lub<COMMENT_NICK_CLASS/>
- stosowanie
- szablon komentarzy
- działanie
- Wstawia
owner
jeżeli autorem komentarza jest wlasciciel joggera lubjogger
w przypadku, gdy komentarz jest innego zalogowanego użytkownika joggera, alboguest
jeżeli komentującym jest osoba niezalogowana. Dzięki temu przy pomocy CSS można np. wyróżnić komentarze właściciela joggera. Najczęściej robi się to poprzez zdefiniowanie koloru, bądź obrazka tła lub nadanie komentarzowi obramowania. - uwagi
- patrz COMMENT_CLASS
- przykład
<COMMENT_BLOCK> <div class="<COMMENT_NICK_CLASS/> <COMMENT_CLASS/>"> (...) </div> </COMMENT_BLOCK>
- typ
- pojedynczy, zapis:
<COMMENT_FORM/>
lub&COMMENT_FORM;
- stosowanie
- szablon komentarzy
- działanie
- wstawia cały formularz do dodawania komentarzy.
- przykład
<h2>Dodaj swój komentarz:</h2> <COMMENT_FORM/>
- typ
- pojedynczy, zapis:
<COMMENT_FORM2/>
lub&COMMENT_FORM2;
- stosowanie
- szablon komentarzy
- działanie
- wstawia cały formularz do dodawania komentarzy.
- przykład
<h2>Dodaj swój komentarz:</h2> <COMMENT_FORM2/>
- uwagi
- tag wstawia następującą tabelę (zamiast "Sledź ten wątek..." może być button "Przestań sledzić ten wątek"):
<form action="/comment.php" method="post"> <div><input type="hidden" name="jid" value="[jid_komentowanego]" /> <input type="hidden" name="eid" value="[id_wpisu]" /> <input type="hidden" name="startid" value="0" /> <input type="hidden" name="op" value="addcomm" /></div> <table> <tr> <td>Podpis:</td> <td><input type="text" name="commnickid" <strong>id="commnickid"</strong> value="[Twój_jid]" /></td> </tr> <tr> <td>Treść:</td> <td><textarea name="commbody" <strong>id="commbody"</strong> cols="60" rows="6"></textarea></td> </tr> <tr> <td> </td> <td> <input type="checkbox" name="notifyentry" value="notify" /> Śledź ten wątek i powiadom mnie o nowych komentarzach </td> </tr> <tr> <td> </td> <td><input type='submit' name="submit" <strong>id="submitcomm"</strong> value='Wyślij' /></td> </tr> </table> </form>
By zastosować style do tego formularza wystarczy użyć ID jego pól. Jak widać pole z podpisem ma
id="commnickid"
, pole tekstowe z treścią komentarza -id="commbody"
, przycisk "Wyślij" -id="submitcomm"
a przycisk "Przestań śledzić ten wątek" -id="tracestop"
- typ
- wymagany tag otwierający i zamykający (
<COMMENT_FORM_BLOCK> ... </COMMENT_FORM_BLOCK>
) - stosowanie
- szablon komentarzy
- działanie
- w tym bloku umieszczany jest formularz dodawania komentarzy. Należy pamiętać o zachowaniu wszystkich name="" w formularzu.
- przykład
<div class="komentblok"> <h3 class="kTyt">Dodaj nowy komentarz:</h3> <div class="komentarze"><div class="komklcomment1"> <COMMENT_FORM_BLOCK> <form action="&COMMENT_FORM_ACTION;" method="post" id="formcomment"> <fieldset> <div class="commrow1"> <label id="commnicklab" for="commnickid">Podpis:</label> <input type="text" name="commnickid" id="commnickid" value="&COMMENT_FORM_NICKID;" /> </div> <div class="commrow2"> <label id="commbodylab" for="commbody">Treść:</label> <textarea name="commbody" id="commbody" cols="60" rows="6"><COMMENT_FORM_BODY/></textarea> </div> <COMMENT_FORM_NOTIFY_START_BLOCK> <div class="commrow2"> <input type="checkbox" name="notifystart" id="notifystart" value="notify" checked="checked" /> <label id="notifylab" for="notifystart">Śledź ten wątek</label> </div> </COMMENT_FORM_NOTIFY_START_BLOCK> <COMMENT_FORM_NOTIFY_STOP_BLOCK> <div class="commrow1"> <input type="submit" name="notifystop" id="notifystop" value="Przestań śledzić" /> </div> </COMMENT_FORM_NOTIFY_STOP_BLOCK> <COMMENT_FORM_NOUSER_BLOCK> <div class="commrow1"> <label id="commnickurllab" for="commnickurl">Strona WWW:</label> <input type="text" name="commnickurl" id="commnickurl" value="&COMMENT_FORM_NICKURL;" /> </div> <div class="commrow2"> <label id="codelab" for="code">Kod: <img src="&COMMENT_FORM_CODE;" alt="code" /></label> <input type="text" name="code" id="code" /> </div> </COMMENT_FORM_NOUSER_BLOCK> <div> <input type="submit" name="submit" id="submitcomm" value="Wyślij" /> </div> </fieldset> </form> </COMMENT_FORM_BLOCK> <COMMENT_LOGGED_BLOCK> <div class="commrow1"> <label id="commlogged" for="commlogged">Tylko zalogowani użytkownicy mogą komentować</label> </div> </COMMENT_LOGGED_BLOCK> <COMMENT_NONE_BLOCK> <div class="commrow1"> <label id="commnone" for="commnone">Komentarze zablokowane</label> </div> </COMMENT_NONE_BLOCK> </div></div> </div>
- uwagi
- należy zauważyć, że tag COMMENT_BLOCK także jest poprawnym tagiem formularza komentarzy, lecz nie pozwala on, na tak elastyczną modyfikację tegoż formularza
- typ
- pojedynczy, zapis:
&COMMENT_FORM_ACTION;
lub<COMMENT_FORM_ACTION/>
- stosowanie
- blok COMMENT_FORM_BLOCK (szablon komentarzy, formularz komentarzy)
- działanie
- wstawia wartość atrybutu
action
dla formularza komentarzy - typ
- pojedynczy, zapis:
&COMMENT_FORM_BODY;
lub<COMMENT_FORM_BODY/>
- stosowanie
- blok COMMENT_FORM_BLOCK (szablon komentarzy, formularz komentarzy)
- działanie
- treść komentarza dla formularza komentarzy (umieszczany pomiędzy znacznikami
<textarea> (...) </textarea>
) - typ
- pojedynczy, zapis:
&COMMENT_FORM_CODE;
lub<COMMENT_FORM_CODE/>
- stosowanie
- blok COMMENT_FORM_NOUSER_BLOCK (szablon komentarzy, formularz komentarzy)
- działanie
- wstawia ścieżkę do grafiki captcha - kodu potrzebnego do wysłania komentarza (widoczne tylko dla użytkowników niezalogowanych)
- typ
- pojedynczy, zapis:
&COMMENT_FORM_NICKID;
lub<COMMENT_FORM_NICKID/>
- stosowanie
- blok COMMENT_FORM_BLOCK (szablon komentarzy, formularz komentarzy)
- działanie
- wstawia podpis komentującego (tylko dla użytkowników zalogowanych)
- przykład
<COMMENT_FORM_BLOCK> (...) <input type="text" name="commnickid" id="commnickid" value="&COMMENT_FORM_NICKID;" /> (...) </COMMENT_FORM_BLOCK>
- typ
- pojedynczy, zapis:
&COMMENT_FORM_NICKURL;
lub<COMMENT_FORM_NICKURL/>
- stosowanie
- blok COMMENT_FORM_NOUSER_BLOCK (szablon komentarzy, formularz komentarzy)
- działanie
- wstawia URL komentującego (widoczne tylko dla użytkowników niezalogowanych)
- typ
- wymagany tag otwierający i zamykający (
<COMMENT_FORM_NOTIFY_START_BLOCK> ... </COMMENT_FORM_NOTIFY_START_BLOCK>
) - stosowanie
- szablon komentarzy, formularz komentarzy (blok COMMENT_FORM_BLOCK)
- działanie
- w bloku tym umieszczany jest
checkbox
pozwalający na śledzenie danego wątku - przykład
(...) <COMMENT_FORM_NOTIFY_START_BLOCK> <div class="commrow2"> <input type="checkbox" name="notifystart" id="notifystart" value="notify" checked="checked" /> <label id="notifylab" for="notifystart">Śledź ten wątek</label> </div> </COMMENT_FORM_NOTIFY_START_BLOCK> (...)
- typ
- wymagany tag otwierający i zamykający (
<COMMENT_FORM_NOTIFY_STOP_BLOCK> ... </COMMENT_FORM_NOTIFY_STOP_BLOCK>
) - stosowanie
- szablon komentarzy, formularz komentarzy (blok COMMENT_FORM_BLOCK)
- działanie
- w bloku tym umieszczany jest
input
pozwalający na zakończenie śledzenia danego wątku - przykład
(...) <COMMENT_FORM_NOTIFY_START_BLOCK> <div class="commrow1"> <input type="submit" name="notifystop" id="notifystop" value="Przestań śledzić" /> </div> </COMMENT_FORM_NOTIFY_START_BLOCK> (...)
- typ
- wymagany tag otwierający i zamykający (
<COMMENT_FORM_NOUSER_BLOCK> ... </COMMENT_FORM_NOUSER_BLOCK>
) - stosowanie
- szablon komentarzy, formularz komentarzy (blok COMMENT_FORM_BLOCK)
- działanie
- w bloku tym umieszczana jest część formularza komentarzy widoczna tylko dla niezalogowanych użytkowników
- przykład
(...) <COMMENT_FORM_NOUSER_BLOCK> <div class="commrow1"> <label id="commnickurllab" for="commnickurl">Podpis:</label> <input type="text" name="commnickurl" id="commnickurl" value="&COMMENT_FORM_NICKURL;" /> </div> <div class="commrow2"> <label id="codelab" for="code">Kod: <img src="&COMMENT_FORM_CODE;" alt="code" /></label> <input type="text" name="code" id="code" /> </div> </COMMENT_FORM_NOUSER_BLOCK> (...)
- typ
- wymagany tag otwierający i zamykający (
<COMMENT_LOGGED_BLOCK> ... </COMMENT_LOGGED_BLOCK>
) - stosowanie
- szablon komentarzy
- działanie
- w bloku tym umieszczana oglądający jest informoany o tym, że komentarze są dostępne tylko po zalogowaniu się
- przykład
(...) <COMMENT_LOGGED_BLOCK> <div class="commrow1"> <label id="commlogged" for="commlogged">Tylko zalogowani użytkownicy mogą komentować</label> </div> </COMMENT_LOGGED_BLOCK> (...)
- typ
- wymagany tag otwierający i zamykający (
<COMMENT_NONE_BLOCK> ... </COMMENT_NONE_BLOCK>
) - stosowanie
- szablon komentarzy
- działanie
- w bloku tym umieszczana jest informacja, że komentarze zostały zablokowane
- przykład
(...) <COMMENT_NONE_BLOCK> <div class="commrow1"> <label id="commnone" for="commnone">Komentarze zablokowane</label> </div> </COMMENT_NONE_BLOCK> (...)
- typ
- wymagany tag otwierający i tag zamykający (
<ADMIN_BLOCK> ... </ADMIN_BLOCK>
) - stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- blok powoduje pokazanie zawartej w nim treści jedynie zalogowanemu (na stronie głównej Joggera) właścicielowi. Można w nim umieścić wszystko, jednak 4 specjalne tagi nadają się do tego lepiej niż cokolwiek innego.
- przykład
- w bloku ENTRY_BLOCK:
<ENTRY_BLOCKY> (...) <ADMIN_BLOCK> <span> <a href="&ADMIN_ENTRY_EDIT_HREF;">Edytuj</a>, <a href="&ADMIN_ENTRY_REMOVE_HREF;">Usuń</a>. </span> </ADMIN_BLOCK> (...) </ENTRY_BLOCK>
w bloku COMMENT_BLOCK:
<COMMENT_BLOCK> (...) <ADMIN_BLOCK> <span> <a href="&ADMIN_COMMENT_REMOVE_HREF;">Usuń</a>, <a href="&ADMIN_COMMENT_BLOCKIP_HREF;">Zablokuj IP</a>. </span> </ADMIN_BLOCK> (...) </COMMENT_BLOCK>
można też tak:
<ADMIN_BLOCK> <p>Tego akapitu nie zobaczy nikt poza mną.</p> </ADMIN_BLOCK>
- uwagi
- 4 tagi zaczynające się od "ADMIN_" nie muszą być umieszczone w bloku ADMIN_BLOCK. Jednak wtedy zwykli użytkownicy odwiedzający joga zobaczą opisy
adminowych odnośników. Niczym to nie grozi, bo bez hasła i tak nic nie popsują, chodzi tylko o wygląd strony.
- typ
- pojedynczy, zapis:
<ADMIN_ENTRY_EDIT_HREF/>
lub&ADMIN_ENTRY_EDIT_HREF;
- stosowanie
- blok ADMIN_BLOCK (szablon strony głównej (wtedy w bloku ENTRIES_DAY) i szablon komentarzy (wtedy gdziekolwiek, bo odnosi się do komentowanego wpisu))
- działanie
- wstawia URL do strony edycji danego wpisu.
- typ
- pojedynczy, zapis:
<ADMIN_ENTRY_REMOVE_HREF/>
lub&ADMIN_ENTRY_REMOVE_HREF;
- stosowanie
- blok ADMIN_BLOCK (szablon strony głównej (wtedy w bloku ENTRIES_DAY) i szablon komentarzy (wtedy gdziekolwiek, bo odnosi się do komentowanego wpisu))
- działanie
- wstawia URL do strony z pytaniem o potwierdzenie usunięcia danego wpisu.
- typ
- pojedynczy, zapis:
<ADMIN_COMMENT_REMOVE_HREF/>
lub&ADMIN_COMMENT_REMOVE_HREF;
- stosowanie
- blok ADMIN_BLOCK w bloku COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia URL do odnośnika powodującego usunięcie danego komentarza (bez potwierdzania).
- typ
- pojedynczy, zapis:
<ADMIN_COMMENT_BLOCKIP_HREF/>
lub&ADMIN_COMMENT_BLOCKIP_HREF;
- stosowanie
- blok ADMIN_BLOCK w bloku COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia URL do odnośnika powodującego zablokowanie IP osoby komentującej.
- typ
- wymagany tag otwierający i tag zamykający (
<NOUSER_BLOCK> ... </NOUSER_BLOCK>
) - stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- Wszystko umieszczone w tym bloku będzie widoczne jedynie dla niezalogowanych użytkowników, np. zwykłych gości. Można tu wstawić link do strony logowania lub od razu odpowiedni formularz (dzięki dla kryska).
- przykład
Dla znajomych <NOUSER_BLOCK> <p><a href="&USER_LOG_IN_HREF;">Zaloguj się</a>, by przeczytać inne wpisy.</p> </NOUSER_BLOCK> <LOGGED_USER_BLOCK> ( ... ) </LOGGED_USER_BLOCK>
- uwagi
- patrz: formularz logowania
- typ
- pojedynczy, zapis:
<USER_LOG_IN_HREF/>
lub&USER_LOG_IN_HREF;
- stosowanie
- np. blok NOUSER_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia URL odnośnika do strony logowania http://login.staszyna.jogger.pl). Takiego linka można np. użyć dyskretnie, by nie tylko ukryć niektóre wpisy, ale także samą informację o ukrywaniu czegokolwiek.
- typ
- pojedynczy, zapis
&USER_LOG_IN_ACTION;
lub<USER_LOG_IN_ACTION/>
- stosowanie
- blok NOUSER_BLOCK (szablon strony logowania)
- działanie
- wstawia wartość atrybutu
action
dla formularza logowania - typ
- formularz przygotowany przez kryska, z moimi niewielkimi modyfikacjami
- stosowanie
- np. blok NOUSER_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- formularz od razu przekazuje Joggerowi dane o nazwie użytkownika i haśle, bez pośrednictwa wyżej wspomnianej strony.
- przykład
-
Dla znajomych:<br /> <NOUSER_BLOCK> <form action="&USER_LOG_IN_ACTION;" method="post" id="logowanie"> <div><input type="hidden" name="op" value="loginuser" /></div> <div><span>Login:</span><input type="text" name="user" /></div> <div><span>Hasło:</span><input type="password" name="pass" /></div> <div><input type="submit" value="Zaloguj" id="guzik" /></div> </form> </NOUSER_BLOCK>
- uwagi
- by to ładniej wyglądało, można w CSS dodać np.:
/* logowanie */ form#logowanie span { width: 4em; float: left; } form#logowanie div { margin-bottom: 3px; } form#logowanie input { width: 8em; padding-left: 3px; } form#logowanie input#guzik { width: auto; padding: 3px 5px; margin-top: 5px; margin-left: 4em; /* tyle samo, ile width w span wyżej */ font-family: sans-serif; }
- typ
- wymagany tag otwierający i tag zamykający (
<LOGGED_USER_BLOCK> ... </LOGGED_USER_BLOCK>
) - stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- treść zawarta w tym bloku będzie widoczna tylko i wyłącznie dla zalogowanych gości joga.
- przykład
-
Dla znajomych: <NOUSER_BLOCK> ( ... ) </NOUSER_BLOCK> <LOGGED_USER_BLOCK> <p><LOGGED_USER_NAME/>, <a href="&LOGGED_USER_LOG_OUT_HREF;"><em>wyloguj się</em></a>, gdy będziesz wychodzić. </p> </LOGGED_USER_BLOCK>
- typ
- pojedynczy, zapis:
<LOGGED_USER_NAME/>
lub&LOGGED_USER_NAME;
- stosowanie
- blok LOGGED_USER_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia nazwę zalogowanego użytkownika.
- typ
- pojedynczy, zapis:
<LOGGED_USER_LOG_OUT_HREF/>
lub&LOGGED_USER_LOG_OUT_HREF;
- stosowanie
- blok LOGGED_USER_BLOCK (szablon strony głównej i szablon komentarzy)
- działanie
- wstawia URL do odnośnika wylogowującego zalogowanego użytkownika. Warto sprawić, by użytkownik rzeczywiście kliknął w ten link, gdy będzie odchodził np. od komputera w kawiarence internetowej.
- typ
- grupa znaczników służących do wyświetlania tekstu dostępności (np. dostępny/rozłączony), ikony dostępności oraz Jabberowego opisu.
- stosowanie
- szablon strony głównej i szablon komentarzy, nie wymagają żadnego specjalnego bloku
- znaczniki
- STATUS_TEXT, STATUS_IMAGE, >STATUS_DESCR oraz STATUS_DESCR2.
- przykład
<ul> <li>mój status: <strong><STATUS_TEXT/></strong> <img src="&STATUS_IMAGE;" alt="" /></li> <li>mój opis: <em><STATUS_DESCR/></em></li> </ul>
- typ
- pojedynczy, zapis:
<STATUS_TEXT/>
lub&STATUS_TEXT;
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- wstawia teskt dostępności lub niedostępności. Oba należy ustawić w panelu konfiguracyjnym, w zakładce Ustawienia (Tekst dostępności i Tekst niedostępności), np. dostępny/rozłączony, online/offline, jestem/nie ma mnie itd.
- typ
- pojedynczy, zapis:
<STATUS_IMAGE/>
lub&STATUS_IMAGE;
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- wstawia ścieżkę do pliku-ikony dostepności. Należy najpierw utworzyć i wgrać do Joggera dwa takie pliki: online.png i offline.png. W zależności od statusu właściciela joga, Jogger wstawi ścieżkę do odpowiedniego pliku.
- uwagi
- znacznik wstawia pełną ścieżkę, a nie tylko nazwę pliku.
- typ
- pojedynczy, zapis:
<STATUS_DESCR/>
lub&STATUS_DESCR;
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- wstawia Jabberowy opis.
- typ
- pojedynczy, zapis:
<STATUS_DESCR2/>
lub&STATUS_DESCR2;
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- podobnie jak STATUS_DESCR wstawia opis na Jabberze, tyle tylko, że ujęty w cudzysłowy. Jeśli opisu nie ma, cudzysłowy nie zostaną wyświetlone.
- typ
- pojedynczy, zapis:
<JID/>
lub&JID;
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- wstawia JID (Jabber ID) właściciela joga.
- przykład
<acronym lang="en" xml:lang="en" title="Jabber Identifier">JID</acronym>: <JID/>
- typ
- pojedynczy, zapis:
<JOG/>
lub&JOG;
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- wstawia nazwe konta (login/nick itp).
- typ
- pojedynczy, zapis:
<HOME/>
lub&HOME;
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- wstawia adres joggera: "http://_nazwa_konta_.jogger.pl".
- przykład
<a href="&HOME;" title="Strona główna.">Strona Główna</a>
- typ
- pojedynczy, zapis:
<RSS/>
lub&RSS;
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- wstawia link kanału informacyjnego joga.
- przykład
<a href="&RSS;" title="Kanał informacyjny.">RSS</a>
- uwagi
- aby uzyskać linki do wpisów z treścią, html i skróconym należy dopisać po znaczniku poniższe parametry:
ilosc_wpisow/ content/ilosc_wpisow/ short/ilosc_wpisow/ content/html/ilosc_wpisow/ short/html/ilosc_wpisow/
- typ
- pojedynczy, zapis:
<ALL_ENTRIES_HREF/>
lub&ALL_ENTRIES_HREF;
- stosowanie
- szablon komentarzy
- działanie
- wstawia link prowadzący do strony głównej z odpowiednimi wpisami (tzn. jeśli ktoś czyta komentarze do wpisu ze stycznia, to ten link przeniesie go do strony z wpisami ze stycznia).
- przykład
<a href="&ALL_ENTRIES_HREF;" title="Powrót do reszty wpisów">Wróć</a>
- typ
- pojedynczy, zapis
&HEADER;
lub<HEADER/>
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- wstawia następujący kod do szablonu (stosowany w szablonach uproszczonych):
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html lang="pl"> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <meta name="robots" content="noindex, nofollow"> <title>Jogger :: [Twój JID]</title> <link rel="StyleSheet" href="/files/style.css" type="text/css"> </head> <body>
- uwagi
- działa w połączeniu ze znacznikiem FOOTER (może także występować sam w szablonie)
- podczas tworzenia szablonu należy wgrać na serwer plik styli CSS o następującej nazwie
style.css
- typ
- pojedynczy, zapis
&FOOTER;
lub<FOOTER/>
- stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- wstawia następujący kod do szablonu (stosowany w szablonach uproszczonych):
</body> </html>
- typ
- wymagany tag otwierający i tag zamykający (
<JOGGER_USER_BLOCK> ... </JOGGER_USER_BLOCK>
) - stosowanie
- szablon strony głównej i szablon komentarzy
- działanie
- w tym bloku informacje są wyświetlane tylko dla zarejestrowanych użytkowników joggera
- ARCHIVE_NOT_LAST (http://joggerpl2.jogger.pl/2006/03/16/zgloszenie-176/)
- CATEGORY_NOT_LAST (j/w)
COMMENT_FAVICON2 (NOWY)
COMMENT_ID
COMMENT_NICK_CLASS (NOWY)
Formularz komentarzy (COMMENT_FORM)
COMMENT_FORM
COMMENT_FORM2 (w starym stylu, oparty na tabeli)
COMMENT_FORM_BLOCK (NOWY)
COMMENT_FORM_ACTION (NOWY)
COMMENT_FORM_BODY (NOWY)
COMMENT_FORM_CODE (NOWY)
COMMENT_FORM_NICKID (NOWY)
COMMENT_FORM_NICKURL (NOWY)
COMMENT_FORM_NOTIFY_START_BLOCK (NOWY)
COMMENT_FORM_NOTIFY_STOP_BLOCK (NOWY)
COMMENT_FORM_NOUSER_BLOCK (NOWY)
COMMENT_LOGGED_BLOCK (NOWY)
COMMENT_NONE_BLOCK (NOWY)
Admin (ADMIN)
ADMIN_BLOCK
ADMIN_ENTRY_EDIT_HREF
ADMIN_ENTRY_REMOVE_HREF
ADMIN_COMMENT_REMOVE_HREF
ADMIN_COMMENT_BLOCKIP_HREF
Niezalogowany użytkownik (NOUSER)
NOUSER_BLOCK
USER_LOG_IN_HREF
USER_LOG_IN_ACTION (NOWY)
FORMULARZ
Zalogowany użytkownik (LOGGED_USER)
LOGGED_USER_BLOCK
LOGGED_USER_NAME
LOGGED_USER_LOG_OUT_HREF
status i opis Jabbera
STATUS_TEXT
STATUS_IMAGE
STATUS_DESCR
STATUS_DESCR2
Inne
JID
JOG (NOWY)
HOME (NOWY)
RSS (NOWY)
ALL_ENTRIES_HREF
HEADER (NOWY)
FOOTER (NOWY)
JOGGER_USER_BLOCK (NOWY)
Lista pozostałych tagów
Należy je opisać i dodać wyżej, kasując tutaj.
Do opisu tagów, które pozostały z Joggera 1.0 wykorzstano materiał Staszyny