Тег weblog category archive

Этот тег разработан для того, чтобы вы смогли перечислить все записи вашего раздела и организовать их по категориям.

{exp:weblog:category_archive weblog="default_site" style="linear"}

{categories}
<h3>{category_name}</h3>
{if category_description}<p>{category_description}</p>{/if}
{/categories}

{entry_titles}
<a href="{path=SITE_INDEX}">{title}</a><br />
{/entry_titles}

{/exp:weblog:category_archive}

С помощью этого тега вы можете отобразить заголовки всех записей, организованные по категориям в архиве, например, так:

<h3>Category one</h3>
<p>Category one is our first category.</p>
<a href="www.mysite.com/1/">title one</a><br />
<a href="www.mysite.com/2/">title two</a><br />
<a href="www.mysite.com/3/">title three</a><br />
<a href="www.mysite.com/4/">title four</a><br />
<a href="www.mysite.com/5/">title five</a><br />
<h3>Category two</h3>
<p>This was our second category ever created.</p>
<a href="www.mysite.com/6/">title one</a><br />
<a href="www.mysite.com/7/">title two</a><br />
<a href="www.mysite.com/8/">title three</a><br />
<a href="www.mysite.com/9/">title four</a><br />
<a href="www.mysite.com/10/">title five</a><br />
и т.д...

Отображаются названия каждой категории, и заголовки записей раздела, которые назначены в них. Примечание: Если раздел содержит более сотни записей, то использование этого тега на вашей странице становится затруднительным.

Параметры

backspace=

backspace="6"

Этот параметр удаляет символы после последней итерации цикла. Например, если вы размещаете тег <br /> после каждой перечисленной записью, то вы получите следующее размещение:

Category one
<a href="www.mysite.com/1/">title one</a><br />
<a href="www.mysite.com/2/">title two</a><br />
<a href="www.mysite.com/3/">title three</a><br />
<a href="www.mysite.com/4/">title four</a><br />
<a href="www.mysite.com/5/">title five</a><br />
Category two
<a href="www.mysite.com/6/">title one</a><br />
<a href="www.mysite.com/7/">title two</a><br />

Однако, возможно, вам не нужен тег <br /> после последнего пункта в каждом наборе. Добавляя параметр "backspace" вы можете удалить его. Просто сосчитайте количество символов и пробелов в позиции, которую вы хотите удалить, и укажите это количество в теге. Тег <br /> содержит 6 символов, поэтому напишем следующий код:

{exp:weblog:category_archive weblog="default_site" backspace="6"}

{categories}
<h3>{category_name}</h3>
{/categories}

{entry_titles}
<a href="{path=SITE_INDEX}">{title}</a><br />
{/entry_titles}

{/exp:weblog:category_archive}

После обработки и вывода на экран получим следующее:

<h3>Category one</h3>
<a href="www.mysite.com/1/">title one</a><br />
<a href="www.mysite.com/2/">title two</a><br />
<a href="www.mysite.com/3/">title three</a><br />
<a href="www.mysite.com/4/">title four</a><br />
<a href="www.mysite.com/5/">title five</a>
<h3>Category two</h3>
<a href="www.mysite.com/6/">title one</a><br />
<a href="www.mysite.com/7/">title two</a>

Параметр "backspace" разрешен, только если вы используете для вывода категорий стиль "linear". Параметр не применяется, если для отображения списка вы используете стиль "nested".

class=

class="my_custom_class"

При использовании стиля "nested" для вывода на экран (смотрите параметр style=), вы можете указывать атрибут "class" в открывающем теге <ul>. Значение по умолчанию - "nav_cat_archive".

disable=

disable="category_fields"

Параметр disable= дает вам возможность отключать функции тега, которые вы не используете, для повышения производительности. Допустимые опции:

id=

id="my_custom_id"

При использовании стиля "nested" для вывода на экран (смотрите параметр style=), вы можете указывать значение атрибута "id" в открывающем теге <ul>. Значение по умолчанию - "nav_cat_archive".

Например, если вы устанавливаете параметр как id="my_custom_id", то начало каждой вложенной категории было бы:

<ul id="my_custom_id">

orderby=

orderby="date"

Параметр "order" устанавливает порядок отображения записей. Варианты установки этого параметра включают:

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

show=

show="4|7"

Используя этот параметр, вы можете определить, какие категории будут включены в список. Например, если вы хотите, чтобы отдельная категория не выводилась в списке, то вы можете определить только те, которые должны отображаться. При указании нескольких категорий их идентификаторы (ID) разделяются символом ("|").

Вы можете указать категории, которые не должны отображаться:

show="not 3|6|8"

show_empty=

show_empty="no" show_empty="yes"

Этот параметр определяет, будут ли выводиться категории, в которых не содержится ни одной записи. Если вы установили "no", то категории, в которых нет ни одной записи, не будут перечислены в списке категорий.

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

show_future_entries=

