Weblog entries - Одиночные переменные

Стандартный тег {exp:weblog:entries} имеет множество переменных, которые могут использоваться внутри его. Эти переменные разделены на две обширные категории:

Стандартные переменные

absolute_count

{absolute_count}

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

Если на каждой странице отображается по пять записей, то для четвертой записи на второй странице переменная {absolute_count} будет иметь значение "9"

БОНУС: Так как модуль поиска использует переменные раздела, параметр {absolute_count } также доступен для тега search results.

aol_im

{aol_im}

Имя учетной записи AOL IM автора

author

{author}

Имя автора (screen name), если оно существует; иначе, эта переменная содержит логин пользователя.

author_id

{author_id}

Идентификатор (ID) пользователя автора записи

avatar_image_height

{avatar_image_height}

Высота изображения аватара автора записи. Обычно используется следующим образом:

{if avatar}
<img src="{avatar_url}" width="{avatar_image_width}" height="{avatar_image_height}" alt="{author}'s avatar" />
{/if}

avatar_image_width

{avatar_image_width}

Ширина изображения аватара автора записи. Обычно используется следующим образом:

{if avatar}
<img src="{avatar_url}" width="{avatar_image_width}" height="{avatar_image_height}" alt="{author}'s avatar" />
{/if}

avatar_url

{avatar_url}

URL к изображению аватара, которое принадлежит автору записи. Обычно используется следующим образом:

{if avatar}
<img src="{avatar_url}" width="{avatar_image_width}" height="{avatar_image_height}" alt="{author}'s avatar" />
{/if}

bio

{bio}

Биография автора, как указано в его профиле.

comment_auto_path

{comment_auto_path}

Эта переменная возвращает URL, установленный в настройке "URL страницы комментариев", на странице Admin > Управление разделами. В эту переменную не входят ни идентификатор записи (entry id), ни URL заголовок, или другая информация; она возвращает только URL из указанной настройки;

comment_entry_id_auto_path

{comment_entry_id_auto_path}

Эта переменная возвращает URL, установленный в настройке "URL страницы комментариев", на странице Admin > Управление разделами. Автоматически добавляется идентификатор (ID) записи. Например, этот код:

<a href="{comment_entry_id_auto_path}">my entry</a>

Будет обработан следующим образом:

<a href="http://www.example.com/index.php/weblog/comments/234/">my entry</a>

comment_tb_total

{comment_tb_total}

Общее количество комментариев и трекбэков для отдельной записи.

comment_total

{comment_total}

Общее количество комментариев для отдельной записи

comment_url_title_auto_path

{comment_url_title_auto_path}

Эта переменная возвращает URL, установленный в настройке "URL страницы комментариев", на странице Admin > Управление разделами. Автоматически будет добавлен заголовок URL. Например, этот код:

<a href="{comment_url_title_auto_path}">my entry</a>

Будет обработан следующим образом:

<a href="http://www.example.com/index.php/weblog/comments/ice_cream/">my entry</a>

count

{count}

"Количество" текущих отображаемых записей. Если отображается пять строк, то для четвертой строки переменная {count} будет иметь значение "4".

email

{email}

Необработанный адрес электронной почты автора

entry_id

{entry_id}

Идентификатор (ID) записи раздела

entry_id_path

{entry_id_path=weblog/archives}

URL к указанному шаблону. Автоматически добавляется идентификатор (ID) записи. Например, этот код:

<a href="{entry_id_path=weblog/archives}">my entry</a>

Будет обработан следующим образом:

<a href="http://www.example.com/index.php/weblog/archives/234/">my entry</a>

entry_site_id

{entry_site_id}

Идентификатор (ID) сайта записи раздела.

forum_topic_id

{forum_topic_id}

Если у вас установлен модуль форума и если вы связали тему форума с записью раздела (через секцию "Форум" вкладки публиковать), то это - идентификатор (ID) темы форума. Обычно используется следующим образом:

{if forum_topic}
<a href="{path=forums/viewthread}{forum_topic_id}">Discuss this in our forums</a>
{/if}

icq

{icq}

Номер ICQ IM автора

interests

{interests}

"Увлечения" автора, как указано в его профиле

ip_address

{ip_address}

