Теги доступа к данным в шаблонах Blogger

Как было упомянуто в статье "Теги виджетов в шаблонах Blogger", существует множество тегов, которые Вы можете использовать для включения в шаблон элементов данных блога. Эти теги имеют формат вида <data:name/> или <data:name1.name2/>, где name есть имя определенного элемента данных, который вы собираетесь использовать. В примере с name1.name2, name2 является свойством набора данных name1, например, photo.url.

Полный список доступных тегов данных приведен ниже. Для удобства он разбит по разделам, так как различные типы виджетов имеют различные типы данных.

• Данные, доступные глобально
• Заголовок страницы
• Сообщения блога
• Архив блога
• Профиль
• Текст / HTML / JavaScript
• Канал
• Картинка
• Ярлыки
• Список
• Список ссылок
• Логотип

Данные, доступные глобально

В отличие от данных, доступных для использования только в определенных виджетах, глобальные данные доступны в любом месте шаблона. На них следует ссылаться как на свойства глобального элемента данных blog, например, <data:blog.title/> и т. д.

• title: Заголовок блога.
• pageType: Тип текущей страницы. Может иметь одно из следующих значений: 'item' (сообщение), 'archive' (архив) или 'index' (индекс).
• url: URL адрес текущей страницы.
• homepageUrl: URL адрес главной страницы блога.
• pageTitle: Заголовок текущей страницы. Заголовок текущей страницы может быть просто заголовком блога, но может содержать также дополнительную информацию на страницах архивов и сообщений.
• encoding: Кодировка блога, например, UTF-8.
• languageDirection: Направление языка. Может содержать значения значения ltr (слева направо) или rtl (справа на лево).
• feedLinks: Ссылки глобальных каналов (фидов).

Вверх

Заголовок страницы

Это довольно простой виджет, содержащий всего два свойства. На них можно ссылаться следующим образом: <data:title/> и <data:description/>.

• title: Заголовок блога.
• description: Описание блога.

Вверх

Сообщения блога

Это центральная часть любого блога и при этом наиболее сложная часть. Написать всю начинку виджета «Сообщения блога» с нуля - непростая задача. Гораздо продуктивнее будет просто внести изменения в один из стандартных шаблонов Blogger. Однако, если у Вас все же есть желание поработать с кодом самостоятельно, перечень данных, доступных в этом виджете, приводится ниже.

• feedLinks: Список каналов (фидов) данной страницы. На главной странице этот список будет содержать главные каналы блога; на страницах сообщений в нем также будут присутствовать каналы комментариев. У каждого элемента списка есть следующие свойства:
• url: Адрес URL канала.
• name: Имя канала (например, 'Posts' (сообщения) или 'Comments' (комментарии)).
• feedType: Тип канала (Atom или RSS).
• mimeType: Тип mime канала.
• olderPageUrl: URL адрес страницы предыдущих сообщений, если таковые имеются в контексте текущей страницы. Данное свойство зависит от типа страницы - ссылка на предыдущие сообщения есть не у каждой страницы.
• olderPageTitle: Заголовок для ссылки на страницу с предыдущими сообщениями.
• newerPageUrl: URL адрес страницы следующих сообщений. Это свойство аналогично свойству olderPageUrl.
• newerPageTitle: Заголовок для ссылки на страницу со следующими сообщениями. Аналогично olderPageTitle.
• commentLabel: Фраза для подписи к количеству комментариев, например, «comments» или «комментариев».
• authorLabel: Фраза для указания автора сообщения, например, «posted by» или «Автор».
• timestampLabel: Фраза для указания времени публикации сообщения, например, «posted at» или «отправлено в».
• postLabelsLabel: Фраза для подписи к списку ярлыков сообщения, например, «labels for this post» или «Ярлыки».
• backlinksLabel: Фраза для описания обратных ссылок на сообщение, например, «links to this post» или «Ссылки на это сообщение».
• posts: Список сообщений для данной страницы. Каждое сообщение имеет следующие свойства:
• dateHeader: Дата сообщения; присутствует только в том случае, если это первое сообщение, опубликованное в этот день.
• id: Числовой идентификатор сообщения.
• title: Заголовок сообщения.
• body: Содержание сообщения.
• author: Отображаемое имя автора сообщения.
• url: URL адрес текущего сообщения.
• timestamp: Время публикации сообщения. В отличие от свойства dateHeader, timestamp есть у каждого сообщения.
• labels: Список ярлыков сообщения. Каждый ярлык имеет следующие свойства:
• name: Текст ярлыка.
• url: URL ссылка на страницу, содержащую все сообщения с данным ярлыком в данном блоге.
• isLast: True (истина) или false (ложь). Указывает, является ли данный ярлык последним в списке (полезно при расстановке запятых).
• allowComments: 'True' (истина), если для данного сообщения разрешены комментарии.
• numComments: Число комментариев к сообщению.
• showBacklinks: Указывает, нужно ли показывать обратные ссылки для этого сообщения.
• numBacklinks: Количество обратных ссылок для данного сообщения.
• addCommentUrl: URL адрес формы 'Добавить комментарий' для данного сообщения.
• emailPostUrl: URL адрес формы 'Отправить по почте' для данного сообщения.
• editUrl: URL адрес формы редактирования данного сообщения.
• feedLinks: Список каналов для данного сообщения. Этот список отличается от глобального списка feedLinks. Например, он может содержать канал. комментариев к сообщению. Каждый элемент списка имеет следующие свойства:
• url: URL адрес канала.
• name: Имя канала (например, 'Posts' (сообщения) или 'Comments' (комментарии)).
• feedType: Тип канала (Atom или RSS).
• mimeType: Тип mime канала.
• comments: Список всех комментариев к данному сообщению (свойство актуально только для страницы сообщения). Каждый комментарий имеет следующие свойства:
• id: Числовой идентификатор комментария.
• body: Содержание комментария.
• timestamp: Время создания комментария.
• author: Отображаемое имя автора комментария, или 'Anonymous'.
• authorUrl: URL адрес профиля автора комментария, если комментарий не анонимный.
• deleteUrl: Ссылка для удаления комментария.
• isDeleted: 'True' (Истина), если комментарий удален (текст удаленного комментария замещается заполняющим текстом, например «This post has been removed by the author»).

