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

Z JoggerWiki
Skocz do: nawigacji, wyszukiwania
(Wydzielone z Tagi.)
(Brak różnic)

Wersja z 19:48, 12 sie 2006

Wpis (ENTRY)

ENTRY_BLOCK

typ
wymagany tag otwierający i tag zamykający (<ENTRY_BLOCK> ... </ENTFRY_BLOCK>)
stosowanie
strona główna joggera
działanie
wstawia wpisy
przykład
<ENTRY_BLOCK>
   <div class="entry">
       <h2 id="&ENTRY_ID;"><a href="&ENTRY_COMMENT_HREF;"><ENTRY_SUBJECT/></a></h2>
       <p><ENTRY_LEVEL/> poziom | <ENTRY_DATE/>, <ENTRY_HOUR/><br />
       kategoria: 
           <ENTRY_CATEGORY_BLOCK>
                       <a href="&ENTRY_CATEGORY_HREF;"><ENTRY_CATEGORY_HREF_DESCR/></a>
                       <ENTRY_CATEGORY_NOT_LAST>, </ENTRY_CATEGORY_NOT_LAST>
           </ENTRY_CATEGORY_BLOCK></p>
       <ENTRY_CONTENT/>
       <ADMIN_BLOCK>
       <span>
       <a href="&ADMIN_ENTRY_EDIT_HREF;">Edytuj</a>,
       <a href="&ADMIN_ENTRY_REMOVE_HREF;">Usuń</a>.
       </span>
       </ADMIN_BLOCK>
   <p><a href="&ENTRY_COMMENT_HREF;"><ENTRY_COMMENT_HREF_DESCR/></a></p>
   </div>
</ENTRY_BLOCK>

ENTRY_DAY_BLOCK

typ
znacznik opcjonalny; wymagany tag otwierający i tag zamykający (<ENTRY_DAY_BLOCK> ... </ENTRY_DAY_BLOCK>)
stosowanie
strona główna joggera
działanie
użycie tego znacznika nie jest obowiązkowe. Służy on do grupowania wpisów z jednego dnia, zatem jeśli w projekcie szablonu każdy wpis jest oddzielną jednostką, ten znacznik nie będzie przydatny.
przykład
<ENTRY_BLOCK>
<div class="dzien">
<h2>dzień <ENTRY_DATE/></a> roku:</h2>
   <ENTRY_DAY_BLOCK>
   <div class="entry">
   <h2 id="&ENTRY_ID;"><a href="&ENTRY_COMMENT_HREF;"><ENTRY_SUBJECT/></a></h2>
   <p><ENTRY_LEVEL/> poziom |<ENTRY_HOUR/><br />
   kategoria: 
   <ENTRY_CATEGORY_BLOCK>
   <a href="&ENTRY_CATEGORY_HREF;"><ENTRY_CATEGORY_HREF_DESCR/></a>
   <ENTRY_CATEGORY_NOT_LAST>, </ENTRY_CATEGORY_NOT_LAST>
   </ENTRY_CATEGORY_BLOCK></p>
   <p><ENTRY_CONTENT/></p>
   <p><a href="&ENTRY_COMMENT_HREF;"><ENTRY_COMMENT_HREF_DESCR/></a></p>
   </div>
   <ADMIN_BLOCK>
   <span>
   <a href="&ADMIN_ENTRY_EDIT_HREF;">Edytuj</a>,
   <a href="&ADMIN_ENTRY_REMOVE_HREF;>Usuń</a>.
   </span>
   </ADMIN_BLOCK>
   </ENTRY_DAY_BLOCK>
   <hr />
</div>
</ENTRY_BLOCK>
uwagi
Należy zwrócić uwagę na położenie nagłówka h2 zawierającego znacznik ENTRY_DATE oraz na położenie poziomej linii <hr />

ENTRY_SUBJECT

typ
pojedynczy, zapis: <ENTRY_SUBJECT/> lub &ENTRY_SUBJECT;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
działanie
wstawia tytuł wpisu (tytuły dodaje się wysyłając w kliencie Jabbera wpis jako wiadomość, a nie jako czat).

ENTRY_DATE

typ
pojedynczy, zapis: <ENTRY_DATE/> lub &ENTRY_DATE;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
działanie
wstawia datę (dzień, miesiąc (słownie) i rok) wysłania wpisu lub wpisów.

ENTRY_DATE_DAY

typ
pojedynczy, zapis: <ENTRY_DATE_DAY/> lub &ENTRY_DATE_DAY;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
działanie
wstawia dzień wysłania wpisu.

ENTRY_DATE_MONTH