IP адрес автора, во время публикации записи

location

{location}

Местожительство автора, как указано в его профиле

member_search_path

{member_search_path=search/results}

Эта переменная возвращает URL, который ведет на страницу результатов поиска по имени автора. Таким образом, вы можете показать все записи, созданные автором. Вы должны указать группу шаблонов/шаблон, которые вы используете для вывода результатов поиска. Например:

<a href="{member_search_path=search/results}">View entries by this member</a>

msn_im

{msn_im}

Учетная запись MSN IM автора комментария

occupation

{occupation}

Занятие автора, как указано в его профиле

page_uri

{page_uri}

Если у вас установлен модуль страниц и если вы связали статическую страницу с записью раздела (через секцию "Страницы" вкладки публиковать), то это - URI страницы для страницы. Обычно используется следующим образом:

{if page_uri != ''}
<a href="{page_uri}">View this page</a>
{/if}

page_url

{page_url}

Если у вас установлен модуль страниц, и если вы связали статическую страницу с записью раздела (через секцию "Страницы" вкладки публиковать), то это - URL страницы для страницы (URL сайта + URI страницы). Обычно используется следующим образом:

{if page_url != ''}
<a href="{page_url}">View this page</a>
{/if}

permalink

{permalink}

Эта переменная содержит адрес индексной страницы сайта вместе с идентификатором (ID) записи:

http://www.example.com/235/

Кроме того, вы можете указать группу шаблонов/шаблон, а идентификатор записи будет добавлен автоматически:

{permalink="weblog/archives"}

Будет обработано как:

http://www.example.com/weblog/archives/235/

photo_url

{photo_url}

Эта переменная возвращает URL фотографии пользователя, (если эта опция включена, и пользователи могут загружать свои фотографии). Она предназначена для использования в теге image.

photo_image_height

{photo_image_height}

Эта переменная возвращает высоту фотографии пользователя. Она предназначена для использования в теге image.

photo_image_width

{photo_image_width}

Эта переменная возвращает ширину фотографии пользователя. Она предназначена для использования в теге image.

profile_path

{profile_path=member}

URL к профилю автора текущей записи. Автоматически добавляется идентификатор записи. Используется для создания ссылки:

<a href="{profile_path=member}">{author}</a>

relative_url

{relative_url}

URL хранящийся в вашей настройке URL раздела на странице управление разделами, с удаленной доменной информацией. Например, если в настройке указано http://www.example.com/index.php/site/index/, то значение переменной будет /index.php/site/index/. Обычно используется только в шаблонах передачи Atom.

relative_date

{relative_date}

Время, прошедшее с момента публикации записи до текущего момента. Выводиться в формате 1 day, 3 hours, 45 minutes. Эта переменная полезна для отображения сообщений типа "Эта запись была отправлена 1 день, 3 часа, 45 минут назад".

screen_name

{screen_name}

Имя автора (screen name), если оно существует. Эта переменная не содержит никакой информации, если имя автора не определено.

signature

{signature}

Подпись автора записи. Обычно используется следующим образом:

{if signature}
<p>{signature}</p>
{/if}

signature_image_height

{signature_image_height}

Высота изображения в подписи автора записи. Обычно используется следующим образом:

{if signature_image}
<img src="{signature_image_url}" width="{signature_image_width}" height="{signature_image_height}" alt="{author}'s signature" />
{/if}

signature_image_url

{signature_image_url}

URL к изображению для подписи автора записи. Обычно используется следующим образом:

{if signature_image}
<img src="{signature_image_url}" width="{signature_image_width}" height="{signature_image_height}" alt="{author}'s signature" />
{/if}

signature_image_width

{signature_image_width}

Ширина изображения в подписи автора комментария. Обычно используется следующим образом:

{if signature_image}
<img src="{signature_image_url}" width="{signature_image_width}" height="{signature_image_height}" alt="{author}'s signature" />
{/if}

status

{status}

Статус записи (open, closed, и т.д.)

switch=

{switch="option_one|option_two|option_three"}

Эта переменная разрешает вам чередовать любое количество значений отображения записей. Первая запись будет использовать "option_one", вторая будет использовать "option_two", третья "option_one", и так далее.