Вверх

Архив блога

Стиль виджета «Архив блога» (простой список, иерархия, раскрывающееся меню) легко устанавливается в визуальном режиме на панели «Дизайн» > «Элементы страницы». Если Вы проектируете новую версию виджета, то проще установить в качестве стиля значение 'FLAT' (простой список), а затем уже вносить изменения в код.

• title: Заголовок виджета.
• style: Стиль архива; возможные значения 'MENU' (раскрывающееся меню), 'FLAT' (простой список), or 'HIERARCHY' (иерархия).
• data: Список элементов архива; каждый элемент имеет свойства:
• name: Наименование периода архива, например, «Август 2006».
• url: Ссылка на страницу, содержащую сообщения данного периода.
• post-count: Количество сообщений в данном периоде.

Вверх

Профиль

Если у блога один единственный автор, то виджет «Профиль» содержит следующую информацию.

• title: Заголовок виджета.
• userUrl: URL адрес профиля автора.
• location: Местонахождение из профиля автора.
• aboutme: Информация «Обо мне» из профиля.
• displayname: Отображаемое имя автора.
• photo: Фото из профиля пользователя; свойства фото:
• url: URL адрес фото.
• width: Ширина фото в пикселах.
• height: Высота фото в пикселах.
• alt: Текст параметра alt для фото.

Обратите внимание, что для доступа к свойствам элемента данных photo, Вам нужно использовать формат записи <data:photo.url/>.

Для коллективного блога виджет «Профиль» содержит меньше информации:

• title: Заголовок виджета.
• authors: Список авторов, каждый элемент списка имеет следующие свойства:
• displayname: Отображаемое имя автора.
• userURL: URL адрес профиля автора.

Если Вы хотите, чтобы шаблон поддерживал как блоги с одним автором, так и коллективные блоги, Вы можете с помощью переменной data:team определить, с каким типом блога имеете дело. Например, вот так:

<b:if cond='data:team=="true"'>
   (отобразить список авторов)
</b:if>

Вверх

Текст / HTML / JavaScript

Виджеты «Текст» и «HTML/JavaScript» работают одинаково и имеют два свойства.

• title: Заголовок виджета.
• content: Содержание виджета.

Вверх

Канал

Содержимое виджета «Канал» подгружается автоматически с помощью Google AJAX API в момент загрузки страницы блога в браузере. Изменить вид виджета можно только с помощью таблиц стилей CSS.

• title: Заголовок виджета.
• feedUrl: URL адрес канала.

Вверх

Картинка

Виджет «Картинка» содержит одно изображение и обеспечивает доступ к его свойствам.

• title: Заголовок виджета.
• sourceUrl: URL адрес изображения.
• width: Ширина изображения в пикселах.
• height: Высота изображения в пикселах.
• caption: Подпись к изображению.

Вверх

Ярлыки

Виджет «Ярлыки» содержит список всех ярлыков, используемых в блоге.

• title: Заголовок виджета.
• labels: Список ярлыков, каждый элемент списка имеет следующие свойства:
• name: Текст ярлыка.
• count: Количество сообщений для ярлыка.
• url: Ссылка на страницу, содержащую сообщения с данным ярлыком.

Вверх

Список

Это простейшая форма списка. Каждый элемент списка содержит только простой текст.

• title: Заголовок виджета.
• items: Список элементов.

Вверх

Список ссылок

В списке ссылок каждый элемент списка имеет два свойства: текст и ссылку.

• title: Заголовок виджета.
• links: Список ссылок, каждая из которых имеет свойства:
• name: текст ссылки.
• target: URL адрес ссылки.

Вверх

Логотип

Логотип Blogger. Этот виджет, пожалуй, самый простой - в нем всего один элемент данных.

• fullButton: URL адрес выбранного логотипа Blogger.

Вверх

Источник: Layouts Data Tags.