Typ
Pojedynczy, zapis: <ENTRY_DATE_MONTH/> lub &ENTRY_DATE_MONTH;
Stosowanie
Strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
Działanie
Wstawia miesiąc wysłania wpisu. Miesiąc można ustawić w panelu sterowania w zakładce Stałe https://login.jogger.pl/?tab=constants. //nie mam pojecia jak wstawic ten link w wikitags zeby byl w opisie "Stałe".

ENTRY_DATE_YEAR

typ
pojedynczy, zapis: <ENTRY_DATE_YEAR/> lub &ENTRY_DATE_YEAR;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
działanie
wstawia rok wysłania wpisu.

ENTRY_HOUR

typ
pojedynczy, zapis: <ENTRY_HOUR/> lub &ENTRY_HOUR;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
działanie
wstawia godzinę wysłania wpisu (w formacie GG:MM:SS).

ENTRY_ID

typ
pojedynczy, zapis: <ENTRY_ID/> lub &ENTRY_ID;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
działanie
wstawia numer ID wpisu w bazie Joggera. Można tego użyć, by stworzyć zakotwiczenie do wpisu (ang. anchor link). Wstawiany tekst wygląda np. tak: e32726
przykłady
znacznika mozna użyć po prostu w atrybucie id np. nagłowka wpisu:
<h2 id="&ENTRY_ID;"><ENTRY_SUBJECT/></h2>

Można także zrobić od razu odnośnik do danego wpisu, na wypadek, gdyby ktoś chciał podać doń URL:

<h2 id="&ENTRY_ID;"><a href="#&ENTRY_ID;"><ENTRY_SUBJECT/></a></h2>

ENTRY_LEVEL

typ
pojedynczy, zapis: <ENTRY_LEVEL/> lub &ENTRY_LEVEL;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
działanie
wstawia identyfikator oznaczającą poziom dostępności wpisu. Poziom ten określa się poprzedzając treść wpisu znacznikiem <LEVELx>, gdzie x to domyślnie liczba od 0 do 11. Można zmienić to w panelu administracyjnym (Poziomy). Poziom 0 oznacza, że wpis będzie widoczne dla każdego, a oprócz tego (i tym różni się od poziomu 1.) zostanie wyświetlony na stronie głównej Joggera, w częsci "Ostatnio dodane wpisy". Poziom 2 jest tylko dla zalogowanych użytkowników Jogger.pl a poziomy od 3 do 10 są już prywatne, by przeczytać takie wpisy, należy posiadać konto na danym blogu (do ustawienia w panelu - Użytkownicy poziomów).

Ważne: Identyfikato

