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":

Если параметр не установлен, то по умолчанию используется "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":

Если параметр не установлен, то по умолчанию используется "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}
и т.д..

Имена полей являются полностью динамическими, поэтому при создании любого нового поля для вашей категории, оно автоматически будет доступно, как переменная по его кроткому имени.

Наверх страницы