Szablony
Spis treści
Wytyczne dla twórców szablonów
WORK IN PROGRESS
Szablon dostępny publicznie musi być odporny na większość zmian przeprowadzanych przez początkującego bloggera z poziomu panelu. Musi być także kompletny oraz przetestowany w naturalnych warunkach (np: podgląd komentarza, zablokowanie komentarzy)
Elementy obowiązkowe
Podstawowy szablon musi mieć następujące części:
- Wpisy
- Przeglądanie stron wpisów (kategorii, archiwum)
- Komentarze
- Formularz dodawania komentarza
- Podgląd komentarza
- Link do logowania / wylogowania
- Adres trackback
- RSS wpisów i komentarzy
- Lista stron
- Lista grup linków
W przypadku RSS dopuszczalne jest skorzystanie z konstrukcji <link/> w części <head></head> dokumentu.
Wpisy
Wymagane tagi:
-
<ENTRY_SUBJECT> -
<ENTRY_CONTENT_SHORT/> -
<ENTRY_CONTENT_SHORT_EXIST> -
<ENTRY_CONTENT_LONG/>(strona komentarzy) -
<ENTRY_COMMENT_HREF/>
Należy zakładać, że blogger może chcieć skrócić wpis za pomocą taga <EXCERPT>, dlatego wymagane jest korzystanie na stronie wpisów z tagów <ENTRY_CONTENT_SHORT/> i <ENTRY_CONTENT_SHORT_EXIST></ENTRY_CONTENT_SHORT_EXIST> wraz z linkiem do dalszej części wpisu. Na stronie komentarzy należy skorzystać z <ENTRY_CONTENT_SHORT/> i <ENTRY_CONTENT_LONG/> otoczonego elementem z (na przykład) id="more", aby link kierował od razu do dalszej części, a nie początku wpisu.
Przeglądanie stron wpisów
Wymagane tagi:
-
<PAGE_BLOCK_EXIST> -
<PAGE_PREV_EXIST>-
&PAGE_PREV_HREF;
-
-
<PAGE_NEXT_EXIST>-
&PAGE_NEXT_HREF;
-
Komentarze
Wymagane tagi:
- COMMENT_BLOCK_EXIST
- COMMENT_BLOCK
- COMMENT_NICK/
- COMMENT_CONTENT/
- COMMENT_EDIT_EXIST
- &COMMENT_EDIT_HREF;
- COMMENT_ALLOWED_BLOCK
- COMMENT_NONE_BLOCK
- COMMENT_LOGGED_BLOCK
Należy pamiętać o 3 ostatnich tagach określających czy komentowanie zostało zablokowane. W przypadku monitu o login, powinno się podać adres http://login.jogger.pl/login/ jako że chodzi o logowanie joggerowców (poziom 2 wpisu), a nie użytkowników tego jednego bloga.
Pierwszy tag stosuje się, aby stwierdzić czy już jakieś komentarze się pojawiły (szablon nie przejdzie walidacji, jeśli będzie pusty <ol> gdzie zwykle umieszcza się komentarze).
Wymagany jest także link edycji komentarza, aby nie dokładać problemów komentującemu.
Standardowe tagi:
- &COMMENT_ID;
- COMMENT_DATE
- COMMENT_HOUR
- ADMIN_BLOCK
- &ADMIN_COMMENT_EDIT_HREF;
- &ADMIN_COMMENT_BLOCKIP_HREF;
- &ADMIN_COMMENT_REMOVE_HREF;
Warto podać (i prawie zawsze jest na to miejsce) czas dodania komentarza oraz linki administracyjne. Przydaje się też permalink do komentarza – można podlinkować w tym przypadku timestamp.
Formularz dodawania komentarza
Wszystkie tagi są obowiązkowe. Należy pamiętać, że istnieją 3 stany formularza:
- Admin – widzi 2 pola (treść, podpis)
- Joggerowiec – widzi 3 pola (treść, podpis, śledzenie wątku (checkbox włącz / submit wyłącz)
- Gość - widzi cztery pola (treść, podpis, strona www, kod catpcha)
Podgląd komentarza
Logowanie
Adres trackback
RSS
Lista stron
Lista grup linków
Elementy standardowe
Poniższe elementy mogą być pominięte, jeśli układ / design szablonu nie pozwala bądź znacznie utrudnia dodanie takich elementów. Brak w/w nie uniemożliwia korzystania z bloga, aczkolwiek nie zaleca się usuwania na raz listy archiwum i kategorii.
- Tytuł bloga
- Miniblog
- Tagi wpisu
- Przeglądanie wpisów pojedynczo (poprzedni, następny)
- Lista archiwum
- Lista kategorii
Część z elementów pozycji wyświetlana jest tylko wtedy, gdy istnieją dane mogące je wypełnić – to blogger decyduje których opcji chce użyć (np.: lista stron, linki…), więc nie ma powodu do obaw o przeładowanie szablonu.
W przypadku minibloga, specjalnie oddzielona lista wpisów jest bardzo mile widziana i jeśli tylko da się ją umieścić w sidebarze bloga, powinno się tak robić.
