Tagi/Komentarze: Różnice pomiędzy wersjami
Z JoggerWiki
(Dodanie tagów trackbacka oraz brakujących bloków dot. komentarzy.) |
m (Większe światło pomiędzy tagami) |
||
Linia 8: | Linia 8: | ||
:blok służy wyświetlaniu kolejnych komentarzy. | :blok służy wyświetlaniu kolejnych komentarzy. | ||
;przykład | ;przykład | ||
− | |||
<h2>Komentarze:</h2> | <h2>Komentarze:</h2> | ||
<COMMENT_BLOCK> | <COMMENT_BLOCK> | ||
Linia 24: | Linia 23: | ||
</div> | </div> | ||
</COMMENT_BLOCK> | </COMMENT_BLOCK> | ||
+ | |||
===COMMENT_ALLOWED_BLOCK=== | ===COMMENT_ALLOWED_BLOCK=== | ||
Linia 32: | Linia 32: | ||
;działanie | ;działanie | ||
:Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy możliwe jest dodawanie komentarzy. | :Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy możliwe jest dodawanie komentarzy. | ||
+ | |||
===COMMENT_NONE_BLOCK=== | ===COMMENT_NONE_BLOCK=== | ||
Linia 41: | Linia 42: | ||
:Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy komentarze zostały zablokowane. | :Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy komentarze zostały zablokowane. | ||
;przykład | ;przykład | ||
− | |||
<COMMENT_LOGGED_BLOCK> | <COMMENT_LOGGED_BLOCK> | ||
<p>Komentarze zostały zablokowane.</p> | <p>Komentarze zostały zablokowane.</p> | ||
</COMMENT_LOGGED_BLOCK> | </COMMENT_LOGGED_BLOCK> | ||
+ | |||
===COMMENT_LOGGED_BLOCK=== | ===COMMENT_LOGGED_BLOCK=== | ||
Linia 56: | Linia 57: | ||
:Blok nie pojawi się na stronie, jeśli użytkownik jest zalogowany. | :Blok nie pojawi się na stronie, jeśli użytkownik jest zalogowany. | ||
;przykład | ;przykład | ||
− | |||
<COMMENT_LOGGED_BLOCK> | <COMMENT_LOGGED_BLOCK> | ||
<p>Musisz się zalogować, jeśli chcesz dodać komentarz.</p> | <p>Musisz się zalogować, jeśli chcesz dodać komentarz.</p> | ||
</COMMENT_LOGGED_BLOCK> | </COMMENT_LOGGED_BLOCK> | ||
+ | |||
===COMMENT_BLOCK_EXIST=== | ===COMMENT_BLOCK_EXIST=== | ||
Linia 68: | Linia 69: | ||
;działanie | ;działanie | ||
:Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy wpis posiada komentarze. | :Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy wpis posiada komentarze. | ||
+ | |||
===COMMENT_BLOCK_NOT_EXIST=== | ===COMMENT_BLOCK_NOT_EXIST=== | ||
Linia 77: | Linia 79: | ||
:Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy wpis '''nie''' posiada komentarzy. | :Zawartość bloku zostanie wyświetlona jedynie wtedy, gdy wpis '''nie''' posiada komentarzy. | ||
;przykład | ;przykład | ||
− | |||
<COMMENT_BLOCK_NOT_EXIST> | <COMMENT_BLOCK_NOT_EXIST> | ||
<p>Jeszcze nie ma żadnych komentarzy. Twój może być pierwszy.</p> | <p>Jeszcze nie ma żadnych komentarzy. Twój może być pierwszy.</p> | ||
</COMMENT_BLOCK_NOT_EXIST> | </COMMENT_BLOCK_NOT_EXIST> | ||
+ | |||
===COMMENT_CLASS=== | ===COMMENT_CLASS=== | ||
Linia 91: | Linia 93: | ||
;uwagi | ;uwagi | ||
:Patrz '''TRACKBACK_BLOCK'''. | :Patrz '''TRACKBACK_BLOCK'''. | ||
+ | |||
===COMMENT_EDIT_EXIST=== | ===COMMENT_EDIT_EXIST=== | ||
Linia 100: | Linia 103: | ||
:blok umożliwia wstawienie linka do formularza edycji komentarza | :blok umożliwia wstawienie linka do formularza edycji komentarza | ||
;przykład | ;przykład | ||
− | |||
<COMMENT_EDIT_EXIST> | <COMMENT_EDIT_EXIST> | ||
<a href="&COMMENT_EDIT_HREF;">edytuj komentarz</a> | <a href="&COMMENT_EDIT_HREF;">edytuj komentarz</a> | ||
</COMMENT_EDIT_EXIST> | </COMMENT_EDIT_EXIST> | ||
+ | |||
===COMMENT_NICK=== | ===COMMENT_NICK=== | ||
Linia 112: | Linia 115: | ||
;działanie | ;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 [http://jogger.pl Joggera]), wstawiony zostanie podpis będący odnośnikiem do joga komentującego. | :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 [http://jogger.pl Joggera]), wstawiony zostanie podpis będący odnośnikiem do joga komentującego. | ||
+ | |||
===COMMENT_DATE=== | ===COMMENT_DATE=== | ||
Linia 120: | Linia 124: | ||
;działanie | ;działanie | ||
:wstawia datę dodania komentarza. | :wstawia datę dodania komentarza. | ||
+ | |||
===COMMENT_HOUR=== | ===COMMENT_HOUR=== | ||
Linia 128: | Linia 133: | ||
;działanie | ;działanie | ||
:wstawia godzinę dodania komentarza. | :wstawia godzinę dodania komentarza. | ||
+ | |||
===COMMENT_NUMBER=== | ===COMMENT_NUMBER=== | ||
Linia 136: | Linia 142: | ||
;działanie | ;działanie | ||
:wstawia numer komentarza. | :wstawia numer komentarza. | ||
+ | |||
===COMMENT_CONTENT=== | ===COMMENT_CONTENT=== | ||
Linia 144: | Linia 151: | ||
;działanie | ;działanie | ||
:wstawia treść komentarza lub fragment treści artykułu, z którego wysłano ''trackback''. | :wstawia treść komentarza lub fragment treści artykułu, z którego wysłano ''trackback''. | ||
+ | |||
===COMMENT_FAVICON=== | ===COMMENT_FAVICON=== | ||
Linia 152: | Linia 160: | ||
;działanie | ;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 | :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=== | ===COMMENT_FAVICON2=== | ||
Linia 160: | Linia 169: | ||
;działanie | ;działanie | ||
:wstawia czysty link do obrazka (favikony) | :wstawia czysty link do obrazka (favikony) | ||
+ | |||
===COMMENT_FAVICON_EXIST=== | ===COMMENT_FAVICON_EXIST=== | ||
Linia 168: | Linia 178: | ||
;działanie | ;działanie | ||
:w tym bloku informacje są wyświetlane, kiedy użytkownik Joggera posiada favikonę | :w tym bloku informacje są wyświetlane, kiedy użytkownik Joggera posiada favikonę | ||
+ | |||
===COMMENT_FAVICON_NOT_EXIST=== | ===COMMENT_FAVICON_NOT_EXIST=== | ||
Linia 176: | Linia 187: | ||
;działanie | ;działanie | ||
:w tym bloku informacje są wyświetlane, kiedy użytkownik Joggera nie posiada favikony | :w tym bloku informacje są wyświetlane, kiedy użytkownik Joggera nie posiada favikony | ||
+ | |||
===COMMENT_ID=== | ===COMMENT_ID=== | ||
Linia 187: | Linia 199: | ||
: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'') | :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 | ;przykład | ||
− | |||
<a id="comm&COMMENT_ID;" href="#comm&COMMENT_ID;" title="Permalink do komentarza">Permalink</a> | <a id="comm&COMMENT_ID;" href="#comm&COMMENT_ID;" title="Permalink do komentarza">Permalink</a> | ||
+ | |||
===COMMENT_NICK_CLASS=== | ===COMMENT_NICK_CLASS=== | ||
Linia 200: | Linia 212: | ||
:W celu wyróżnienia ''trackbacków'' przy pomocy tego tagu należy w [https://login.jogger.pl/?tab=settings ustawieniach ogólnych] joggera wybrać opcję wyświetlania ich razem z innymi komentarzami (przed, po lub mieszane). | :W celu wyróżnienia ''trackbacków'' przy pomocy tego tagu należy w [https://login.jogger.pl/?tab=settings ustawieniach ogólnych] joggera wybrać opcję wyświetlania ich razem z innymi komentarzami (przed, po lub mieszane). | ||
;przykład | ;przykład | ||
− | |||
<COMMENT_BLOCK> | <COMMENT_BLOCK> | ||
<div class="<COMMENT_NICK_CLASS/> <COMMENT_CLASS/>"> | <div class="<COMMENT_NICK_CLASS/> <COMMENT_CLASS/>"> | ||
Linia 206: | Linia 217: | ||
</div> | </div> | ||
</COMMENT_BLOCK> | </COMMENT_BLOCK> | ||
+ | |||
==Trackbacki (TRACKBACK)== | ==Trackbacki (TRACKBACK)== | ||
Linia 217: | Linia 229: | ||
;uwagi | ;uwagi | ||
:W [https://login.jogger.pl/?tab=settings ustawieniach ogólnych] joggera należy wybrać opcję wyświetlania ''trackbacków'' w osobnym bloku. | :W [https://login.jogger.pl/?tab=settings ustawieniach ogólnych] joggera należy wybrać opcję wyświetlania ''trackbacków'' w osobnym bloku. | ||
+ | |||
===TRACKBACK_BLOCK_EXIST=== | ===TRACKBACK_BLOCK_EXIST=== | ||
Linia 225: | Linia 238: | ||
;działanie | ;działanie | ||
:Zawartość bloku zostanie wyświetlona tylko wtedy, gdy istnieją ''trackbacki'' z innych blogów. | :Zawartość bloku zostanie wyświetlona tylko wtedy, gdy istnieją ''trackbacki'' z innych blogów. | ||
+ | |||
===TRACKBACK_BLOCK_NOT_EXIST=== | ===TRACKBACK_BLOCK_NOT_EXIST=== |
Wersja z 00:16, 27 paź 2006
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.