Отзывы

• Отзывы
• Конструктор формы
• Настройки
• Шаблонные теги
• База данных
• Файлы

Модуль относится к части CMS «Интерактив» и может быть установлен опционально.

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

Отзывы

В административной части модуля все отзывы собираются в одну таблицу и отображаются в порядке поступления.

Отзывы имеют следующие характеристики.

Основные:

• Дата добавления – В формате дд.мм.гггг чч:мм.
• Пользователь – Пользователь, добавивший отзыв (если отзыв добавлен зарегистрированным пользователем).
• Дополнительные поля – Поля, добавленные в конструкторе формы.
• Отправить ответ – Возможность отправить ответ на e-mail, указанный пользователем. Содержание письма, а также e-mail, указываемый в обратном адресе можно редактировать в настройках модуля. Письмо не может быть отправлено, если не заполнено текстовое поле для ответа или e-mail получателя. Поле «Отправить ответ» появляется, если в конструкторе формы есть поле с типом «электронный ящик».
• Опубликовать на сайте – Если не отмечена, отзыв не будет виден на сайте.
• Отзыв к – Объект, к которому прикреплены отзывы, ссылка на все отзывы к этой странице.
• Ответ – Текстовое поле для ответа.

Конструктор формы

Количество и содержание полей отзывов может быть различно. Это обеспечивает конструктор формы.

Конструктор – это дополнительные поля формы отзывов.

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

Основные:

• Название – Параметр имеет разные значения для разных языковых версий сайта.
• Модуль – Возможность ограничить применением поля, прикрепленными к выбранному модулю.
• Тип – Возможные значения:
  • строка,
  • число,
  • дата,
  • дата и время,
  • текстовое поле,
  • поле с редактором,
  • галочка,
  • переключатель,
  • выпадающий список,
  • список с выбором нескольких значений,
  • электронный ящик,
  • телефон,
  • ссылка,
  • заголовок группы характеристик,
  • файлы,
  • изображения.
• Значение – Смысловая нагрузка поля. Возможные значения:
  • Свободное поле,
  • Оценка,
  • Имя,
  • Аватар,
  • E-mail,
  • Телефон.
• Максимальное количество добавляемых файлов – Количество добавляемых файлов. Если значение равно нулю, то форма добавления файлов не выводится. Параметр выводится, если тип характеристики задан как «файлы».
• Доступные типы файлов (через запятую) – Параметр выводится, если тип характеристики задан как «файлы».
• Распознавать изображения – Позволяет прикрепленные файлы в формате JPEG, GIF, PNG отображать как изображения. Параметр выводится, если тип характеристики задан как «файлы».
• Размер для большого изображения – Размер изображения, отображаемый в пользовательской части сайта при увеличении изображения предпросмотра. Параметр выводится, если тип характеристики задан как «файлы» и отмечена опция «Распознавать изображения».
• Размер для маленького изображения – Размер изображения предпросмотра. Параметр выводится, если тип характеристики задан как «файлы» и отмечена опция «Распознавать изображения».
• Использовать анимацию при увеличении изображений – Параметр добавляет JavaScript код, позволяющий включить анимацию при увеличении изображений. Параметр выводится, если отмечена опция «Распознавать изображения». Параметр выводится, если тип характеристики задан как «файлы» и отмечена опция «Распознавать изображения».
• Максимальный размер загружаемых файлов – Параметр показывает максимально допустимый размер загружаемых файлов, установленный в настройках хостинга. Параметр выводится, если тип характеристики задан как «файлы».
• Генерировать размеры изображений – Размеры изображений, заданные в модуле «Изображения». Параметр выводится, если тип характеристики задан как «изображение».
• Обязательно для заполнения.
• Выводить в списке – Выводит значение поля для отзывов на сайте в списке отзывов
• Выводить в форме для авторизованных пользователей.
• Выводить в форме для неавторизованных пользователей.
• Сортировка: установить перед – Редактирование порядка следования поля в форме
• Описание – Параметр имеет разные значения для разных языковых версий сайта.

