|
|
(Nie pokazano 52 wersji utworzonych przez 15 użytkowników) |
Linia 1: |
Linia 1: |
− | Lista i opisy dostępnych tagów Joggera 2.0. Nowe tagi są odpowiednio zaznaczone. | + | '''[[Tagi/Lista|Lista wszystkich dostępnych tagów Joggera]]''': |
| | | |
− | ==Wpis (ENTRY)==
| + | * [[Tagi/Wpisy|Wpisy]] |
− | ===ENTRY_BLOCK===
| + | * [[Tagi/Strony|Strony]] |
− | ;typ
| + | * [[Tagi/Stronicowanie|Stronicowanie]] |
− | :wymagany tag otwierający i tag zamykający (<code><ENTRY_BLOCK> ... </ENTRY_BLOCK></code>)
| + | * [[Tagi/Archiwum|Archiwum]] |
− | ;stosowanie
| + | * [[Tagi/Kategorie|Kategorie]] |
− | :strona główna joggera
| + | * [[Tagi/Linki|Linki]] |
− | ;działanie
| + | * [[Tagi/Komentarze|Komentarze]] |
− | :wstawia wpisy
| + | * [[Tagi/Formularz|Formularz]] |
− | ;przykład
| + | * [[Tagi/Admin|Admin]] |
− | :
| + | * [[Tagi/Niezalogowany|Niezalogowany użytkownik]] |
− | <ENTRY_BLOCK>
| + | * [[Tagi/Zalogowany|Zalogowany użytkownik]] |
− | <div class="entry">
| + | * [[Tagi/Użytkownik Joggera]] |
− | <h2 id="&ENTRY_ID;"><a href="&ENTRY_COMMENT_HREF;"><ENTRY_SUBJECT/></a></h2>
| + | * [[Tagi/Status|Status]] |
− | <p><ENTRY_LEVEL/> poziom | <ENTRY_DATE/>, <ENTRY_HOUR/><br />
| + | * [[Tagi/Wyszukiwarka|Wyszukiwarka]] |
− | kategoria:
| + | * [[Tagi/Inne|Inne]] |
− | <ENTRY_CATEGORY_BLOCK>
| + | * [[Tagi/MiniBlog|MiniBlog]] |
− | <a href="&ENTRY_CATEGORY_HREF;"><ENTRY_CATEGORY_HREF_DESCR/></a><ENTRY_CATEGORY_NOT_LAST>, </ENTRY_CATEGORY_NOT_LAST>
| + | * [[Tagi/Tagi|Tagi]] |
− | </ENTRY_CATEGORY_BLOCK></p>
| + | |
− | <p><ENTRY_CONTENT/></p>
| + | |
− | <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===
| + | [[Kategoria:Pomoc|Tagi]] |
− | ;typ
| + | [[Kategoria:Tagi|!]] |
− | :znacznik opcjonalny; wymagany tag otwierający i tag zamykający (<code><ENTRY_DAY_BLOCK> ... </ENTRY_DAY_BLOCK></code>)
| + | |
− | ;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_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 <strong>ENTRY_DATE</strong> oraz na położenie poziomej linii <code><hr /></code>
| + | |
− | | + | |
− | ===ENTRY_SUBJECT===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code><ENTRY_SUBJECT/></code> lub <code>&ENTRY_SUBJECT;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) 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: <code><ENTRY_DATE/></code> lub <code>&ENTRY_DATE;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy
| + | |
− | ;działanie
| + | |
− | :wstawia datę (dzień, miesiąc (słownie) i rok) wysłania wpisu lub wpisów.
| + | |
− | | + | |
− | ===ENTRY_HOUR===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code><ENTRY_HOUR/></code> lub <code>&ENTRY_HOUR;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy
| + | |
− | ;działanie
| + | |
− | :wstawia godzinę wysłania wpisu (w formacie GG:MM:SS).
| + | |
− | | + | |
− | ===ENTRY_ID===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code><ENTRY_ID/></code> lub <code>&ENTRY_ID;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy
| + | |
− | ;działanie
| + | |
− | :wstawia numer ID wpisu w bazie Joggera. Można tego użyć, by stworzyć zakotwiczenie do wpisu (ang. <em lang="en" xml:lang="en">anchor link</em>). Wstawiany tekst wygląda np. tak: <code>e32726</code>
| + | |
− | ;przykłady
| + | |
− | :znacznika mozna użyć po prostu w atrybucie <strong>id</strong> 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: <code><ENTRY_LEVEL/></code> lub <code>&ENTRY_LEVEL</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy
| + | |
− | ;działanie
| + | |
− | :wstawia liczbę oznaczającą poziom dostępności wpisu. Poziom ten określa się poprzedzając treść wpisu znacznikiem <code><LEVELx></code>, gdzie x to liczba od 0 do 10. 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". Poziomy od 2 do 10 są już prywatne, by przeczytać takie wpisy, należy się zalogować.
| + | |
− | ;przykład
| + | |
− | :Znacznika <code><ENTRY_LEVEL></code> 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; }
| + | |
− | (...)
| + | |
− | ;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 <strong>title</strong>, lub pseudoelementów CSS :before i :after (np. <code>.poziom2:after { content: " (Wpis ukryty)" }</code> - pomysł [http://xyc.jogger.pl XyCastego]. Wszystko jest dozwolone.
| + | |
− | | + | |
− | ===ENTRY_CONTENT===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code><ENTRY_CONTENT/></code> lub <code>&ENTRY_CONTENT;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy
| + | |
− | ;działanie
| + | |
− | :Wstawia treść wpisu.
| + | |
− | | + | |
− | ===ENTRY_CONTENT_SHORT (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code><ENTRY_CONTENT_SHORT/></code> lub <code>&ENTRY_CONTENT_SHORT;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) i szablon komentarzy
| + | |
− | ;działanie
| + | |
− | :Znacznik działa podobnie do <strong>ENTRY_CONTENT</strong> (wstawia treść wspisu), lecz, gdy w treści tej napotka <code><EXCERPT></code>, 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 <strong>ENTRY_CONTENT</strong>).
| + | |
− | | + | |
− | ===ENTRY_CONTENT_SHORT_EXIST (NOWY)===
| + | |
− | | + | |
− | ;typ
| + | |
− | :wymagany tag otwierający i tag zamykający (<code><ENTRY_CONTENT_SHORT_EXIST> ... </ENTRY_CONTENT_SHORT_EXIST></code>)
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) (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 (NOWY)===
| + | |
− | | + | |
− | ;typ
| + | |
− | :wymagany tag otwierający i tag zamykający (<code><ENTRY_CONTENT_SHORT_NOT_EXIST> ... </ENTRY_CONTENT_SHORT_NOT_EXIST></code>)
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) (lecz działa także w szablonie komentarzy)
| + | |
− | ;działanie
| + | |
− | :Zawartość bloku będzie pokazana jedynie wtedy, gdy <u>nie</u> istnieje skrót wpisu (nie działa znacznik '''ENTRY_CONTENT_SHORT''' bo we wpisie nie ma '''EXCERPT''').
| + | |
− | | + | |
− | ===ENTRY_CONTENT_LONG (NOWY)===
| + | |
− | | + | |
− | ;typ
| + | |
− | :pojedynczy (<code><ENTRY_CONTENT_LONG/>)
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>), szablon komentarzy
| + | |
− | ;działanie
| + | |
− | :Działa tak samo jak '''ENTRY_CONTENT_SHORT''' lecz pokazuje treść wpisu <u>po</u> '''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/></code> lub <code>&ENTRY_COMMENT_HREF;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) 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: <code><ENTRY_COMMENT_HREF_DESCR/></code> lub <code>&ENTRY_COMMENT_HREF_DESCR;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>) 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/><span class="ukryj"> do wpisu <em><ENTRY_SUBJECT/></em></span>
| + | |
− | </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 <em>Pierwszy</em>", "2 komentarze do wpisu <em>Drugi</em>", "2 komentarze do wpisu <em>Trzeci</em>". Zastosowanie <code>display: none</code> jest o tyle złe, że pozbawimy użytkowników czytników ekranu tej treści także.
| + | |
− | | + | |
− | ===ENTRY_CLASS===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code><ENTRY_CLASS></code> lub <code>&ENTRY_CLASS;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>)
| + | |
− | ;działanie
| + | |
− | :Działa analogicznie do znacznika <strong>COMMENT_CLASS</strong> - naprzemiennie wstawia tekst <code>entry1</code> i <code>entry2</code>. Można go użyć zarówno do wpisów jak i do całych dni, o ile w szablonie zastosowano znacznik <strong>ENTRY_DAY_BLOCK</strong>. <strong>ENTRY_CLASS</strong> zawsze wstawia wspomniane teksty naprzemiennie - bez względu na liczbę wpisów zgrupowanych pod jedną datą.
| + | |
− | ;uwagi
| + | |
− | :patrz <strong>ENTRY_CLASS_RESET</strong>
| + | |
− | | + | |
− | ===ENTRY_CLASS_RESET===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code><ENTRY_CLASS_RESET></code> lub <code>&ENTRY_CLASS_RESET;</code>
| + | |
− | ;stosowanie
| + | |
− | :strona główna joggera (w bloku <strong>ENTRY_BLOCK</strong>)
| + | |
− | ;działanie
| + | |
− | :Działa tylko w połączeniu z <strong>ENTRY_CLASS</strong>. Nie ma ściśle wyznaczonego miejsca, może zostać wpisany gdziekolwiek w bloku <strong>ENTRY_BLOCK</strong>. Powoduje zignorowanie dotychczasowego porządku działania <strong>ENTRY_CLASS</strong> i ponowne rozpoczęcie od <code>entry1</code>. 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ę <code>entry1</code>.
| + | |
− | | + | |
− | ===ENTRY_CATEGORY_BLOCK (NOWY)===
| + | |
− | ;typ
| + | |
− | :wymagany tag otwierający i zamykający (<code><ENTRY_CATEGORY_BLOCK> ... </ENTRY_CATEGORY_BLOCK></code>)
| + | |
− | ;stosowanie
| + | |
− | :szablon strony głównej i szablon komentarzy (pomiędzy znacznikami <code><ENTRY_BLOCK> ... </ENTRY_BLOCK></code>)
| + | |
− | ;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_BLOCK></p>
| + | |
− | <p><ENTRY_CONTENT/></p>
| + | |
− | <p><a href="&ENTRY_COMMENT_HREF;"><ENTRY_COMMENT_HREF_DESCR/></a></p>
| + | |
− | </div>
| + | |
− | </ENTRY_BLOCK>
| + | |
− | | + | |
− | ===ENTRY_CATEGORY_CLASS (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code>&ENTRY_CATEGORY_CLASS;</code> lub <code><ENTRY_CATEGORY_CLASS/></code>
| + | |
− | ;stosowanie
| + | |
− | :blok <b>ENTRY_CATEGORY_BLOCK</b> (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia naprzemiennie tekst <code>entrycategory1</code> i <code>entrycategory2</code>; działa analogicznie do '''ENTRY_CLASS''' i '''COMMENT_CLASS''' (wykorzystywany, gdy w użyciu jest '''ENTRY_CATEGORY_HREF_DESCR2''')
| + | |
− | | + | |
− | ===ENTRY_CATEGORY_HREF (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code>&ENTRY_CATEGORY_HREF;</code> lub <code><ENTRY_CATEGORY_HREF/></code>
| + | |
− | ;stosowanie
| + | |
− | :blok '''ENTRY_CATEGORY_BLOCK''' (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia URL do kategorii (przy notce)
| + | |
− | | + | |
− | ===ENTRY_CATEGORY_HREF_DESCR (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code>&ENTRY_CATEGORY_HREF_DESCR;</code> lub <code><ENTRY_CATEGORY_HREF_DESCR/></code>
| + | |
− | ;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 (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code>&ENTRY_CATEGORY_HREF_DESCR2;</code> lub <code><ENTRY_CATEGORY_HREF_DESCR2/></code>
| + | |
− | ;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).
| + | |
− | | + | |
− | | + | |
− | | + | |
− | ==Archwium wpisów (ARCHIVE)==
| + | |
− | ===ARCHIVE_BLOCK===
| + | |
− | ;typ
| + | |
− | :wymagany tag otwierający i tag zamykający (<code><ARCHIVE_BLOCK> ... </ARCHIVE_BLOCK></code>)
| + | |
− | ;stosowanie
| + | |
− | :szablon strony głównej i szablon komentarzy
| + | |
− | ;działanie
| + | |
− | :w tym bloku należy umieścić kod odpowiadający za wyświetlanie linków do stron z poprzednimi wpisami.
| + | |
− | ;przykład
| + | |
− | Starsze wpisy:
| + | |
− | <ul>
| + | |
− | <ARCHIVE_BLOCK>
| + | |
− | <li><a href="&ARCHIVE_HREF;"><ARCHIVE_HREF_DESCR/></a></li>
| + | |
− | </ARCHIVE_BLOCK>
| + | |
− | </ul>
| + | |
− | | + | |
− | ===ARCHIVE_ENTRIES (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis <code>&ARCHIVE_ENTRIES;</code> lub <code><ARCHIVE_ENTRIES/></code>
| + | |
− | ;stosowanie
| + | |
− | :blok '''ARCHIVE_BLOCK''' (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia liczbę wpisów w danym okresie archiwum
| + | |
− | | + | |
− | ===ARCHIVE_HREF===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code><ARCHIVE_HREF/></code> lub <code>&ARCHIVE_HREF;</code>
| + | |
− | ;stosowanie
| + | |
− | :blok <strong>ARCHIVE_BLOCK</strong> (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia URL do stron archiwum.
| + | |
− | | + | |
− | ===ARCHIVE_HREF_DESCR===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code><ARCHIVE_HREF_DESCR/></code> lub <code>&ARCHIVE_HREF_DESCR;</code>
| + | |
− | ;stosowanie
| + | |
− | :blok <strong>ARCHIVE_BLOCK</strong> (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia nazwy stron archiwum (np. <em>Styczeń 2004</em> lub - jeśli sortujemy wpisy według ich liczby na stronie - np. <em>17.02.2004 - 27.01.2004</em>).
| + | |
− | | + | |
− | ===ARCHIVE_CLASS (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code>&ARCHIVE_CLASS;</code> lub <code><ARCHIVE_CLASS/></code>
| + | |
− | ;stosowanie
| + | |
− | :blok '''ARCHIVE_BLOCK''' (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia naprzemiennie tekst <code>archive1</code> i <code>archive2</code>; działa analogicznie do '''ENTRY_CLASS''' i '''COMMENT_CLASS'''
| + | |
− | | + | |
− | ===ARCHIVE_CURRENT_DESCR (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code>&ARCHIVE_CURRENT_DESCR;</code> lub <code><ARCHIVE_CURRENT_DESCR/></code>
| + | |
− | ;stosowanie
| + | |
− | :szablon strony głównej i szablon komentarzy (nie musi znajdywać się w bloku '''ARCHIVE_BLOCK''')
| + | |
− | ;działanie
| + | |
− | :wstawia opis (zależnie od wyboru użytkownika w panelu administracyjnym, czyli albo podział na miesiące, albo na dni) archwium, które jest obecnie oglądane
| + | |
− | | + | |
− | | + | |
− | | + | |
− | ==Kategorie wpisów (CATEGORY) (NOWY)==
| + | |
− | ===CATEGORY_BLOCK (NOWY)===
| + | |
− | ;typ
| + | |
− | :wymagany tag otwierający i zamykający (<code><CATEGORY_BLOCK> ... </CATEGORY_BLOCK></code>)
| + | |
− | ;stosowanie
| + | |
− | :szablon strony głównej i szablon komentarzy
| + | |
− | ;działanie
| + | |
− | :w tym bloku umieszczana jest lista z kategoriami
| + | |
− | ;przykład
| + | |
− | <ul id="categories">
| + | |
− | <CATEGORY_BLOCK>
| + | |
− | <li class="&CATEGORY_CLASS;" id="&CATEGORY_ID;">
| + | |
− | <a href="&CATEGORY_HREF;"><CATEGORY_HREF_DESCR/>
| + | |
− | (<CATEGORY_ENTRIES/>)</a></li>
| + | |
− | </CATEGORY_BLOCK>
| + | |
− | </ul>
| + | |
− | | + | |
− | ===CATEGORY_CLASS (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code>&CATEGORY_CLASS;</code> lub <code><CATEGORY_CLASS/></code>
| + | |
− | ;stosowanie
| + | |
− | :blok '''CATEGORY_BLOCK''' (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia naprzemiennie tekst <code>category1</code> i <code>category2</code>; działa analogicznie do '''ENTRY_CLASS''', '''COMMENT_CLASS''', '''CATEGORY_CLASS''' i '''LINK_CLASS'''
| + | |
− | | + | |
− | ===CATEGORY_ENTRIES (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis <code>&CATEGORY_ENTRIES;</code> lub <code><CATEGORY_ENTRIES/></code>
| + | |
− | ;stosowanie
| + | |
− | :blok '''CATEGORY_BLOCK''' (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia liczbę wpisów w danej kategorii
| + | |
− | | + | |
− | ===CATEGORY_HREF (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis: <code>&CATEGORY_HREF;</code> lub <code><CATEGORY_HREF/></code>
| + | |
− | ;stosowanie
| + | |
− | :blok '''CATEGORY_BLOCK''' (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia URL do kategorii (lista kategorii)
| + | |
− | | + | |
− | ===CATEGORY_HREF_DESCR (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis <code>&CATEGORY_HREF_DESCR;</code> lub <code><CATEGORY_HREF_DESCR/></code>
| + | |
− | ;stosowanie
| + | |
− | :blok '''CATEGORY_BLOCK''' (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia tytuł (opis) linku prowadzącego do danej kategorii
| + | |
− | | + | |
− | ===CATEGORY_ID (NOWY)===
| + | |
− | ;typ
| + | |
− | :pojedynczy, zapis <code>&CATEGORY_ID;</code> lub <code><CATEGORY_ID/></code>
| + | |
− | ;stosowanie
| + | |
− | :blok '''CATEGORY_BLOCK''' (szablon strony głównej i szablon komentarzy)
| + | |
− | ;działanie
| + | |
− | :wstawia identyfikator do kategorii
| + | |
− | | + | |
− | | + | |
− | | + | |
− | ==Linki (LINK)==
| + | |
− | ===LINK_BLOCK_EXIST (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i tag zamykający (<code><LINK_BLOCK_EXIST> ... </LINK_BLOCK_EXIST></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>w tym bloku należy umieścić LINK_BLOCK - jeśli dodaliśmy jakieś linki w panelu administracyjnym, pojawi się wszystko co jest w środku tego bloku</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <LINK_BLOCK_EXIST>
| + | |
− | <h3>Linki:</h3>
| + | |
− | <ul>
| + | |
− | <LINK_BLOCK>
| + | |
− | <li><a href="&LINK_HREF;"><LINK_HREF_DESCR/></a></li>
| + | |
− | </LINK_BLOCK>
| + | |
− | </ul>
| + | |
− | </LINK_BLOCK_EXIST>
| + | |
− | </pre></dd>
| + | |
− | </dl>
| + | |
− | | + | |
− | ===LINK_GROUP_BLOCK (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i zamykający (<code><LINK_GROUP_BLOCK> ... </LINK_GROUP_BLOCK></code>)</dd></dl>
| + | |
− | <dl><dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd></dl>
| + | |
− | <dl><dt>działanie</dt>
| + | |
− | <dd>w tym bloku umieszczana jest lista kategorii linków oraz linki należące do tej kategorii</dd></dl>
| + | |
− | <dl><dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <ul id="links">
| + | |
− | <LINK_GROUP_BLOCK>
| + | |
− | <li><LINK_GROUP_DESCR/>
| + | |
− | <LINK_CLASS_RESET/>
| + | |
− | <ul>
| + | |
− | <LINK_BLOCK>
| + | |
− | <li class="&LINK_CLASS;"><a href="&LINK_HREF;"><LINK_HREF_DESCR/></a></li>
| + | |
− | </LINK_BLOCK>
| + | |
− | </ul>
| + | |
− | </li>
| + | |
− | </LINK_GROUP_BLOCK>
| + | |
− | </ul>
| + | |
− | </pre></dd></dl>
| + | |
− | <dl><dt>uwagi</dt>
| + | |
− | <dd><ol>
| + | |
− | <li>należy zauważyć, że blok <b>LINK_BLOCK</b> znajduje się pomiędzy blokiem <b>LINK_GROUP_BLOCK</b> (w innym przypadku jogger wywołuje błąd)</li>
| + | |
− | <li>najlepszym rozwiązaniem tego jest użycie nieuporządkowanej listy <code><ul>...</ul></code> (jak podano w przykładzie)</li>
| + | |
− | </ol></dd></dl>
| + | |
− | | + | |
− | ===LINK_GROUP_DESCR (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis <code>&LINK_GROUP_DESCR;</code> lub <code><LINK_GROUP_DESCR/></code></dd></dl>
| + | |
− | <dl><dt>stosowanie</dt>
| + | |
− | <dd>blok <b>LINK_GROUP_BLOCK</b> (szablon strony głównej i szablon komentarzy)</dd></dl>
| + | |
− | <dl><dt>działanie</dt>
| + | |
− | <dd>wstawia tytuł (opis) kategorii (grupy) linków</dd></dl>
| + | |
− | | + | |
− | ===LINK_BLOCK===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i tag zamykający (<code><LINK_BLOCK> ... </LINK_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>w tym bloku należy umieścić kod odpowiadający za wyświetlanie linków do stron, które zapamiętamy w panelu konfiguracyjnym Joggera. Odnośniki zostaną wyświetlone w kolejności alfabetycznej. Dzięki tej funkcji
| + | |
− | można dodawać i usuwać linki do ulubionych stron bez konieczności zmiany kodu szablonu.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <ul>
| + | |
− | <LINK_BLOCK>
| + | |
− | <li><a href="&LINK_HREF;"><LINK_HREF_DESCR/></a></li>
| + | |
− | </LINK_BLOCK>
| + | |
− | </ul>
| + | |
− | </pre></dd>
| + | |
− | </dl>
| + | |
− | | + | |
− | ===LINK_HREF===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><LINK_HREF/></code> lub <code>&LINK_HREF;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>LINK_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia URL do polecanych stron. (patrz: wyjaśnienie przy <strong>LINK_BLOCK</strong>)</dd></dl>
| + | |
− | | + | |
− | ===LINK_HREF_DESCR===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><LINK_HREF_DESCR/></code> lub <code>&LINK_HREF_DESCR;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>LINK_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia nazwy polecanych stron. (patrz: wyjaśnienie przy <strong>LINK_BLOCK</strong>)</dd></dl>
| + | |
− | | + | |
− | | + | |
− | ===LINK_TITLE (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><LINK_TITLE/></code> lub <code>&LINK_TITLE;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>LINK_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia opis polecanych stron. (patrz: wyjaśnienie przy <strong>LINK_BLOCK</strong>)</dd></dl>
| + | |
− | | + | |
− | ===LINK_CLASS (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><LINK_CLASS/></code> lub <code>&LINK_CLASS;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>LINK_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia naprzemiennie <code>link1</code> i <code>link2</code>. pomocne przy stylowaniu menu z linkami innym kolorem co drugi link</dd></dl>
| + | |
− | | + | |
− | ===LINK_CLASS_RESET (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><LINK_CLASS_RESET/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>LINK_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>resetuje wypisywanie <code>link1</code>, <code>link2</code> - przydatne gry nowa grupa linków ma być na przykład kolorowana naprzemiennie, ale samodzielnie, a nie jako całość z resztą grup</dd></dl>
| + | |
− | ----
| + | |
− | | + | |
− | ==Komentarze (COMMENT)==
| + | |
− | ===COMMENT_BLOCK===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i tag zamykający (<code><COMMENT_BLOCK>... </COMMENT_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>blok służy wyświetlaniu kolejnych komentarzy.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <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>
| + | |
− | </pre></dd>
| + | |
− | </dl>
| + | |
− | | + | |
− | ===COMMENT_CLASS===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy , zapis: <code><COMMENT_CLASS/></code> lub <code>&COMMENT_CLASS;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia na zmianę <code>comment1</code> lub <code>comment2</code>. Dzięki temu można za pomocą CSS zróżnicować wygląd sąsiadujących komentarzy, i tym samym ułatwić ich czytanie. Najczęściej definiuje się odmienne kolory tła lub style obramowania.</dd></dl>
| + | |
− | | + | |
− | ===COMMENT_NICK===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><COMMENT_NICK/></code> lub <code>&COMMENT_NICK;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia podpis komentującego. 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.</dd></dl>
| + | |
− | | + | |
− | ===COMMENT_DATE===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><COMMENT_DATE/></code> lub <code>&COMMENT_DATE;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia datę dodania komentarza.</dd></dl>
| + | |
− | | + | |
− | ===COMMENT_HOUR===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><COMMENT_HOUR/></code> lub <code>&COMMENT_HOUR;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia godzinę dodania komentarza.</dd></dl>
| + | |
− | | + | |
− | ===COMMENT_CONTENT===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><COMMENT_CONTENT/></code> lub <code>&COMMENT_CONTENT;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia treść komentarza.</dd></dl>
| + | |
− | | + | |
− | ===COMMENT_FAVICON (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis <code>&COMMENT_FAVICON;</code> lub <code><COMMENT_FAVICON/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <b>COMMENT_BLOCK</b> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>znacznik jest podmieniany na favikone zarejestrowanego użytwkownika; wymagany plik w katalogu: favicon.png, favicon.gif, favicon.jpg lub favicon.ico; maksymalna wielkość favikony to 32x32 piksele</dd>
| + | |
− | | + | |
− | ===COMMENT_FAVICON2 (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis <code>&COMMENT_FAVICON2;</code> lub <code><COMMENT_FAVICON2/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <b>COMMENT_BLOCK</b> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia czysty link do obrazka (favikony)</dd>
| + | |
− | | + | |
− | ===COMMENT_ID===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis <code>&COMMENT_ID;</code> lub <code><COMMENT_ID/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <b>COMMENT_BLOCK</b> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia identyfikator komentarza - jego numer w systemie<br/>aby zapobiec rozwalidowaniu się szablonu należy dostawić prefiks, na przykład "comm":</dd>
| + | |
− | <dd><pre><a id="comm&COMMENT_ID;" href="#comm&COMMENT_ID;" title="Permalink do komentarza">Permalink</a></pre></dd></dl>
| + | |
− | | + | |
− | ===COMMENT_NICK_CLASS (NOWY)===
| + | |
− | <dl>
| + | |
− | <dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis <code>&COMMENT_NICK_CLASS;</code> lub <code><COMMENT_NICK_CLASS/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>Wstawia <code>owner</code> jeżeli autorem komentarza jest wlasciciel joggera lub <code>jogger</code> w przypadku, gdy komentarz jest innego zalogowanego użytkownika joggera, albo <code>guest</code> jeżeli komentującym jest osoba niezalogowana. Dzięki temu przy pomocy CSS można np. wyróżnić komentarze właściciela joggera. Najczęściej robi się to poprzez zdefiniowanie koloru, bądź obrazka tła lub nadanie komentarzowi obramowania.</dd>
| + | |
− | <dt>uwagi</dt>
| + | |
− | <dd>patrz <strong>COMMENT_CLASS</strong></dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <COMMENT_BLOCK>
| + | |
− | <div class="<COMMENT_NICK_CLASS/> <COMMENT_CLASS/>">
| + | |
− | (...)
| + | |
− | </div>
| + | |
− | </COMMENT_BLOCK>
| + | |
− | </pre></dd>
| + | |
− | </dl>
| + | |
− |
| + | |
− | | + | |
− | ----
| + | |
− | | + | |
− | | + | |
− | ==Formularz komentarzy (COMMENT_FORM)==
| + | |
− | ===COMMENT_FORM===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><COMMENT_FORM/></code> lub <code>&COMMENT_FORM;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia cały formularz do dodawania komentarzy.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <h2>Dodaj swój komentarz:</h2>
| + | |
− | <COMMENT_FORM/>
| + | |
− | </pre></dd>
| + | |
− | | + | |
− | ===COMMENT_FORM2 (w starym stylu, oparty na tabeli)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><COMMENT_FORM2/></code> lub <code>&COMMENT_FORM2;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia cały formularz do dodawania komentarzy.</dd
| + | |
− | ><dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <h2>Dodaj swój komentarz:</h2>
| + | |
− | <COMMENT_FORM2/>
| + | |
− | </pre></dd>
| + | |
− | <dt>uwagi</dt>
| + | |
− | <dd>tag wstawia następującą tabelę (zamiast "Sledź ten wątek..." może być button "Przestań sledzić ten wątek"):
| + | |
− | <pre>
| + | |
− | <form action="/comment.php" method="post">
| + | |
− | <div><input type="hidden" name="jid" value="[jid_komentowanego]" />
| + | |
− | <input type="hidden" name="eid" value="[id_wpisu]" />
| + | |
− | <input type="hidden" name="startid" value="0" />
| + | |
− | <input type="hidden" name="op" value="addcomm" /></div>
| + | |
− | | + | |
− | <table>
| + | |
− | <tr>
| + | |
− | <td>Podpis:</td>
| + | |
− | <td><input type="text" name="commnickid"
| + | |
− | <strong>id="commnickid"</strong> value="[Twój_jid]" /></td>
| + | |
− | | + | |
− | </tr>
| + | |
− | <tr>
| + | |
− | <td>Treść:</td>
| + | |
− | <td><textarea name="commbody" <strong>id="commbody"</strong> cols="60" rows="6"></textarea></td>
| + | |
− | | + | |
− | </tr>
| + | |
− | <tr>
| + | |
− | <td>&nbsp;</td>
| + | |
− | <td>
| + | |
− | <input type="checkbox" name="notifyentry" value="notify" />
| + | |
− | | + | |
− | Śledź ten wątek i powiadom mnie o nowych komentarzach
| + | |
− | </td>
| + | |
− | </tr>
| + | |
− | <tr>
| + | |
− | <td>&nbsp;</td>
| + | |
− | <td><input type='submit' name="submit" <strong>id="submitcomm"</strong>
| + | |
− | value='Wyślij' /></td>
| + | |
− |
| + | |
− | </tr>
| + | |
− | </table>
| + | |
− | </form>
| + | |
− | </pre>
| + | |
− | By zastosować style do tego formularza wystarczy użyć ID jego pól. Jak widać pole z podpisem ma <code>id="commnickid"</code>, pole tekstowe z treścią komentarza - <code>id="commbody"</code>, przycisk "Wyślij" - <code>id="submitcomm"</code> a przycisk "Przestań śledzić ten wątek" - <code>id="tracestop"</code></dd>
| + | |
− | </dl>
| + | |
− | | + | |
− | ===COMMENT_FORM_BLOCK (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i zamykający (<code><COMMENT_FORM_BLOCK> ... </COMMENT_FORM_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>w tym bloku umieszczany jest formularz dodawania komentarzy. Należy pamiętać o zachowaniu wszystkich name="" w formularzu.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <div class="komentblok">
| + | |
− | <h3 class="kTyt">Dodaj nowy komentarz:</h3>
| + | |
− | <div class="komentarze"><div class="komklcomment1">
| + | |
− | | + | |
− | <COMMENT_FORM_BLOCK>
| + | |
− | <form action="&COMMENT_FORM_ACTION;" method="post" id="formcomment">
| + | |
− | <fieldset>
| + | |
− | <div class="commrow1">
| + | |
− | <label id="commnicklab" for="commnickid">Podpis:</label>
| + | |
− | <input type="text" name="commnickid" id="commnickid" value="&COMMENT_FORM_NICKID;" />
| + | |
− | </div>
| + | |
− | <div class="commrow2">
| + | |
− | <label id="commbodylab" for="commbody">Treść:</label>
| + | |
− | <textarea name="commbody" id="commbody" cols="60" rows="6"><COMMENT_FORM_BODY/></textarea>
| + | |
− | </div>
| + | |
− | | + | |
− | <COMMENT_FORM_NOTIFY_START_BLOCK>
| + | |
− | <div class="commrow2">
| + | |
− | <input type="checkbox" name="notifystart" id="notifystart" value="notify" checked="checked" />
| + | |
− | <label id="notifylab" for="notifystart">Śledź ten wątek</label>
| + | |
− | </div>
| + | |
− | </COMMENT_FORM_NOTIFY_START_BLOCK>
| + | |
− | | + | |
− | <COMMENT_FORM_NOTIFY_STOP_BLOCK>
| + | |
− | <div class="commrow1">
| + | |
− | <input type="submit" name="notifystop" id="notifystop" value="Przestań śledzić" />
| + | |
− | </div>
| + | |
− | </COMMENT_FORM_NOTIFY_STOP_BLOCK>
| + | |
− | | + | |
− | <COMMENT_FORM_NOUSER_BLOCK>
| + | |
− | <div class="commrow1">
| + | |
− | <label id="commnickurllab" for="commnickurl">Strona WWW:</label>
| + | |
− | <input type="text" name="commnickurl" id="commnickurl" value="&COMMENT_FORM_NICKURL;" />
| + | |
− | </div>
| + | |
− | <div class="commrow2">
| + | |
− | <label id="codelab" for="code">Kod: <img src="&COMMENT_FORM_CODE;" alt="code" /></label>
| + | |
− | <input type="text" name="code" id="code" />
| + | |
− | </div>
| + | |
− | </COMMENT_FORM_NOUSER_BLOCK>
| + | |
− | | + | |
− | <div>
| + | |
− | <input type="submit" name="submit" id="submitcomm" value="Wyślij" />
| + | |
− | </div>
| + | |
− | </fieldset>
| + | |
− | </form>
| + | |
− | | + | |
− | </COMMENT_FORM_BLOCK>
| + | |
− | | + | |
− | <COMMENT_LOGGED_BLOCK>
| + | |
− | <div class="commrow1">
| + | |
− | <label id="commlogged" for="commlogged">Tylko zalogowani użytkownicy mogą komentować</label>
| + | |
− | </div>
| + | |
− | </COMMENT_LOGGED_BLOCK>
| + | |
− | | + | |
− | <COMMENT_NONE_BLOCK>
| + | |
− | <div class="commrow1">
| + | |
− | <label id="commnone" for="commnone">Komentarze zablokowane</label>
| + | |
− | </div>
| + | |
− | </COMMENT_NONE_BLOCK>
| + | |
− | | + | |
− | </div></div>
| + | |
− | </div>
| + | |
− | </pre></dd></dl>
| + | |
− | <dl><dt>uwagi</dt>
| + | |
− | <dd><ol>
| + | |
− | <li>należy zauważyć, że tag <strong>COMMENT_BLOCK</strong> także jest poprawnym tagiem formularza komentarzy, lecz nie pozwala on, na tak elastyczną modyfikację tegoż formularza</li>
| + | |
− | </ol></dd></dl>
| + | |
− | | + | |
− | ===COMMENT_FORM_ACTION (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code>&COMMENT_FORM_ACTION;</code> lub <code><COMMENT_FORM_ACTION/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_FORM_BLOCK</strong> (szablon komentarzy, formularz komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia wartość atrybutu <code>action</code> dla formularza komentarzy</dd>
| + | |
− | | + | |
− | ===COMMENT_FORM_BODY (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code>&COMMENT_FORM_BODY;</code> lub <code><COMMENT_FORM_BODY/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_FORM_BLOCK</strong> (szablon komentarzy, formularz komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>treść komentarza dla formularza komentarzy (umieszczany pomiędzy znacznikami <code><textarea> (...) </textarea></code>)</dd></dl>
| + | |
− | | + | |
− | ===COMMENT_FORM_CODE (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code>&COMMENT_FORM_CODE;</code> lub <code><COMMENT_FORM_CODE/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_FORM_NOUSER_BLOCK</strong> (szablon komentarzy, formularz komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia ścieżkę do grafiki captcha - kodu potrzebnego do wysłania komentarza (widoczne tylko dla użytkowników niezalogowanych)</dd>
| + | |
− | | + | |
− | ===COMMENT_FORM_NICKID (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code>&COMMENT_FORM_NICKID;</code> lub <code><COMMENT_FORM_NICKID/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_FORM_BLOCK</strong> (szablon komentarzy, formularz komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia podpis komentującego (tylko dla użytkowników zalogowanych)</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <COMMENT_FORM_BLOCK>
| + | |
− | (...)
| + | |
− | <input type="text" name="commnickid" id="commnickid" value="&COMMENT_FORM_NICKID;" />
| + | |
− | (...)
| + | |
− | </COMMENT_FORM_BLOCK>
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | ===COMMENT_FORM_NICKURL (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code>&COMMENT_FORM_NICKURL;</code> lub <code><COMMENT_FORM_NICKURL/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>COMMENT_FORM_NOUSER_BLOCK</strong> (szablon komentarzy, formularz komentarzy)</dd>
| + | |
− | <dl><dt>działanie</dt>
| + | |
− | <dd>wstawia URL komentującego (widoczne tylko dla użytkowników niezalogowanych)</dd></dl>
| + | |
− | | + | |
− | ===COMMENT_FORM_NOTIFY_START_BLOCK (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i zamykający (<code><COMMENT_FORM_NOTIFY_START_BLOCK> ... </COMMENT_FORM_NOTIFY_START_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy, formularz komentarzy (blok <strong>COMMENT_FORM_BLOCK</strong>)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>w bloku tym umieszczany jest <code>checkbox</code> pozwalający na śledzenie danego wątku</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | (...)
| + | |
− | <COMMENT_FORM_NOTIFY_START_BLOCK>
| + | |
− | <div class="commrow2">
| + | |
− | <input type="checkbox" name="notifystart" id="notifystart" value="notify" checked="checked" />
| + | |
− | <label id="notifylab" for="notifystart">Śledź ten wątek</label>
| + | |
− | </div>
| + | |
− | </COMMENT_FORM_NOTIFY_START_BLOCK>
| + | |
− | (...)
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | ===COMMENT_FORM_NOTIFY_STOP_BLOCK (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i zamykający (<code><COMMENT_FORM_NOTIFY_STOP_BLOCK> ... </COMMENT_FORM_NOTIFY_STOP_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy, formularz komentarzy (blok <strong>COMMENT_FORM_BLOCK</strong>)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>w bloku tym umieszczany jest <code>input</code> pozwalający na zakończenie śledzenia danego wątku</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | (...)
| + | |
− | <COMMENT_FORM_NOTIFY_START_BLOCK>
| + | |
− | <div class="commrow1">
| + | |
− | <input type="submit" name="notifystop" id="notifystop" value="Przestań śledzić" />
| + | |
− | </div>
| + | |
− | </COMMENT_FORM_NOTIFY_START_BLOCK>
| + | |
− | (...)
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | ===COMMENT_FORM_NOUSER_BLOCK (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i zamykający (<code><COMMENT_FORM_NOUSER_BLOCK> ... </COMMENT_FORM_NOUSER_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy, formularz komentarzy (blok <strong>COMMENT_FORM_BLOCK</strong>)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>w bloku tym umieszczana jest część formularza komentarzy widoczna tylko dla niezalogowanych użytkowników</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | (...)
| + | |
− | <COMMENT_FORM_NOUSER_BLOCK>
| + | |
− | <div class="commrow1">
| + | |
− | <label id="commnickurllab" for="commnickurl">Podpis:</label>
| + | |
− | <input type="text" name="commnickurl" id="commnickurl" value="&COMMENT_FORM_NICKURL;" />
| + | |
− | </div>
| + | |
− | <div class="commrow2">
| + | |
− | <label id="codelab" for="code">Kod: <img src="&COMMENT_FORM_CODE;" alt="code" /></label>
| + | |
− | <input type="text" name="code" id="code" />
| + | |
− | </div>
| + | |
− | </COMMENT_FORM_NOUSER_BLOCK>
| + | |
− | (...)
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | ===COMMENT_LOGGED_BLOCK (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i zamykający (<code><COMMENT_LOGGED_BLOCK> ... </COMMENT_LOGGED_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>w bloku tym umieszczana oglądający jest informoany o tym, że komentarze są dostępne tylko po zalogowaniu się</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | (...)
| + | |
− | <COMMENT_LOGGED_BLOCK>
| + | |
− | <div class="commrow1">
| + | |
− | <label id="commlogged" for="commlogged">Tylko zalogowani użytkownicy mogą komentować</label>
| + | |
− | </div>
| + | |
− | </COMMENT_LOGGED_BLOCK>
| + | |
− | (...)
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | ===COMMENT_NONE_BLOCK (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i zamykający (<code><COMMENT_NONE_BLOCK> ... </COMMENT_NONE_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>w bloku tym umieszczana jest informacja, że komentarze zostały zablokowane</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | (...)
| + | |
− | <COMMENT_NONE_BLOCK>
| + | |
− | <div class="commrow1">
| + | |
− | <label id="commnone" for="commnone">Komentarze zablokowane</label>
| + | |
− | </div>
| + | |
− | </COMMENT_NONE_BLOCK>
| + | |
− | (...)
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | | + | |
− | ----
| + | |
− | | + | |
− | ==Admin (ADMIN)==
| + | |
− | ===ADMIN_BLOCK===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i tag zamykający (<code><ADMIN_BLOCK> ... </ADMIN_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>blok powoduje pokazanie zawartej w nim treści jedynie zalogowanemu (na [http://jogger.pl stronie głównej Joggera]) właścicielowi. Można w nim umieścić wszystko, jednak 4 specjalne tagi nadają się do tego lepiej niż cokolwiek innego.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd>w bloku <strong>ENTRY_BLOCK</strong>:
| + | |
− | <pre>
| + | |
− | <ENTRY_BLOCKY>
| + | |
− | (...)
| + | |
− | <ADMIN_BLOCK>
| + | |
− | <span>
| + | |
− | <a href="&ADMIN_ENTRY_EDIT_HREF;">Edytuj</a>,
| + | |
− | <a href="&ADMIN_ENTRY_REMOVE_HREF;">Usuń</a>.
| + | |
− | </span>
| + | |
− | </ADMIN_BLOCK>
| + | |
− | (...)
| + | |
− | </ENTRY_BLOCK>
| + | |
− | </pre>
| + | |
− | w bloku <strong>COMMENT_BLOCK</strong>:
| + | |
− | <pre>
| + | |
− | <COMMENT_BLOCK>
| + | |
− | (...)
| + | |
− | <ADMIN_BLOCK>
| + | |
− | <span>
| + | |
− | <a href="&ADMIN_COMMENT_REMOVE_HREF;">Usuń</a>,
| + | |
− | <a href="&ADMIN_COMMENT_BLOCKIP_HREF;">Zablokuj IP</a>.
| + | |
− | </span>
| + | |
− | </ADMIN_BLOCK>
| + | |
− | (...)
| + | |
− | </COMMENT_BLOCK>
| + | |
− | </pre>
| + | |
− | można też tak:
| + | |
− | <pre>
| + | |
− | <ADMIN_BLOCK>
| + | |
− | <p>Tego akapitu nie zobaczy nikt poza mną.</p>
| + | |
− | </ADMIN_BLOCK>
| + | |
− | </pre></dd>
| + | |
− | <dt>uwagi</dt>
| + | |
− | <dd>4 tagi zaczynające się od "<strong>ADMIN_</strong>" nie muszą być umieszczone w bloku <strong>ADMIN_BLOCK</strong>. Jednak wtedy zwykli użytkownicy odwiedzający joga zobaczą opisy
| + | |
− | adminowych odnośników. Niczym to nie grozi, bo bez hasła i tak nic nie popsują, chodzi tylko o wygląd strony.<br /><br />
| + | |
− | </dd></dl>
| + | |
− | | + | |
− | ===ADMIN_ENTRY_EDIT_HREF===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><ADMIN_ENTRY_EDIT_HREF/></code> lub <code>&ADMIN_ENTRY_EDIT_HREF;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>ADMIN_BLOCK</strong> (szablon strony głównej (wtedy w bloku <strong>ENTRIES_DAY</strong>) i szablon komentarzy (wtedy gdziekolwiek, bo odnosi się do komentowanego wpisu))</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia URL do strony edycji danego wpisu.</dd></dl>
| + | |
− | | + | |
− | ===ADMIN_ENTRY_REMOVE_HREF===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><ADMIN_ENTRY_REMOVE_HREF/></code> lub <code>&ADMIN_ENTRY_REMOVE_HREF;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>ADMIN_BLOCK</strong> (szablon strony głównej (wtedy w bloku <strong>ENTRIES_DAY</strong>) i szablon komentarzy (wtedy gdziekolwiek, bo odnosi się do komentowanego wpisu))</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia URL do strony z pytaniem o potwierdzenie usunięcia danego wpisu.</dd></dl>
| + | |
− | | + | |
− | ===ADMIN_COMMENT_REMOVE_HREF===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><ADMIN_COMMENT_REMOVE_HREF/></code> lub <code>&ADMIN_COMMENT_REMOVE_HREF;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>ADMIN_BLOCK</strong> w bloku <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia URL do odnośnika powodującego usunięcie danego komentarza (bez potwierdzania).</dd></dl>
| + | |
− | | + | |
− | ===ADMIN_COMMENT_BLOCKIP_HREF===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><ADMIN_COMMENT_BLOCKIP_HREF/></code> lub <code>&ADMIN_COMMENT_BLOCKIP_HREF;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>ADMIN_BLOCK</strong> w bloku <strong>COMMENT_BLOCK</strong> (szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia URL do odnośnika powodującego zablokowanie IP osoby komentującej.</dd></dl>
| + | |
− | | + | |
− | | + | |
− | ----
| + | |
− | | + | |
− | | + | |
− | ==Niezalogowany użytkownik (NOUSER)==
| + | |
− | ===NOUSER_BLOCK===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i tag zamykający (<code><NOUSER_BLOCK> ... </NOUSER_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>Wszystko umieszczone w tym bloku będzie widoczne jedynie dla niezalogowanych
| + | |
− | użytkowników, np. zwykłych gości. Można tu wstawić link do strony logowania lub od razu odpowiedni formularz (dzięki dla [http://krysk.jogger.pl kryska]).</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | Dla znajomych
| + | |
− | <NOUSER_BLOCK>
| + | |
− | <p><a href="&USER_LOG_IN_HREF;">Zaloguj się</a>, by przeczytać inne wpisy.</p>
| + | |
− | </NOUSER_BLOCK>
| + | |
− | <LOGGED_USER_BLOCK>
| + | |
− | ( ... )
| + | |
− | </LOGGED_USER_BLOCK>
| + | |
− | </pre></dd>
| + | |
− | <dt>uwagi</dt>
| + | |
− | <dd>patrz: formularz logowania</dd></dl>
| + | |
− | | + | |
− | ===USER_LOG_IN_HREF===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><USER_LOG_IN_HREF/></code> lub <code>&USER_LOG_IN_HREF;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>np. blok <strong>NOUSER_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia URL odnośnika do strony logowania [http://login.staszyna.jogger.pl http://login.staszyna.jogger.pl]). Takiego linka można np. użyć dyskretnie, by nie tylko ukryć niektóre wpisy, ale także samą informację o ukrywaniu czegokolwiek.</dd></dl>
| + | |
− | | + | |
− | ===USER_LOG_IN_ACTION (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis <code>&USER_LOG_IN_ACTION;</code> lub <code><USER_LOG_IN_ACTION/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>NOUSER_BLOCK</strong> (szablon strony logowania)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia wartość atrybutu <code>action</code> dla formularza logowania</dd></dl>
| + | |
− | | + | |
− | ===FORMULARZ===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>formularz przygotowany przez [http://krysk.jogger.pl kryska], z moimi niewielkimi modyfikacjami</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>np. blok <strong>NOUSER_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>formularz od razu przekazuje Joggerowi dane o nazwie użytkownika i haśle, bez pośrednictwa wyżej wspomnianej strony.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd>
| + | |
− | <pre>Dla znajomych:<br />
| + | |
− | <NOUSER_BLOCK>
| + | |
− | <form action="&USER_LOG_IN_ACTION;"
| + | |
− | method="post" id="logowanie">
| + | |
− | <div><input type="hidden" name="op" value="loginuser" /></div>
| + | |
− | <div><span>Login:</span><input type="text" name="user" /></div>
| + | |
− |
| + | |
− | <div><span>Hasło:</span><input type="password" name="pass" /></div>
| + | |
− | <div><input type="submit" value="Zaloguj" id="guzik" /></div>
| + | |
− | </form>
| + | |
− | </NOUSER_BLOCK>
| + | |
− | </pre></dd>
| + | |
− | <dt>uwagi</dt>
| + | |
− | <dd>by to ładniej wyglądało, można w CSS dodać np.:
| + | |
− | <pre>
| + | |
− | /* logowanie */
| + | |
− | form#logowanie span {
| + | |
− | width: 4em;
| + | |
− | float: left;
| + | |
− | }
| + | |
− | form#logowanie div {
| + | |
− | margin-bottom: 3px;
| + | |
− | }
| + | |
− | form#logowanie input {
| + | |
− | width: 8em;
| + | |
− | padding-left: 3px;
| + | |
− | }
| + | |
− | form#logowanie input#guzik {
| + | |
− | width: auto;
| + | |
− | padding: 3px 5px;
| + | |
− | margin-top: 5px;
| + | |
− | margin-left: 4em; /* tyle samo, ile width w span wyżej */
| + | |
− | font-family: sans-serif;
| + | |
− | }</pre></dd></dl>
| + | |
− | | + | |
− | | + | |
− | ----
| + | |
− | | + | |
− | ==Zalogowany użytkownik (LOGGED_USER)==
| + | |
− | ===LOGGED_USER_BLOCK===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i tag zamykający (<code><LOGGED_USER_BLOCK> ... </LOGGED_USER_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>treść zawarta w tym bloku będzie widoczna tylko i wyłącznie dla zalogowanych gości joga.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd>
| + | |
− | <pre>Dla znajomych:
| + | |
− | <NOUSER_BLOCK>
| + | |
− | ( ... )
| + | |
− | </NOUSER_BLOCK>
| + | |
− | | + | |
− | <LOGGED_USER_BLOCK>
| + | |
− | <p><LOGGED_USER_NAME/>, <a href="&LOGGED_USER_LOG_OUT_HREF;"><em>wyloguj
| + | |
− | się</em></a>, gdy będziesz wychodzić.
| + | |
− | </p>
| + | |
− | </LOGGED_USER_BLOCK>
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | ===LOGGED_USER_NAME===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><LOGGED_USER_NAME/></code> lub <code>&LOGGED_USER_NAME;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>LOGGED_USER_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia nazwę zalogowanego użytkownika.</dd></dl>
| + | |
− | | + | |
− | ===LOGGED_USER_LOG_OUT_HREF===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><LOGGED_USER_LOG_OUT_HREF/></code> lub <code>&LOGGED_USER_LOG_OUT_HREF;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>blok <strong>LOGGED_USER_BLOCK</strong> (szablon strony głównej i szablon komentarzy)</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia URL do odnośnika wylogowującego zalogowanego użytkownika. Warto sprawić, by użytkownik rzeczywiście kliknął w ten link, gdy będzie odchodził np. od komputera w kawiarence internetowej.</dd></dl>
| + | |
− | | + | |
− | | + | |
− | ----
| + | |
− | | + | |
− | | + | |
− | ==status i opis Jabbera==
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>grupa znaczników służących do wyświetlania tekstu dostępności (np. dostępny/rozłączony), ikony dostępności oraz
| + | |
− | Jabberowego opisu.</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy, nie wymagają żadnego specjalnego bloku</dd>
| + | |
− | <dt>znaczniki</dt>
| + | |
− | <dd><strong>STATUS_TEXT</strong>, <strong>STATUS_IMAGE</strong>, ><strong>STATUS_DESCR</strong> oraz <strong>STATUS_DESCR2</strong>.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <ul>
| + | |
− | <li>mój status: <strong><STATUS_TEXT/></strong> <img src="&STATUS_IMAGE;" alt="" /></li>
| + | |
− | <li>mój opis: <em><STATUS_DESCR/></em></li>
| + | |
− | </ul>
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | ===STATUS_TEXT===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><STATUS_TEXT/></code> lub <code>&STATUS_TEXT;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia teskt dostępności lub niedostępności. Oba należy ustawić w panelu konfiguracyjnym, w zakładce <em>Ustawienia</em> (<em>Tekst dostępności</em> i <em>Tekst niedostępności</em>), np. dostępny/rozłączony, online/offline, jestem/nie ma mnie itd.</dd></dl>
| + | |
− | | + | |
− | ===STATUS_IMAGE===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><STATUS_IMAGE/></code> lub <code>&STATUS_IMAGE;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia ścieżkę do pliku-ikony dostepności. Należy najpierw utworzyć i wgrać do Joggera dwa takie pliki: <strong>online.png</strong> i <strong>offline.png</strong>. W zależności od statusu właściciela joga, Jogger wstawi ścieżkę do odpowiedniego pliku.</dd>
| + | |
− | <dt>uwagi</dt>
| + | |
− | <dd>znacznik wstawia pełną ścieżkę, a nie tylko nazwę pliku.</dd></dl>
| + | |
− | | + | |
− | ===STATUS_DESCR===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><STATUS_DESCR/></code> lub <code>&STATUS_DESCR;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia Jabberowy opis.</dd>
| + | |
− | </dl>
| + | |
− | | + | |
− | ===STATUS_DESCR2===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><STATUS_DESCR2/></code> lub <code>&STATUS_DESCR2;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>podobnie jak <strong>STATUS_DESCR</strong> wstawia opis na Jabberze, tyle tylko, że ujęty w cudzysłowy. Jeśli opisu nie ma, cudzysłowy nie zostaną wyświetlone.</dd></dl>
| + | |
− | | + | |
− | | + | |
− | ----
| + | |
− | | + | |
− | ==Inne==
| + | |
− | ===JID===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><JID/></code> lub <code>&JID;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia JID (Jabber ID) właściciela joga.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <acronym lang="en" xml:lang="en" title="Jabber Identifier">JID</acronym>: <JID/>
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | ===JOG (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><JOG/></code> lub <code>&JOG;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia nazwe konta (login/nick itp).</dd>
| + | |
− | </dl>
| + | |
− | | + | |
− | ===HOME (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><HOME/></code> lub <code>&HOME;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia adres joggera: "http://_nazwa_konta_.jogger.pl".</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <a href="&HOME;" title="Strona główna.">Strona Główna</a>
| + | |
− | </pre></dd>
| + | |
− | </dl>
| + | |
− | | + | |
− | ===RSS (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><RSS/></code> lub <code>&RSS;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia link kanału informacyjnego joga.</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <a href="&RSS;" title="Kanał informacyjny.">RSS</a>
| + | |
− | </pre></dd>
| + | |
− | <dt>uwagi</dt>
| + | |
− | <dd>aby uzyskać linki do wpisów z treścią, html i skróconym należy dopisać po znaczniku poniższe parametry:
| + | |
− | <pre>ilosc_wpisow/
| + | |
− | content/ilosc_wpisow/
| + | |
− | short/ilosc_wpisow/
| + | |
− | content/html/ilosc_wpisow/
| + | |
− | short/html/ilosc_wpisow/</pre></dd></dl>
| + | |
− | | + | |
− | ===ALL_ENTRIES_HREF===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis: <code><ALL_ENTRIES_HREF/></code> lub <code>&ALL_ENTRIES_HREF;</code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia link prowadzący do strony głównej z odpowiednimi wpisami (tzn. jeśli ktoś czyta komentarze do wpisu ze stycznia, to ten link przeniesie go do strony z wpisami ze stycznia).</dd>
| + | |
− | <dt>przykład</dt>
| + | |
− | <dd><pre>
| + | |
− | <a href="&ALL_ENTRIES_HREF;" title="Powrót do reszty wpisów">Wróć</a>
| + | |
− | </pre></dd></dl>
| + | |
− | | + | |
− | ===HEADER (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis <code>&HEADER;</code> lub <code><HEADER/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia następujący kod do szablonu (stosowany w szablonach uproszczonych):
| + | |
− | <pre>
| + | |
− | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
| + | |
− | <html lang="pl">
| + | |
− | <head>
| + | |
− | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
| + | |
− | <meta name="robots" content="noindex, nofollow">
| + | |
− | <title>Jogger :: [Twój JID]</title>
| + | |
− | <link rel="StyleSheet" href="/files/style.css" type="text/css">
| + | |
− | </head>
| + | |
− | <body>
| + | |
− | </pre>
| + | |
− | </dd>
| + | |
− | <dt>uwagi</dt>
| + | |
− | <dd><ol>
| + | |
− | <li>działa w połączeniu ze znacznikiem <strong>FOOTER</strong> (może także występować sam w szablonie)</li>
| + | |
− | <li>podczas tworzenia szablonu należy wgrać na serwer plik styli CSS o następującej nazwie <code>style.css</code></li>
| + | |
− | </ol></dd></dl>
| + | |
− | | + | |
− | ===FOOTER (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>pojedynczy, zapis <code>&FOOTER;</code> lub <code><FOOTER/></code></dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>wstawia następujący kod do szablonu (stosowany w szablonach uproszczonych):
| + | |
− | <pre>
| + | |
− | </body>
| + | |
− | </html>
| + | |
− | </pre>
| + | |
− | </dd></dl>
| + | |
− | | + | |
− | ===JOGGER_USER_BLOCK (NOWY)===
| + | |
− | <dl><dt>typ</dt>
| + | |
− | <dd>wymagany tag otwierający i tag zamykający (<code><JOGGER_USER_BLOCK> ... </JOGGER_USER_BLOCK></code>)</dd>
| + | |
− | <dt>stosowanie</dt>
| + | |
− | <dd>szablon strony głównej i szablon komentarzy</dd>
| + | |
− | <dt>działanie</dt>
| + | |
− | <dd>w tym bloku informacje są wyświetlane tylko dla zarejestrowanych użytkowników joggera</dl>
| + | |
− | | + | |
− | | + | |
− | ----
| + | |
− | | + | |
− | | + | |
− | ==Lista pozostałych tagów==
| + | |
− | Należy je opisać i dodać wyżej, kasując tutaj.
| + | |
− | | + | |
− | *'''ENTRY_CATEGORY_NOT_LAST''' (jakies szuru buru z w/w -> http://bugger.jogger.pl/?do=details&id=163)
| + | |
− | *'''ARCHIVE_NOT_LAST''' (http://joggerpl2.jogger.pl/2006/03/16/zgloszenie-176/)
| + | |
− | *'''CATEGORY_NOT_LAST''' (j/w)
| + | |
− | | + | |
− | | + | |
− | ----
| + | |
− | <small>Do opisu tagów, które pozostały z Joggera 1.0 wykorzstano materiał [http://staszyna.jogger.pl/ Staszyny]</small>
| + | |