Параметры тега gallery entry

Для управления выводом на экран тега gallery entry, могут использоваться различные параметры. Параметры добавляются в открывающую часть тега. Вот простой пример тега галереи с четырьмя параметрами.

{exp:gallery:entries  gallery="vacation"  orderby="date"  columns="4"  rows="2" }

	content

	{/exp:gallery:entries}

В примере, приведенном выше, отображаются 2 строки записей с 4 изображениями в колонке, все из галереи "vacation" с сортировкой по дате.

Доступны следующие параметры:

category="2"
columns="4" rows="2"
dynamic="off"
entry_id="147"
entry_id_from="20"
entry_id_to="40"
gallery="vacations"
limit="10"
log_views="off"
orderby="date"
paginate="top"
show_future_entries="yes"
sort="asc"
status="open"

category=

category="2"

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

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

category="2|45|4|9"

Или вы можете использовать "not", чтобы исключить некоторые категории

category="not 4|5|7"

columns= rows=

columns="4" rows="2"

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

dynamic=

dynamic="off"

Механизм отображения галереи устанавливает некоторые параметры динамически, основываясь на том, что содержится в URL. Однако бывают случаи, когда, вы не хотите, чтобы действовали параметры, которые содержаться в URL. Для отключения динамического характера тега галереи, используйте параметр dynamic="off".

Это бывает полезно, если, например, вы захотите поместить список записей на врезке сбоку от основного текста на вашем сайте, и отображать их всегда, независимо от того, на какой странице сайта вы находитесь (главная страница, архивы, комментарии, и т.д.). Устанавливая dynamic="off", вы гарантируете, что на список не будет воздействовать информация, которая в данный момент находится в URL.

entry_id=

entry_id="147"

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

entry_id="13|42|147"

Или использовать "not", для исключения записей

entry_id="not 7|26"

entry_id_from=

entry_id_from="20"

Этот параметр используется вместе с параметром entry_id_to=, для определения диапазона записей, выводимых на экран. Этот параметр указывает начало диапазона. В примере выше, тег выводил бы на экран записи, начиная с записи, имеющей идентификатор (ID) 20.

entry_id_to=

entry_id_to="40"

Этот параметр используется совместно с параметром entry_id_from=, для определения диапазона выводимых на экран записей. Этот параметр указывает конец диапазона. В примере выше, тег остановил бы вывод на экран записей после записи с идентификатором (ID) 40,

gallery=

gallery="vacations"

Это обязательный параметр. Имя (короткое имя) галереи, записи которой вы желаете выводить на экран.

limit=

limit="12"

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

Заметим, что этот параметр обычно не нужен, поскольку параметр columns= rows= будет, естественно ограничивать вывод.

log_views=

log_views="off"

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

log_views="on"
log_views="off"

orderby=

orderby="date"

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

orderby="caption"
orderby="date"
orderby="edit_date"
orderby="entry_id"
orderby="most_comments"
orderby="most_recent_comment"
orderby="most_views"
orderby="random"
orderby="screen_name"
orderby="title"
orderby="username"

paginate=

paginate="top" paginate="bottom" paginate="both"

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

top: Навигационный текст и ссылки будут отображаться сверху списка записей.
bottom: Навигационный текст и ссылки будут отображаться снизу списка записей.
both: Навигационный текст и ссылки будут отображаться и сверху и снизу списка записей.

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

show_future_entries=

show_future_entries="yes"

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

sort=

sort="asc" sort="desc"

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

status=

status="open"

Статус галереи, которым вы хотели бы ограничить показ. Вы можете выбрать или "open" или "closed". Если вы не определили этот параметр, то по умолчанию устанавливается "open".

Переменные

В теге вы можете использовать множество переменных, для вывода различной информации, типа заголовка записи, даты, тела записи, и т.д.