Jak wspomniano w artykule Tagi widżetów dla układów bloga, istnieje wiele różnych tagów, których możesz użyć, by umieścić w szablonie określone elementy danych. Wszystkie one mają format <data:nazwa/> lub <data:nazwa1.nazwa2/>, gdzie nazwa to nazwa elementu danych, którego chcesz użyć. W przykładowym ciągu nazwa1.nazwa2 element nazwa2 to element danych znajdujący się w zbiorze danych nazwa1, na przykład photo.url.
To jest centralna lista wszystkich dostępnych danych. Ponieważ różne typy widżetów używają różnych danych, lista jest podzielona na sekcje odpowiadające elementom strony.
Dane dostępne globalnie
Te dane dotyczą całej strony, więc możesz z nich korzystać w dowolnym miejscu (w przeciwieństwie do innych danych, których można użyć tylko z konkretnym widżetem). Należy odwoływać się do nich jako do części ogólnego zbioru danych „blog”, na przykład <data:blog.title/> itd.
- title: tytuł bloga.
- pageType: typ bieżącej strony. Jedna z wartości „item”, „archive” lub „index”.
- url: adres URL bieżącej strony.
- homepageUrl: strona główna bloga.
- pageTitle: tytuł bieżącej strony. Często jest to tytuł bloga, ale na stronach archiwum lub postów może zawierać dodatkowe informacje.
- encoding: kodowanie używane na blogu, np. UTF-8.
- languageDirection: kierunek pisowni – „ltr” dla języków z pisownią od lewej do prawej lub „rtl” dla języków z pisownią od prawej do lewej.
- feedLinks: linki do kanałów autoodkrywania w nagłówku strony.
Nagłówek strony
Jest to prosty widżet z dwoma elementami danych. Odwołania do nich wyglądają tak: <data:title/> i <data:description/>.
- title: tytuł bloga.
- description: opis bloga.
Posty na blogu
Jest to centralna i najbardziej złożona część każdego bloga. Zastanów się, czy nie lepiej zmodyfikować 1 z domyślnych szablonów, zamiast tworzyć od podstaw widżet postów na blogu. Niezależnie od tego, co wybierzesz, tutaj znajdziesz informacje o wszystkich danych dostępnych w tym widżecie.
- feedLinks: lista kanałów danej strony. Na stronie głównej są to główne kanały bloga. Na stronach elementów są to również kanały komentarzy. Każdy element z tej listy ma te atrybuty:
- url: adres URL kanału.
- name: nazwa kanału (np. „Posty” lub „Komentarze”).
- feedType: typ kanału (Atom lub RSS).
- mimeType: typ MIME kanału.
- olderPageUrl: adres URL strony z postami starszymi niż te na bieżącej stronie, jeśli takie istnieją. Jest on zależny od danego typu strony – nie wszystkie strony go zawierają.
- olderPageTitle: tytuł linku do strony ze starszymi postami.
- newerPageUrl: odpowiednik olderPageUrl dla strony z nowszymi postami.
- newerPageTitle: odpowiednik olderPageTitle dla strony z nowszymi postami.
- commentLabel: określenie używane przy wyświetlaniu liczby komentarzy, np. „komentarze”.
- authorLabel: określenie używane przy wskazywaniu autora posta, np. „Autor:”.
- timestampLabel: określenie używane przy wskazywaniu, kiedy post został napisany, np. „Opublikowano o”.
- postLabelsLabel: określenie poprzedzające listę etykiet posta, np. „Etykiety tego posta:”.
- backlinksLabel: określenie używane do opisywania linków przychodzących dla tego posta, na przykład „Linki do tego posta”.
- posts: lista wszystkich postów na tej stronie. Każdy post ma te atrybuty:
- dateHeader: data aktualnego posta widoczna tylko wtedy, gdy jest to pierwszy post na liście opublikowany danego dnia.
- id: liczbowy identyfikator posta.
- title: tytuł posta.
- body: treść posta.
- author: wyświetlana nazwa autora posta.
- url: link bezpośredni do tego posta.
- timestamp: sygnatura czasowa posta. W odróżnieniu od dateHeader ten atrybut istnieje dla wszystkich postów.
- labels: lista etykiet posta. Każda etykieta ma te atrybuty:
- name: tekst etykiety.
- url: adres URL strony z listą wszystkich postów na blogu mających tę etykietę.
- isLast: wartość True (prawda) lub False (fałsz). Określa, czy ta etykieta jest ostatnia na liście (przydatne przy dodawaniu przecinków).
- allowComments: True (prawda) oznacza, że komentowanie tego posta jest dozwolone.
- numComments: liczba komentarzy do tego posta.
- showBacklinks: określa, czy wyświetlać linki przychodzące dla tego posta.
- numBacklinks: liczba linków przychodzących dla tego posta.
- addCommentUrl: adres URL formularza „dodaj komentarz” dla tego posta.
- emailPostUrl: adres URL formularza „Wyślij post pocztą e-mail” dla tego posta.
- editUrl: adres URL formularza edycji dla tego posta.
- feedLinks: lista kanałów związanych z tym postem. (Element ten różni się od ogólnego elementu feedLinks bloga tym, że może zawierać na przykład kanał komentarzy do posta). Każdy element ma te atrybuty:
- url: adres URL kanału.
- name: nazwa kanału (np. „Posty” lub „Komentarze”).
- feedType: typ kanału (Atom lub RSS).
- mimeType: typ MIME kanału.
- comments: lista wszystkich komentarzy do tego posta (tylko na stronach elementów). Każdy element ma te atrybuty:
- id: liczbowy identyfikator komentarza.
- body: treść komentarza.
- timestamp: czas utworzenia komentarza.
- author: wyświetlana nazwa autora komentarza lub „Anonimowy”.
- authorUrl: adres URL profilu autora komentarza, o ile nie jest on anonimowy.
- deleteUrl: adres URL służący do usuwania komentarza.
- isDeleted: określa, czy ten komentarz został usunięty. (Tekst usuniętych komentarzy jest zastępowany obiektem zastępczym).
Archiwum bloga
Podane tu różne style mają zastosowanie do różnych opcji domyślnych na karcie Elementy strony. Jeśli tworzysz nową wersję, możesz wybrać styl „FLAT” i wprowadzić odpowiednie zmiany w pozostałych danych. W ten sposób ułatwisz sobie pracę.
- title: tytuł widżetu.
- style: 1 z opcji „MENU”, „FLAT” lub „HIERARCHY”.
- data: lista poszczególnych jednostek archiwum, z których każda ma atrybuty:
- name: nazwa zakresu tego archiwum, na przykład „Sierpień 2006”.
- url: link do strony z postami z danego zakresu.
- post-count: liczba postów w danym zakresie.
Widżet profilu
Widżet profilu bloga z 1 autorem zawiera te informacje. Pamiętaj, że aby uzyskać dostęp do różnych elementów zbioru danych photo, musisz używać notacji takiej jak <data:photo.url/>.
- title: tytuł widżetu.
- userUrl: adres URL profilu autora.
- location: lokalizacja z profilu autora.
- aboutme: informacje „O mnie” z profilu.
- displayname: wyświetlana nazwa autora.
- photo: zdjęcie profilowe użytkownika – ma te atrybuty:
- url: adres URL zdjęcia.
- width: szerokość zdjęcia w pikselach.
- height: wysokość zdjęcia w pikselach.
- alt: tekst alternatywny zdjęcia.
Widżet profilu blogów zespołowych zawiera mniej informacji o autorach:
- title: tytuł widżetu.
- authors: lista wszystkich autorów, z których każdy ma te atrybuty:
- displayname: wyświetlana nazwa autora.
- userURL: adres URL profilu autora.
Jeśli chcesz wykorzystywać szablon na blogach zarówno z 1 autorem, jak i z wieloma autorami, użyj zmiennej data:team, aby odróżnić te 2 przypadki. Na przykład <b:if cond='data:team=="true"'> (wyświetlaj wielu autorów) </b:if>
Widżet tekstowy/HTML/JavaScript
Widżet tekstowy i widżet HTML/JavaScript działają w ten sam sposób i zawierają te same 2 elementy danych.
- title: tytuł widżetu.
- content: zawartość widżetu.
Widżet kanału
Zawartość widżetu kanału jest ładowana dynamicznie za pomocą interfejsu Google AJAX API po wyrenderowaniu bloga w przeglądarce. Styl widżetu można określać tylko za pomocą CSS.
- title: tytuł widżetu.
- feedUrl: adres URL kanału.
Widżet obrazu
Widżet obrazu zawiera pojedynczy obraz i wszystkie niezbędne dane na jego temat.
- title: tytuł widżetu.
- sourceUrl: adres URL obrazu.
- width: szerokość obrazu w pikselach.
- height: wysokość obrazu w pikselach.
- caption: podpis obrazu.
Widżet etykiet
Widżet etykiet zawiera listę wszystkich etykiet używanych na blogu.
- title: tytuł widżetu.
- labels: lista etykiet, z których każda ma te atrybuty:
- name: tekst etykiety.
- count: ile postów ma tę etykietę.
- url: link do strony zawierającej posty z tą etykietą.
Widżet listy
Najprostsza postać listy. Każdy element to pojedynczy fragment tekstu niezawierający innych typów danych.
- title: tytuł widżetu.
- items: lista elementów.
Widżet listy linków
Nieco bardziej wyrafinowana lista, na której każdy element ma dwie części: tekst i link.
- title: tytuł widżetu.
- links: lista linków, z których każdy ma te atrybuty:
- name: tekst linku.
- target: adres URL linku.
Widżet logo
Prościej być nie może. Tylko 1 element danych.
- fullButton: adres URL wybranego przycisku Bloggera.