przykład
Znacznika <ENTRY_LEVEL> można użyć na przykład do określenia koloru tła tytułu w zależności od poziomu dostępności wpisu.
<h2 class="poziom&ENTRY_LEVEL;" id="&ENTRY_ID;"><ENTRY_SUBJECT/></h2>
CSS:
.poziom0 { background-color: #fff; }
.poziom1 { background-color: #eee; }
.poziom2 { background-color: #ddd; }
.poziom3 { background-color: #ccc; }
(...)
/* można też hurtem określić ten sam identyfikator dla poziomów 
np.: 3 - 6 jako "priv" i potem tylko dać w CSS .priv { … } */
uwagi
Znacznika można użyć na wiele sposobów. Można po prostu przy każdym wpisie wyświetlić jego poziom dostępności, można (tak jak wyżej) zmieniać kolory tła wpisów, można użyć atrybutu title, lub pseudoelementów CSS :before i :after (np. .poziom2:after { content: " (Wpis ukryty)" } - pomysł XyCastego. Wszystko jest dozwolone.

ENTRY_CONTENT

typ
pojedynczy, zapis: <ENTRY_CONTENT/> lub &ENTRY_CONTENT;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
działanie
Wstawia treść wpisu.

ENTRY_CONTENT_SHORT

typ
pojedynczy, zapis: <ENTRY_CONTENT_SHORT/> lub &ENTRY_CONTENT_SHORT;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i szablon komentarzy
działanie
Znacznik działa podobnie do ENTRY_CONTENT (wstawia treść wspisu), lecz, gdy w treści tej napotka <EXCERPT>, to obcina wszystko co jest za tym tagiem (praktyczne użycie może sprowadzać się tylko do strony głównej szablonu, na stronie komentarzy zalecany byłby znacznik ENTRY_CONTENT).

ENTRY_CONTENT_SHORT_EXIST

typ
wymagany tag otwierający i tag zamykający (<ENTRY_CONTENT_SHORT_EXIST> ... </ENTRY_CONTENT_SHORT_EXIST>)
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) (lecz działa także w szablonie komentarzy)
działanie
Zawartość bloku będzie pokazana jedynie wtedy, gdy istnieje skrót wpisu (działa znacznik ENTRY_CONTENT_SHORT czyli we wpisie jest EXCERPT).
uwagi
Główne wykorzystanie znacznika sprowadza się do ukrywania / pokazywania linka "Czytaj dalej" dla wpisów skróconych na stronie głównej
przykład
<ENTRY_CONTENT_SHORT/>
 <ENTRY_CONTENT_SHORT_EXIST>
  <p class="readmore">
   <a href="&ENTRY_COMMENT_HREF;#more">Czytaj dalej...</a>
  </p>
 </ENTRY_CONTENT_SHORT_EXIST>

ENTRY_CONTENT_SHORT_NOT_EXIST

typ
wymagany tag otwierający i tag zamykający (<ENTRY_CONTENT_SHORT_NOT_EXIST> ... </ENTRY_CONTENT_SHORT_NOT_EXIST>)
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) (lecz działa także w szablonie komentarzy)
działanie
Zawartość bloku będzie pokazana jedynie wtedy, gdy nie istnieje skrót wpisu (nie działa znacznik ENTRY_CONTENT_SHORT bo we wpisie nie ma EXCERPT).

ENTRY_CONTENT_LONG

typ
pojedynczy (<ENTRY_CONTENT_LONG/>)
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK), szablon komentarzy
działanie
Działa tak samo jak ENTRY_CONTENT_SHORT lecz pokazuje treść wpisu po EXCERPT.
uwagi
Wykorzystując znacznik możemy rozbić wpisy wykorzystujące skróty EXCERPT na dwie części. Można dzięki temu utworzyć dowiązanie do drugiej części i utworzyć link przeskakujący od razu do niej ze strony głównej joggera (przykład dostępny w opisie znacznika ENTRY_CONTENT_SHORT_EXIST.
przykład
<ENTRY_CONTENT_SHORT/>
<ENTRY_CONTENT_SHORT_EXIST>
  <div id="more">
   <ENTRY_CONTENT_LONG/>
  </div>
</ENTRY_CONTENT_SHORT_EXIST>

ENTRY_COMMENT_HREF

typ
pojedynczy, zapis: <code><ENTRY_COMMENT_HREF/> lub &ENTRY_COMMENT_HREF;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) i na stronie komentarzy
działanie
Wstawia URL / permalink do wpisu. Może być używany jako link do strony z komentarzami na stronie głównej joggera oraz wskaźnik na aktualny wpis na stronie komentarzy.

ENTRY_COMMENT_HREF_DESCR

typ
pojedynczy, zapis: <ENTRY_COMMENT_HREF_DESCR/> lub &ENTRY_COMMENT_HREF_DESCR;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK) oraz strona z komentarzami
działanie
Wstawia tekst odnośnika do stron z komentarzami. Jeśli nie ma żadnych komentarzy, wtedy jest to "Dodaj komentarz". Jeśli komentarze są - np. "1 komentarz", "3 komentarze", "5 komentarzy". Jeśli komentarze są wyłączone, pojawi się napis "Komentarze zablokowane".
uwagi
Ponieważ możliwe jest, że kilka wpisów nie będzie miało żadnego komentarza lub będą miały taką samą ich liczbę, może się zdarzyć, że na stronie będzie kilka odnośników tak samo opisanych, a prowadzących do różnych stron. Może to spowodować nieporozumienia, szczególnie w przeglądarkach tekstowych lub dźwiękowych. Dlatego zalecany jest zapis:
<a href="&ENTRY_COMMENT_HREF;">
<ENTRY_COMMENT_HREF_DESCR/><p class="ukryj"> do wpisu <em><ENTRY_SUBJECT/></em></p>
</a>
Klasa "ukryj" powinna zostać w CSS zdefiniowana następująco:
.ukryj {
       text-indent: -1000em;
}
Dzieki temu, przeglądając stronę bez CSS, zamiast napisu "2 komentarze" w trzech różnych miejscach, zobaczymy: "2 komentarze do wpisu Pierwszy", "2 komentarze do wpisu Drugi", "2 komentarze do wpisu Trzeci". Zastosowanie display: none jest o tyle złe, że pozbawimy użytkowników czytników ekranu tej treści także.

ENTRY_CLASS

typ
pojedynczy, zapis: <ENTRY_CLASS> lub &ENTRY_CLASS;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK)
działanie
Działa analogicznie do znacznika COMMENT_CLASS - naprzemiennie wstawia tekst entry1 i entry2. Można go użyć zarówno do wpisów jak i do całych dni, o ile w szablonie zastosowano znacznik ENTRY_DAY_BLOCK. ENTRY_CLASS zawsze wstawia wspomniane teksty naprzemiennie - bez względu na liczbę wpisów zgrupowanych pod jedną datą.
uwagi
patrz ENTRY_CLASS_RESET

