Tagi/Komentarze: Różnice pomiędzy wersjami

Z JoggerWiki
Skocz do: nawigacji, wyszukiwania
(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 01:16, 27 paź 2006

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 i comment2 (blok COMMENT_BLOCK) lub trackback1 i trackback2 (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 lub trackback 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.