show_future_entries="yes"

С помощью этого тега вы можете указать, отображать или нет записи с "будущей" датой. Эта опция полезна для создания, например, списка событий, некоторые из которых еще не произошли.

sort=

sort="asc" sort="desc"

Порядок сортировки может быть "asc" (по возрастанию или "самый старый сначала" для дат) или "desc" (по убыванию или "самый новый сначала" для дат). Если вы не используете этот параметр, то по умолчанию используется сортировка desc.

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

status=

status="open"

Вы можете ограничить выводимые записи определенным статусом. Вы можете указать несколько статусов, разделяя их символом ("|"):

status="draft|reviewed|published"

Или исключите некоторые статусы, используя "not"

status="not submitted|processing|closed"

style=

style="linear"

Существует два стиля для отображения категорий: "nested" (вложенный) и "linear" (линейный).

По умолчанию, список категорий полностью выводиться как вложенный ("nested"), чтобы отобразить иерархию родительская/дочерняя между категориями. На экране категории будут отображаться в виде вложенного "неупорядоченного списка", с автоматическим добавлением тега <li> для корректного отображения иерархии.

При использовании стиля "nested", идентификатору (id) открывающего тега <ul> списка будет присвоено значение "nav_cat_archive". Это может использоваться как "перехватчик" для javascript или CSS в поддержке DHTML или других функциональных возможностей.

<ul id="nav_cat_archive">

Список можно отображать в неструктурированном, линейном стиле "linear".

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

weblog=

weblog="weblog"

В этом параметре указывается имя раздела, на который назначены категории. Может быть указан только один раздел, так на один раздел можно назначить одну группу категорий. Это обязательный параметр, если только у вас не единственный раздел.

Парные переменные

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

Парная переменная {categories}

В парной переменной {categories}{/categories} можно использовать следующие переменные.

category_description

{categories}
<p>{category_description}</p>
{/categories}

С помощью этой переменной можно вывести на экран содержимое поля "описание категории". Переменная может использоваться внутри условного выражения, для того, чтобы выводить описание только в том случае, если оно существует:

{categories}
{if category_description}{category_description}{/if}
{/categories}

category_id

{category_id}

Идентификатор (ID) категории.

category_image

{category_image}

Ссылка на изображение (или другую информацию), которую вы можете сохранить с каждой категорией в панели управления.

category_name

{categories}
<h3>{category_name}</h3>
{/categories}

Отображает название категории.

category_url_title

{category_url_title}

Эта переменная отображает заголовок URL категории.

path

{categories}
<a href="{path=site/categories}">{category_name}</a>
{/categories}

Путь (группа шаблонов/шаблон), который используется для создания URL, указывающего на список записей, принадлежащих этой категории.

<a href="{path=site/categories}">{category_name}</a>

Также вы можете использовать SITE_INDEX в переменной path, для указания на индексную (домашнюю) страницу сайта. Если вы отображаете ваши категории на домашней странице, использование SITE_INDEX является предпочтительным, так как создает более чистый URL.

<a href="{path=SITE_INDEX}">{category_name}</a>

Заказные поля категорий

Ко всем заказным полям, назначенным на категорию, можно получить доступ, используя "короткое имя" поля:

{class}
{extended_description}
{category_name_fr}
и т.д..

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

Парная переменная {entry_titles}

Существует несколько переменных, которые можно использовать внутри парной переменной {entry_titles}{/entry_titles}.

entry_date

{entry_date format="%Y %m %d"}

Дата создания записи.

entry_id_path

{entry_titles}
<a href="{entry_id_path=site/index}">{title}</a>
{/entry_titles}

Путь (группа шаблонов/шаблон), который используется для создания URL, указывающего на эту запись. Эта переменная использует идентификатор (id) записи в URL. Обычно используется со стандартным HTML тегом link:

<a href="{entry_id_path=site/index}">{title}</a>

Также вы можете использовать SITE_INDEX в переменной path, для указания на индексную (домашнюю) страницу сайта. Если вы отображаете ваш раздел на домашней странице, использование SITE_INDEX является предпочтительным, так как создает более чистый URL.

<a href="{entry_id_path=SITE_INDEX}">{title}</a>

path

{entry_titles}
<a href="{path=site/index}">{title}</a>
{/entry_titles}

Путь (группа шаблонов/шаблон), который используется для создания URL, указывающего на эту запись. Эта переменная использует заголовок URL записи в URL. Обычно используется со стандартным HTML тегом link:

<a href="{path=site/index}">{title}</a>

Также вы можете использовать SITE_INDEX в переменной path, для указания на индексную (домашнюю) страницу сайта. Если вы отображаете ваш раздел на домашней странице, использование SITE_INDEX является предпочтительным, так как создает более чистый URL.

<a href="{path=SITE_INDEX}">{title}</a>

title

{entry_titles}
{title}
{/entry_titles}

Эта переменная содержит заголовок записи.

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