Самое очевидное применение этой переменной, - чередование цветов. Это можно сделать следующим образом:

{exp:weblog:entries weblog="yourweblog"}
<div class="{switch="one|two"}">
<h1>{title}</h1>
{body}
</div>
{/exp:weblog:entries}

Тогда записи будут чередоваться между <div class="one"> и <div class="two">.

Одновременно может использоваться несколько тегов {switch=}, и система будет корректно отслеживать каждый из них.

title

{title}

Заголовок записи

title_permalink

{title_permalink}

Эта переменная использует "Заголовок URL" как ссылку. По умолчанию это значение содержит адрес индексной страницы сайта вместе с "Заголовком URL":

http://www.example.com/my_ugly_boyfriend/

Кроме того, вы можете указать группу шаблонов/шаблон, а "Заголовок URL" будет добавлен автоматически:

{title_permalink="weblog/archives"}

Будет обработано как:

http://www.example.com/weblog/archives/my_ugly_boyfriend/

Примечание: Если при создании новой записи вы не указываете "Заголовок URL" то он будет создан автоматически, на основании фактического заголовка записи. Все пробелы автоматически преобразуются в подчеркивания, и удаляются кавычки. Например, "Joe's night out" будет преобразовано в "joes_night_out".

total_results

{total_results}

Общее количество выводимых на экран записей.

trackback_total

{trackback_total}

Общее количество трекбэков для отдельной записи

trimmed_url

{trimmed_url}

Название домена вашего сайт, без субдоменов. Например, www.example.com становится example.com. Обычно используется только в шаблонах передачи Atom.

url

{url}

Необработанный URL автора, если он существует

url_or_email

{url_or_email}

URL автора, если он существует, иначе необработанный адрес электронной почты

url_or_email_as_author

{url_or_email_as_author}

Гиперссылка к URL автора, если он существует, иначе это будет ссылка адреса email автора. Текст ссылки будет именем автора, если оно существует, тест ссылки будет содержать логин пользователя.

url_or_email_as_link

{url_or_email_as_link}

Эта переменная подобна переменной, приведенной выше. Разница в том, что текстом для ссылки или URL или адрес электронной почты.

url_title

{url_title}

Удобочитаемый заголовок, используемый в URL как постоянная ссылка

url_title_path

{url_title_path=weblog/archives}

URL к указанному шаблону. Автоматически будет добавлен "Заголовок URL". Например, этот код:

<a href="{url_title_path=weblog/archives}">permalink</a>

Будет обработан следующим образом:

<a href="http://www.example.com/index.php/weblog/archives/ice_cream/">permalink</a>

username

{username}

Логин автора

weblog

{weblog}

Название (полное имя) раздела, в который назначена текущая запись.

weblog_id

{weblog_id}

Идентификатор (ID) текущего раздела (не записи)

weblog_short_name

{weblog_short_name}

Короткое имя раздела для текущей записи на странице.

yahoo_im

{yahoo_im}

Имя учетной записи Yahoo IM автора

Заказные поля записей

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

{body}
{summary}
{extended}
и т.д..

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

Заказные поля пользователей

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

{age}
{gender}
{zodiac}
и т.д..

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

Переменные даты

Для использования доступны несколько переменных даты. Как и с другими переменными даты, необходимо использовать параметр "format", чтобы определить формат отображения даты. Смотрите страницу изменяемое форматирование даты для получения дополнительной информации.

entry_date

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

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

expiration_date

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

Дата окончания записи

edit_date

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

Дата последнего редактирования записи

gmt_entry_date

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

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

gmt_edit_date

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

Дата последнего редактирования записи, по Гринвичу. Эта переменная не локализированная, т.е. не учитывает настройки даты пользователя.

recent_comment_date

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

Дата последнего комментария, связанного с записью

week_date

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

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

Эта переменная зависит от параметра start_day. По умолчанию, для записей, неделя начинается с воскресенья. Когда будет использоваться start_day="Monday", днем начала недели будет понедельник.

Заказные поля даты

Для заказных полей раздела может быть назначен тип "дата". Заказными полями можно управлять в контрольной панели на странице:

Admin > Администрирование разделов > Заказные поля разделов

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

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

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