Настройки

• Формат даты – Позволяет настроить отображение даты в модуле. Возможные значения:
  • 01.05.2016,
  • 01.05.2016 14:45,
  • 1 мая 2016 г.,
  • 1 мая,
  • 1 мая 2016, понедельник,
  • вчера 15:30,
  • не отображать.
• Количество отзывов на странице – Количество отзывов первого уровня, показываемых на одной странице.
• Включить «Показать ещё» – На странице отзывов появится кнопка «Показать ещё». Увеличивает количество одновременно выводимых отзывов в списке.
• Отображать имя пользователя, добавившего отзыв – Выводит имя пользователя, добавившего отзыв на сайте
• Только для зарегистрированных пользователей – Параметр позволяет запретить незарегистрированным пользователям добавлять отзывы.
• Использовать защитный код (капчу) – Для добавления отзыва пользователь должен ввести защитный код.
• Модерация отзывов – Если отмечена, отзывы будут отображаться на сайте только после того, как администратор вручную установит активность. Если пользователь, добавивший отзыв имеет права администратора модуля, то отзыв появится на сайте сразу.
• Сообщение пользователю после отправки отзыва – Параметр имеет разные значения для разных языковых версий сайта.
• Скрывать форму после отправки отзыва – Позволяет скрывать форму после отправки отзыва.
• Блокировать отправку повторного отзыва – Блокирует повторную отправку формы отзыва. Параметр появляется, если отмечена опция «Скрывать форму после отправки отзыва».
• Тема письма для ответа – Можно добавлять:
  • %title – название сайта,
  • %url – адрес сайта (например, site.ru).
  Параметр имеет разные значения для разных языковых версий сайта.
• Сообщение для ответа – Можно добавлять:
  • %title – название сайта,
  • %url – адрес сайта (например, site.ru),
  • %message – сообщение,
  • %answer – ответ.
  Параметр имеет разные значения для разных языковых версий сайта.
• E-mail, указываемый в обратном адресе пользователю – Возможные значения:
  • e-mail, указанный в параметрах сайта;
  • другой (при выборе этого значения появляется дополнительное поле впишите e-mail).
• Уведомлять о поступлении новых отзывов на e-mail – Возможность уведомления администратора о поступлении новых отзывов из формы в пользовательской части сайта.
• E-mail для уведомлений администратора – Возможные значения:
  • e-mail, указанный в параметрах сайта;
  • другой (при выборе этого значения появляется дополнительное поле впишите e-mail).
  Параметр появляется, если отмечена опция «Уведомлять о поступлении новых отзывов на e-mail».
• Тема письма для уведомлений – Можно добавлять:
  • %title – название сайта,
  • %url – адрес сайта (например, site.ru).
  Параметр появляется, если отмечена опция «Уведомлять о поступлении новых отзывов на e-mail».
• Сообщение для уведомлений – Можно добавлять:
  • %title – название сайта,
  • %url – адрес сайта (например, site.ru),
  • %message – отзыв,
  • %urlpage – ссылка на страницу на сайте, где отзыв отображается.
  Параметр появляется, если отмечена опция «Уведомлять о поступлении новых отзывов на e-mail».
• Уведомлять о поступлении новых отзывов по SMS – Возможность отправлять SMS администратору при поступлении отзыва. Параметр можно подключить, если в Параметрах сайта настроены SMS-уведомления.
• Номер телефона в федеральном формате – Номер телефона для SMS-уведомлений администратора о новом отзыве. Параметр появляется, если отмечена опция «Уведомлять о поступлении новых отзывов по SMS».
• Сообщение для уведомлений – Текст сообщения для SMS-уведомлений администратора о новом отзыве. Не более 800 символов. Параметр появляется, если отмечена опция «Уведомлять о поступлении новых отзывов по SMS».

Шаблонные теги

Для работы с модулем «Отзывы» служат следующие шаблонные теги:

show – выводит отзывы и форму добавления отзывов для текущей страницы.

Атрибуты:

— modules – модули (разделенные запятой), к которым подключены отзывы;

