Комментарии галереи изображений

Тег comment entry позволяет вам отображать отправленные пользователями комментарии, связанные с вашими записями галереи.

Примечание: Этот тег предназначен для использования на одной из страниц "одиночной записи". То есть на странице, в URL которой содержится идентификатор (ID) записи галереи.

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

{exp:gallery:comments sort="asc" limit="20"}



{comment}



<p>By {name} on {comment_date format="%Y %m %d"}</p>



{/exp:gallery:comments}

dynamic=

dynamic="off"

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

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

gallery=

gallery="vacations"

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

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

limit=

limit="30"

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

orderby=

orderby="date"

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

orderby="date"
orderby="email"
orderby="location"
orderby="name"
orderby="url"

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

paginate=

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

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

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

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

sort=

sort="asc" sort="desc"

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

Переменные

author_id

{author_id}

Идентификатор, соответствующий профилю пользователя автора комментария. Действует, только, если комментарий оставил зарегистрированный пользователь. Возвращает ноль (0), если комментарий оставил незарегистрированный пользователь.

Может использоваться для создания ссылок к профилю комментирующего пользователя:

<a href="http://www.example.com/index.php/member/{author_id}/">{name}</a>

aol_im

{aol_im}

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

comment

{comment}

Текст комментария (его содержимое)

comment_id

{comment_id}

Идентификатор (ID) комментария

entry_id

{entry_id}

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

entry_id_path

{entry_id_path=gallery/comments}

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

<a href="{entry_id_path=gallery/comments}">my entry</a>

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

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

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}

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

name

{name}

Имя автора

permalink

{permalink}

URL к фактическому комментарию с якорем. Поместите эту переменную в ссылку:

<a href="{permalink}">permanent link</a>

switch=

{switch="option_one|option_two"}

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

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

{exp:gallery:comments}

<div class="{switch="one|two"}">

<h1>{name}</h1>

{comment}

</div>

{/exp:gallery:comments}

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

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

title

{title}

Заголовок записи галереи, с которой связан комментарий.

url

{url}

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

url_or_email

{url_or_email}

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

url_or_email_as_author

{url_or_email_as_author}

Гиперссылка или ссылка электронной почты, как имя screen_name автора (или логин, если он не указал имя).

url_or_email_as_link

{url_or_email_as_link}

То же самое, что выше, только эта переменная выведет URL или адрес электронной почты, как ссылку

yahoo_im

{yahoo_im}

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

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

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

{age}

{gender}

{zodiac}

и т.д..

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

Одиночная переменная даты

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

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

comment_date

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

Дата комментария.

edit_date

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

Дата редактирования комментария.

Условия

В комментариях могу использоваться условия:

if no_results

{if no_results}

content

{/if}

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

{if no_results}



<p>There are no comments for this entry yet.</p>



{/if}

Форма отправки комментариев

{exp:gallery:comment_form}



{/exp:gallery:comment_form}

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

{exp:gallery:comment_form preview="gallery/preview"}

Параметр "preview" определяет группу шаблонов/шаблон, которые будут использоваться для предварительного просмотра. Подробнее о предварительном просмотре, чуть позже.

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

{exp:gallery:comment_form preview="gallery/preview"}



{if logged_out}



<p>Name: <input type="text" name="name" value="{name}" size="50" /></p>



<p>Email: <input type="text" name="email" value="{email}" size="50" /></p>



<p>Location: <input type="text" name="location" value="{location}" size="50" /></p>



<p>URL: <input type="text" name="url" value="{url}" size="50" /></p>



{/if}



<p><textarea name="comment" cols="70" rows="10">{comment}</textarea></p>



<p><input type="checkbox" name="save_info" value="yes" {save_info} /> Remember my personal information</p>



<p><input type="checkbox" name="notify_me" value="yes" {notify_me} /> Notify me of follow-up comments?</p>



{if captcha}



<p>Please enter the word you see in the image below:</p>



<p>{captcha}<br />

<input type="text" name="captcha" value="{captcha_word}" maxlength="20" /></p>



{/if}



<input type="submit" name="submit" value="Submit" />

<input type="submit" name="preview" value="Preview" />



{/exp:gallery:comment_form}

Примечания:
Условная переменная {if logged_out} разрешает системе отображать сокращенную форму (только textarea), если пользователь авторизован на сайте. Мы рекомендуем, использовать этот способ, так как, если пользователь авторизован, то его анкетные данные будут добавлены автоматически.

Обратили внимание на переменные в полях "value" формы? Они позволяют автоматически отображать информацию о пользователе в форме, если он установил флажок, "Запомнить персональную информацию".

Предварительный просмотр

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

{exp:gallery:comment_preview}



{comment}



{/exp:gallery:comment_preview}

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

Переменные

{comment}
{comment_date format="%Y %m %d"}
{email}
{location}
{name}
{url}
{url_or_email}
{url_or_email_as_author}
{url_or_email_as_link}

Условия

Доступны следующие условия:

{if email}
{if location}
{if logged_in}
{if logged_out}
{if name}
{if url}