Weblog entries - Парные переменные
Парные переменные содержат открывающий и закрывающий тег, а также некоторый контент между ними. Например:
{date_heading}
<h1>{entry_date format="%Y %m %d"}</h1>
{/date_heading}
Поэтому парные переменные имеют открытие и закрытие пары, поскольку информация между парами может быть отображена или нет в том случае, если встретились критерии для каждого тега.
В случае пары "date_heading", например, информация межу тегами будет отображаться только в определенном интервале, который вы установили (ежечасно, ежедневно, еженедельно, ежемесячно, и т.д.). При использовании парных переменных вы можете поместить между ними HTML форматирование, которое будет отображаться только через указанный интервал. В другом случае эта часть кода не выводится.
date_footer
{date_footer display="daily"}
<p>That's all from today!</p>
{/date_footer}
Date footer может использоваться для отображения колонтитулов через определенные промежутки времени. Могут быть установлены следующие интервалы отображения ежечасно, ежедневно, еженедельно, ежемесячно, или ежегодно.
Параметр display
Открывающий тег {date_footer} имеет дополнительный параметр "display", который используется для установки интервала отображения:
{date_footer display="daily"}
Варианты для параметра "display":
- {date_footer display="hourly"}
- {date_footer display="daily"}
- {date_footer display="weekly"}
- {date_footer display="monthly"}
- {date_footer display="yearly"}
Если параметр не установлен, то по умолчанию используется "daily" (ежедневно).
Примечание: Вы можете использовать сколько угодно переменных date_footers, в одном и том же теге. Это будет некоторым образом сказываться на производительности системы, поскольку разбор дат это достаточно ресурсоемкая операция. Читайте раздел кэширование, для получения дополнительной информации об улучшении производительности.
date_heading
{date_heading}
<h1>{entry_date format="%Y %m %d"}</h1>
{/date_heading}
Date heading может использоваться для вывода даты в заголовке через определенные интервалы. Могут быть установлены следующие интервалы отображения ежечасно, ежедневно, еженедельно, ежемесячно, или ежегодно.
При использовании еженедельных интервалов, очевидно, будет использоваться переменная {week_date }.
{date_heading display="weekly"}Week of {week_date format="%Y %m %d"}{/date_heading}
Параметр display
Открывающий тег {date_heading} имеет дополнительный параметр "display", используемый для установки интервала отображения:
{date_heading display="daily"}
Варианты для параметра "display":
- {date_heading display="hourly"}
- {date_heading display="daily"}
- {date_heading display="weekly"}
- {date_heading display="monthly"}
- {date_heading display="yearly"}
Если параметр не установлен, то по умолчанию используется "daily" (ежедневно).
Примечание: Вы можете использовать сколько угодно переменных date_headers, в одном и том же теге. Это будет некоторым образом сказываться на производительности системы, поскольку разбор дат это достаточно ресурсоемкая операция. Читайте раздел кэширование, для получения дополнительной информации об улучшении производительности.
categories
{categories}
{category_image} <a href="{path=weblog/index}">{category_name}</a>
{/categories}
Парная переменная categories уникальна тем, что она образует цикл. Так как одна запись может быть назначена в несколько категорий, необходим механизм, чтобы отобразить все категории, в которые назначена каждая запись.
Параметр backspace
Вы можете добавить дополнительный параметр, который позволяет выполнить "возврат":
{categories backspace="6"}
Этот параметр удаляет символы после последней итерации цикла. Например, если вы размещаете тег <br /> между каждой категорией, то вы должны получить следующее размещение:
News<br />
Sports<br />
Politics<br />
Однако, возможно, вам не нужен тег <br /> после последнего пункта. Добавляя параметр "backspace" вы можете удалить его. Просто сосчитайте количество символов и пробелов в позиции, которую вы хотите удалить, и укажите это количество в теге. Тег <br /> содержит 6 символов, поэтому напишем следующий код:
{categories backspace="6"}
{category_name}<br />
{/categories}
Этот код будет отображать результаты следующим образом:
News<br />
Sports<br />
Politics
Параметр limit
{categories limit="1"}
Этот параметр ограничивает количество категорий, выводимых этой парной переменной. При использовании, он будет ограничивать вывод предусмотренным количеством, используя порядок, определенный на странице управления категориями для определения отображаемых категорий.
Параметр show
{categories show="4|7"}
С помощью этого параметра вы можете указать, какие категории будут включены в список парной переменной. Например, если у вас есть записи, принадлежащие нескольким категориям, то вы можете использовать этот параметр, чтобы выводить только те категории, которые вы указали. В то время как записи фактически могут принадлежать большему количеству категорий, отображаться будут только те, которые вы указали. При указании нескольких категорий их идентификаторы (ID) разделяются символом ("|").
Вы можете указать категории, которые не должны отображаться:
{categories show="not 3|6|8"}
Параметр show group
{categories show_group="1|3"}
С помощью этого параметра вы можете указать, какие группы категорий будут включены в список парной переменной {categories}. Например, если у вас существуют записи в разделе, который имеет несколько групп категорий, но вы хотите показать категории только из одной из этих групп, то вы можете указать идентификатор (ID) группы категорий с этим параметром. При указании нескольких групп категорий их идентификаторы (ID) разделяются символом ("|").
Вы можете указать группы категорий, которые не должны отображаться:
{categories show_group="not 2|4"}
{category_id}
{category_id}
Идентификатор (ID) категории.
{category_image}
{category_image}
Ссылка на изображение (или другую информацию), которую вы можете сохранить с каждой категорией в панели управления.
{category_name}
{category_name}
Отображает название категории.
{category_url_title}
{category_url_title}
Эта переменная отображает заголовок URL категории.
{path=}
{path=weblog/index}
Эта переменная содержит URL к указанной группе шаблонов/шаблону. Информация, обозначающая категории будет автоматически добавлена в конец URL так, чтобы целевой странице было известно, какую категорию выводить.
Если вы хотите, чтобы ссылки категорий указывали на индексную страницу сайта, взамен отдельной группы шаблонов/шаблона, то вы можете использовать SITE_INDEX:
{categories}
<a href="{path=SITE_INDEX}">{category_name}</a>
{/categories}
Заказные поля категорий
Ко всем заказным полям, назначенным на категорию, можно получить доступ, используя "короткое имя" поля:
{class}
{extended_description}
{category_name_fr}
и т.д..
Имена полей являются полностью динамическими, поэтому при создании любого нового поля для вашей категории, оно автоматически будет доступно, как переменная по его кроткому имени.