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

Wersja z 08:29, 25 lut 2007

← Wszystkie tagi

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>
  <COMMENT_CONTENT/>
</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_NONE_BLOCK>
  <p>Komentarze zostały zablokowane.</p>
</COMMENT_NONE_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>

COMMENT_PREVIEW_EXIST

typ

wymagany tag otwierający i tag zamykający (<COMMENT_PREVIEW_EXIST> ... </COMMENT_PREVIEW_EXIST>)

stosowanie

szablon komentarzy

działanie

określa, czy komentujący użytkownik wybrał opcję podglądu komentarza

COMMENT_PREVIEW_BODY

typ

pojedynczy, zapis &COMMENT_PREVIEW_BODY; lub <COMMENT_PREVIEW_BODY/>

stosowanie

szablon komentarzy

działanie

wstawia treść komentarza wysłanego w trybie podglądu

przykład

<COMMENT_PREVIEW_EXIST>
  <li>
    <p>Twój komentarz nie został jeszcze dodany, kliknij Wyślij aby go dodać.</p>
    <COMMENT_PREVIEW_BODY/>
  </li>
</COMMENT_PREVIEW_EXIST>

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 (<TRACKBACK_BLOCK_NOT_EXIST> ... </TRACKBACK_BLOCK_NOT_EXIST>)

stosowanie

szablon komentarzy

działanie

Zawartość bloku zostanie wyświetlona tylko wtedy, gdy brak jest trackbacków z innych blogów.