Tagi/Komentarze
Z JoggerWiki
Wersja z dnia 00:16, 27 paź 2006 autorstwa Yano (dyskusja | edycje) (Większe światło pomiędzy tagami)
Spis treści
- 1 Komentarze (COMMENT)
- 1.1 COMMENT_BLOCK
- 1.2 COMMENT_ALLOWED_BLOCK
- 1.3 COMMENT_NONE_BLOCK
- 1.4 COMMENT_LOGGED_BLOCK
- 1.5 COMMENT_BLOCK_EXIST
- 1.6 COMMENT_BLOCK_NOT_EXIST
- 1.7 COMMENT_CLASS
- 1.8 COMMENT_EDIT_EXIST
- 1.9 COMMENT_NICK
- 1.10 COMMENT_DATE
- 1.11 COMMENT_HOUR
- 1.12 COMMENT_NUMBER
- 1.13 COMMENT_CONTENT
- 1.14 COMMENT_FAVICON
- 1.15 COMMENT_FAVICON2
- 1.16 COMMENT_FAVICON_EXIST
- 1.17 COMMENT_FAVICON_NOT_EXIST
- 1.18 COMMENT_ID
- 1.19 COMMENT_NICK_CLASS
- 2 Trackbacki (TRACKBACK)
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_ALLOWED_BLOCK
- typ
- wymagany tag otwierający i tag zamykający (
<COMMENT_ALLOWED_BLOCK> ... </COMMENT_ALLOWED_BLOCK>
) - stosowanie
- szablon komentarzy
- działanie
- Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy możliwe jest dodawanie komentarzy.
COMMENT_NONE_BLOCK
- typ
- wymagany tag otwierający i tag zamykający (
<COMMENT_NONE_BLOCK> ... </COMMENT_NONE_BLOCK>
) - stosowanie
- szablon komentarzy
- działanie
- Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy komentarze zostały zablokowane.
- przykład
<COMMENT_LOGGED_BLOCK> <p>Komentarze zostały zablokowane.</p> </COMMENT_LOGGED_BLOCK>
COMMENT_LOGGED_BLOCK
- typ
- wymagany tag otwierający i tag zamykający (
<COMMENT_LOGGED_BLOCK> ... </COMMENT_LOGGED_BLOCK>
) - stosowanie
- szablon komentarzy
- działanie
- Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy komentarze wymagają zalogowania użytkownika.
- uwagi
- Blok nie pojawi się na stronie, jeśli użytkownik jest zalogowany.
- przykład
<COMMENT_LOGGED_BLOCK> <p>Musisz się zalogować, jeśli chcesz dodać komentarz.</p> </COMMENT_LOGGED_BLOCK>
COMMENT_BLOCK_EXIST
- typ
- wymagany tag otwierający i tag zamykający (
<COMMENT_BLOCK_EXIST> ... </COMMENT_BLOCK_EXIST>
) - stosowanie
- szablon komentarzy
- działanie
- Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy wpis posiada komentarze.
COMMENT_BLOCK_NOT_EXIST
- typ
- wymagany tag otwierający i tag zamykający (
<COMMENT_BLOCK_NOT_EXIST> ... </COMMENT_BLOCK_NOT_EXIST>
) - stosowanie
- szablon komentarzy
- działanie
- Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy wpis nie posiada komentarzy.
- przykład
<COMMENT_BLOCK_NOT_EXIST> <p>Jeszcze nie ma żadnych komentarzy. Twój może być pierwszy.</p> </COMMENT_BLOCK_NOT_EXIST>
COMMENT_CLASS
- typ
- pojedynczy , zapis:
<COMMENT_CLASS/>
lub&COMMENT_CLASS;
- stosowanie
- blok COMMENT_BLOCK lub TRACKBACK_BLOCK (szablon komentarzy)
- działanie
- W zależności od bloku, w którym został użyty wstawia odpowiednio tekst
comment1
icomment2
(blok COMMENT_BLOCK) lubtrackback1
itrackback2
(blok TRACKBACK_BLOCK). Dzięki temu można za pomocą CSS zróżnicować wygląd sąsiadujących komentarzy/trackbacków, i tym samym ułatwić ich czytanie. Najczęściej definiuje się odmienne kolory tła lub style obramowania. - uwagi
- Patrz TRACKBACK_BLOCK.
COMMENT_EDIT_EXIST
- typ
- wymagany tag otwierający i tag zamykający (
<COMMENT_EDIT_EXIST>... </COMMENT_EDIT_EXIST>
) - stosowanie
- szablon komentarzy
- działanie
- blok umożliwia wstawienie linka do formularza edycji komentarza
- przykład
<COMMENT_EDIT_EXIST> <a href="&COMMENT_EDIT_HREF;">edytuj komentarz</a> </COMMENT_EDIT_EXIST>
COMMENT_NICK
- typ
- pojedynczy, zapis:
<COMMENT_NICK/>
lub&COMMENT_NICK;
- stosowanie
- blok COMMENT_BLOCK lub TRACKBACK_BLOCK (szablon komentarzy)
- działanie
- wstawia podpis komentującego lub nazwę bloga, z którego wysłano trackback. 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 lub TRACKBACK_BLOCK (szablon komentarzy)
- działanie
- wstawia datę dodania komentarza.
COMMENT_HOUR
- typ
- pojedynczy, zapis:
<COMMENT_HOUR/>
lub&COMMENT_HOUR;
- stosowanie
- blok COMMENT_BLOCK lub TRACKBACK_BLOCK (szablon komentarzy)
- działanie
- wstawia godzinę dodania komentarza.
COMMENT_NUMBER
- typ
- pojedynczy, zapis:
<COMMENT_NUMBER/>
lub&COMMENT_NUMBER;
- stosowanie
- blok COMMENT_BLOCK lub TRACKBACK_BLOCK (szablon komentarzy)
- działanie
- wstawia numer komentarza.
COMMENT_CONTENT
- typ
- pojedynczy, zapis:
<COMMENT_CONTENT/>
lub&COMMENT_CONTENT;
- stosowanie
- blok COMMENT_BLOCK lub TRACKBACK_BLOCK (szablon komentarzy)
- działanie
- wstawia treść komentarza lub fragment treści artykułu, z którego wysłano trackback.
COMMENT_FAVICON
- typ
- pojedynczy, zapis
&COMMENT_FAVICON;
lub<COMMENT_FAVICON/>
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- znacznik jest podmieniany na favikone zarejestrowanego użytkownika; wymagany plik w katalogu: favicon.png, favicon.gif, favicon.jpg lub favicon.ico; maksymalna wielkość favikony to 32x32 piksele
COMMENT_FAVICON2
- typ
- pojedynczy, zapis
&COMMENT_FAVICON2;
lub<COMMENT_FAVICON2/>
- stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- wstawia czysty link do obrazka (favikony)
COMMENT_FAVICON_EXIST
- typ
- wymagany tag otwierający i tag zamykający (
<COMMENT_FAVICON_EXIST> ... </COMMENT_FAVICON_EXIST>
) - stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- w tym bloku informacje są wyświetlane, kiedy użytkownik Joggera posiada favikonę
COMMENT_FAVICON_NOT_EXIST
- typ
- wymagany tag otwierający i tag zamykający (
<COMMENT_FAVICON_NOT_EXIST> ... </COMMENT_FAVICON_NOT_EXIST>
) - stosowanie
- blok COMMENT_BLOCK (szablon komentarzy)
- działanie
- w tym bloku informacje są wyświetlane, kiedy użytkownik Joggera nie posiada favikony
COMMENT_ID
- typ
- pojedynczy, zapis
&COMMENT_ID;
lub<COMMENT_ID/>
- stosowanie
- blok COMMENT_BLOCK lub TRACKBACK_BLOCK (szablon komentarzy)
- działanie
- wstawia identyfikator komentarza/trackbacka w postaci jego numeru w bazie danych
- uwagi
- Zgodnie ze specyfikacją identyfikator musi rozpoczynać się literą lub znakiem podkreślenia. Tag należy więc poprzedzić prefiksem, na przykład "comm" (dla komentarzy) lub "track" (dla trackbacków)
- przykład
<a id="comm&COMMENT_ID;" href="#comm&COMMENT_ID;" title="Permalink do komentarza">Permalink</a>
COMMENT_NICK_CLASS
- typ
- pojedynczy, zapis
&COMMENT_NICK_CLASS;
lub<COMMENT_NICK_CLASS/>
- stosowanie
- blok COMMENT_BLOCK lub TRACKBACK_BLOCK (szablon komentarzy)
- działanie
- Wstawia
owner
jeżeli autorem komentarza jest właściciel joggera,jogger
w przypadku, gdy komentarz jest innego zalogowanego użytkownika joggera,guest
jeżeli komentującym jest osoba niezalogowana lubtrackback
jeżeli komentarz jest trackbackiem z innego bloga. Dzięki temu przy pomocy CSS można np. wyróżnić komentarze właściciela joggera czy trackbacki. Najczęściej robi się to poprzez zdefiniowanie koloru, bądź obrazka tła lub nadanie komentarzowi obramowania. - uwagi
- W celu wyróżnienia trackbacków przy pomocy tego tagu należy w ustawieniach ogólnych joggera wybrać opcję wyświetlania ich razem z innymi komentarzami (przed, po lub mieszane).
- przykład
<COMMENT_BLOCK> <div class="<COMMENT_NICK_CLASS/> <COMMENT_CLASS/>"> (...) </div> </COMMENT_BLOCK>
Trackbacki (TRACKBACK)
TRACKBACK_BLOCK
- typ
- wymagany tag otwierający i zamykający (
<TRACKBACK_BLOCK> ... </TRACKBACK_BLOCK>
) - stosowanie
- szablon komentarzy
- działanie
- blok służy wyświetlaniu trackbacków
- uwagi
- W ustawieniach ogólnych joggera należy wybrać opcję wyświetlania trackbacków w osobnym bloku.
TRACKBACK_BLOCK_EXIST
- typ
- wymagany tag otwierający i zamykający (
<TRACKBACK_BLOCK_EXIST> ... </TRACKBACK_BLOCK_EXIST>
) - stosowanie
- szablon komentarzy
- działanie
- Zawartość bloku zostanie wyświetlona tylko wtedy, gdy istnieją trackbacki z innych blogów.
TRACKBACK_BLOCK_NOT_EXIST
- typ
- wymagany tag otwierający i zamykający (
<RACKBACK_BLOCK_NOT_EXIST> ... </RACKBACK_BLOCK_NOT_EXIST>
) - stosowanie
- szablon komentarzy
- działanie
- Zawartość bloku zostanie wyświetlona tylko wtedy, gdy brak jest trackbacków z innych blogów.