ENTRY_CLASS_RESET

typ
pojedynczy, zapis: <ENTRY_CLASS_RESET> lub &ENTRY_CLASS_RESET;
stosowanie
strona główna joggera (w bloku ENTRY_BLOCK)
działanie
Działa tylko w połączeniu z ENTRY_CLASS. Nie ma ściśle wyznaczonego miejsca, może zostać wpisany gdziekolwiek w bloku ENTRY_BLOCK. Powoduje zignorowanie dotychczasowego porządku działania ENTRY_CLASS i ponowne rozpoczęcie od entry1. Znacznik ten może być przydatny, jeśli wpisy zgrupowane pod wspólną datą mają zmieniać klasy lokalnie, a nie globalnie. W takim przypadku każdy pierwszy wpis danego dnia miałby klasę entry1.

ENTRY_CATEGORY_BLOCK

typ
wymagany tag otwierający i zamykający (<ENTRY_CATEGORY_BLOCK> ... </ENTRY_CATEGORY_BLOCK>)
stosowanie
szablon strony głównej i szablon komentarzy (pomiędzy znacznikami <ENTRY_BLOCK> ... </ENTRY_BLOCK>)
działanie
w tym bloku umieszczona jest kategoria danego wpisu
przykład
<ENTRY_BLOCK>
   <div class="entry">
       <h2 id="&ENTRY_ID;"><a href="&ENTRY_COMMENT_HREF;"><ENTRY_SUBJECT/></a></h2>
       <p><ENTRY_LEVEL/> poziom | <ENTRY_DATE/>, <ENTRY_HOUR/><br />
       kategoria: 
           <ENTRY_CATEGORY_BLOCK>
           <a href="&ENTRY_CATEGORY_HREF;"><ENTRY_CATEGORY_HREF_DESCR/></a>
           <ENTRY_CATEGORY_NOT_LAST>, </ENTRY_CATEGORY_NOT_LAST>
           </ENTRY_CATEGORY_BLOCK></p>
       <p><ENTRY_CONTENT/></p>
       <p><a href="&ENTRY_COMMENT_HREF;"><ENTRY_COMMENT_HREF_DESCR/></a></p>
   </div>
</ENTRY_BLOCK>

ENTRY_CATEGORY_CLASS

typ
pojedynczy, zapis: &ENTRY_CATEGORY_CLASS; lub <ENTRY_CATEGORY_CLASS/>
stosowanie
blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
działanie
wstawia naprzemiennie tekst entrycategory1 i entrycategory2; działa analogicznie do ENTRY_CLASS i COMMENT_CLASS (wykorzystywany, gdy w użyciu jest ENTRY_CATEGORY_HREF_DESCR2)

ENTRY_CATEGORY_HREF

typ
pojedynczy, zapis: &ENTRY_CATEGORY_HREF; lub <ENTRY_CATEGORY_HREF/>
stosowanie
blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
działanie
wstawia URL do kategorii (przy notce)

ENTRY_CATEGORY_HREF_DESCR

typ
pojedynczy, zapis: &ENTRY_CATEGORY_HREF_DESCR; lub <ENTRY_CATEGORY_HREF_DESCR/>
stosowanie
blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
działanie
wstawia tytuł (opis) linku kategorii (przy notce)

ENTRY_CATEGORY_HREF_DESCR2

typ
pojedynczy, zapis: &ENTRY_CATEGORY_HREF_DESCR2; lub <ENTRY_CATEGORY_HREF_DESCR2/>
stosowanie
blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
działanie
Wstawia tytuły jednej lub więcej kategorii przy wpisie; każda z nich odzielona jest przecinkiem. Wykorzystywane, gdy użytkownik chce dodawać wpisy nie tylko do jednej kategorii).

ENTRY_CATEGORY_NOT_LAST

typ
wymagany tag otwierający i tag zamykający (<ENTRY_CATEGORY_NOT_LAST> ... </ENTRY_CATEGORY_NOT_LAST>)
stosowanie
blok ENTRY_CATEGORY_BLOCK (szablon strony głównej i szablon komentarzy)
działanie
Jego zawartość zostanie wstawiona, jeśli kategoria wpisu nie jest ostatnią z kategorii, do których należy wpis. Wykorzystywane, gdy użytkownik chce dodawać wpisy nie tylko do jednej kategorii).