Tagi/Komentarze

Z JoggerWiki
Wersja z dnia 22:45, 26 paź 2006 autorstwa Yano (dyskusja | edycje) (Dodanie tagów trackbacka oraz brakujących bloków dot. komentarzy.)

Skocz do: nawigacji, wyszukiwania

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.