Язык шаблонов Blogger: Тэги для подстановки данных

Blogger LogoДанная статья является заключительной в серии публикаций с переводами на русский язык разделов справки Blogger, посвященных синтаксису шаблонов разметки блога.

(Перевод материала Layouts Data Tags, дополненный мной)

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

Как уже было сказано в статье "Тэги для содержимого виджетов", подстановка в шаблон актуальных данных осуществляется конструкцией <data:имя/>, где имя - название конкретной переменной, содержащей данные. Конкретный набор доступных переменных зависит от типа текущего виджета.

  • Глобально доступные данные
  • AdSense (AdSense)
  • Attribution (Атрибуты блога в "подвале")
  • Blog (Основная часть блога)
  • BlogArchive (Архив блога)
  • BloggerButton (Логотип)
  • BlogList (Blog List)
  • CustomSearch (Окно поиска)
  • Feed (Канал)
  • FollowByEmail (Рассылка обновлений по электронной почте)
  • Followers (Постоянные читатели)
  • Header (Заголовок страницы)
  • HTML (HTML/JavaScript)
  • Image (Картинка)
  • Label (Ярлыки)
  • LinkList (Список ссылок)
  • NewsBar (Новости)
  • PageList (Страницы)
  • Poll (Опрос)
  • PopularPosts (Популярные сообщения)
  • Profile (Профиль)
  • Slideshow (Показ слайдов)
  • Stats (Статистика блога)
  • Subscribe (Ссылки на подписки)
  • Text (Текст)
  • TextList (Список)
  • VideoBar (Панель видео)

Глобально доступные данные

Этот набор переменных применим к странице в целом и доступен из любого виджета, а также вне виджетов.
  • blog.title: Заголовок блога.
  • blog.pageType: Тип текущей страницы: 'all', 'archive', 'main', 'index', 'static_page', или 'item'.
  • blog.url: URL текущей страницы.
  • blog.homepageUrl: Адрес главной страницы блога.
  • blog.pageTitle: Заголовок текущей страницы, сформированный из заголовка блога и дополнительной информации, такой как название текущего сообщения и т.п.
  • blog.encoding: Используемая кодировка.
  • blog.languageDirection: Направление письма для языка блога: "ltr" или "rtl" (слева направо и справа налево).
  • blog.feedLinks: Ссылки на фиды.

Header

Простой виджет, чья задача вывести две переменные: заголовок и описание блога.
  • title: Заголовок блога.
  • description: Описание блога.

Blog

Центральная и самая сложная часть любого блога, виджет, отвечающий за выдачу постов.

  • feedLinks: Список фидов текущей страницы. На главной странице содержит главные фиды блога, на страницах постов - фиды комментариев. Каждый элемент списка включает следующее:
    • url: URL фида.
    • name: Имя фида.
    • feedType: Тип фида (Atom или RSS).
    • mimeType: MIME-тип.
  • olderPageUrl: Если имеются сообщения, более старые, чем сообщения на текущей странице, это поле содержит ссылку на предыдущие сообщения. Контекстно зависит от типа страницы. (Не на всех страницах есть ссылка.)
  • olderPageTitle: Заголовок ссылки на предыдущие сообщения.
  • newerPageUrl: Аналогично 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: Ссылка на страницу сообщения.
    • timestamp: Timestamp. В отличие от dateHeader, присутствует в каждом сообщении.
    • labels: Список ярлыков сообщения. Каждый элемент списка включает следующее:
      • name: Текст ярлыка.
      • url: URL страницы, перечисляющей все сообщения с данным ярлыком.
      • isLast: True или false. Указывает, является ли ярлык последним в списке. Используется для правильной расстановки знаков препинания и/или разметки.
    • allowComments: 'True' если разрешено оставлять комментарии к сообщению.
    • numComments: Число оставленных комментариев.
    • showBacklinks: Отображать ли обратные ссылки на данное сообщение.
    • numBacklinks: Число ссылок.
    • addCommentUrl: URL формы добавления комментария.
    • emailPostUrl: URL формы 'email this post'.
    • editUrl: URL формы редактирования сообщения.
    • feedLinks: Список фидов для данного сообщения. Каждый элемент списка включает следующее:
      • url: URL фида.
      • name: Название фида.
      • feedType: Тип фида (Atom или RSS).
      • mimeType: MIME-тип фида.
    • comments: Список всех комментариев сообщения (только на страницах типа item). Каждый элемент списка включает следующее:
      • id: Числовой идентификатор комментария.
      • body: Тело комментария.
      • timestamp: Время создания комментария.
      • author: Отображаемое имя автора комментария (или 'Anonymous').
      • authorUrl: URL профиля автора комментария, если комментарий не анонимный.
      • deleteUrl: URL для удаления комментария.
      • isDeleted: Был ли комментарий удалён. (Текст удалённых комментариев заменяется заглушкой.)

BlogArchive

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

Profile

Для блога с единственным автором, виджет Profile содержит следующую информацию:
  • title: Заголовок виджета.
  • userUrl: URL профиля автора.
  • location: Местарасположение автора, взятое из профиля.
  • aboutme: Информация "Обо мне", взятая из профиля.
  • displayname: Отображаемое имя автора.
  • photo: Фото, включающий следующее:
    • url: URL изображения.
    • width: Ширина изображения в пикселях.
    • height: Высота изображения в пикселях.
    • alt: Текст для атрибута "alt".

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

Если в шаблоне необходимо обрабатывать оба варинта, можно использовать переменную team для их различения:
<b:if cond='data:team=="true"'> [показ нескольких авторов] </b:if>

Text / HTML / JavaScript

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

Feed

Виджет Feed динамически загружается при помощи Google AJAX APIA при отображении блога в браузере и его стиль можно изменить только при помощи CSS.

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

Image

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

Label

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

TextList

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

LinkList

  • title: Заголовок виджета.
  • links: Список ссылок, включающий следующее:
    • name: Текст.
    • target: URL.

BloggerButton

  • fullButton: URL лого.

Комментариев: 2

  1. как виджет Label1 отобразить в мобильном шаблоне?

    ОтветитьУдалить
    Ответы
    1. Никак, насколько я знаю. Там отрезается все, кроме основной ленты.

      Удалить

Хотите подписать свой комментарий, но у вас нет аккаунта? Выберите в выпадающем списке Имя/URL.
Вы сможете вписать свои имя или ник. Поле для указания URL можно оставить пустым.

Тэги, допустимые в комментариях