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

Z JoggerWiki
Skocz do: nawigacji, wyszukiwania
m (Większe światło pomiędzy tagami)
m
Linia 90: Linia 90:
 
:blok '''COMMENT_BLOCK''' lub '''TRACKBACK_BLOCK''' (szablon komentarzy)
 
:blok '''COMMENT_BLOCK''' lub '''TRACKBACK_BLOCK''' (szablon komentarzy)
 
;działanie
 
;działanie
:W zależności od bloku, w którym został użyty wstawia odpowiednio tekst <code>comment1</code> i <code>comment2</code> (blok '''COMMENT_BLOCK''') lub <code>trackback1</code> i <code>trackback2</code> (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.
+
:W zależności od bloku, w którym został użyty wstawia odpowiednio tekst <code>comment1</code>, <code>comment2</code>, ... (blok '''COMMENT_BLOCK''') lub <code>trackback1</code>, <code>trackback2</code>, ... (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
 
;uwagi
 
:Patrz '''TRACKBACK_BLOCK'''.
 
:Patrz '''TRACKBACK_BLOCK'''.

Wersja z 21:11, 13 gru 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, comment2, ... (blok COMMENT_BLOCK) lub trackback1, 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.