— element_types – типы данных (разделенные запятой): element – элемент (по умолчанию), cat – категория, brand – производитель. Если не задан, то подключается ко всем типам данных модуля;

— defer – маркер отложенной загрузки шаблонного тега: event – загрузка контента только по желанию пользователя при нажатии кнопки "Загрузить", emergence – загрузка контента только при появлении в окне браузера клиента, async – асинхронная (одновременная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, sync – синхронная (последовательная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, по умолчанию отложенная загрузка не используется, обычный вывод шаблонных тегов в коде страницы;

— defer_title – текстовая строка, выводимая на месте появления загружаемого контента с помощью отложенной загрузки шаблонного тега;

— template – шаблон тега (файл modules/reviews/views/reviews.view.show_template.php; по умолчанию шаблон modules/reviews/views/reviews.view.show.php).

В шаблоне тега можно получить значение любого атрибута через переменную $result["attributes"]["название атрибута"].

show_block – выводит последние отзывы.

Атрибуты:

— count – количество выводимых отзывов (по умолчанию 3);

— modules – модули (разделенные запятой), к которым подключены отзывы;

— element_id – идентификаторы элементов модулей (разделенные запятой), к которым подключены отзывы;

— element_type – тип данных (element – элемент (по умолчанию), cat – категория, brand – производитель);

— sort – сортировка отзывов: date – по дате (по умолчанию), rand – в случайном порядке;

— defer – маркер отложенной загрузки шаблонного тега: event – загрузка контента только по желанию пользователя при нажатии кнопки "Загрузить", emergence – загрузка контента только при появлении в окне браузера клиента, async – асинхронная (одновременная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, sync – синхронная (последовательная) загрузка контента совместно с контентом шаблонных тегов с тем же маркером, по умолчанию отложенная загрузка не используется, обычный вывод шаблонных тегов в коде страницы;

— defer_title – текстовая строка, выводимая на месте появления загружаемого контента с помощью отложенной загрузки шаблонного тега;

— template – шаблон тега (файл modules/reviews/views/reviews.view.show_block_template.php; по умолчанию шаблон modules/reviews/views/reviews.view.show_block.php).

В шаблоне тега можно получить значение любого атрибута через переменную $result["attributes"]["название атрибута"].

База данных

{reviews} – Отзывы

{reviews_param} – Дополнительные поля отзывов

{reviews_param_element} – Значения дополнительных полей отзывов

{reviews_param_select} – Варианты значения дополнительных полей отзывов с типом список

Файлы

1. modules/reviews/admin/js/reviews.admin.inc.config.js – поле "Комментарии", JS-сценарий;

2. modules/reviews/admin/reviews.admin.php – редактирование отзывов;

3. modules/reviews/admin/reviews.admin.config.php – настройки модуля;

4. modules/reviews/admin/reviews.admin.count.php – количество непроверенных отзывов, если подключено модерирование отзывов, для меню административной панели;

5. modules/reviews/admin/reviews.admin.dashboard.php – отзывы для событий;

6. modules/reviews/admin/reviews.admin.param.php – конструктор отзывов;

7. modules/reviews/reviews.php – контроллер;

8. modules/reviews/reviews.action.php – обработка запроса при добавления комментария;

9. modules/reviews/reviews.install.php – установка модуля;

10. modules/reviews/reviews.model.php – модель;

11. modules/reviews/views/reviews.view.form.php – шаблон формы добавления комментария;

12. modules/reviews/views/reviews.view.id.php – шаблон одного отзыва;

13. modules/reviews/views/reviews.view.images.php – шаблон прикрепленных к отзыву изображений, выводимых в форме добавления отзыва;

14. modules/reviews/views/reviews.view.rows.php – шаблон вывода отзывов;

15. modules/reviews/views/reviews.view.rows_block.php – шаблон блока отзывов;

16. modules/reviews/views/reviews.view.show.php – шаблон вывода отзывов;

17. modules/reviews/views/reviews.view.show_block.php – шаблон блока отзывов.