Главная / Документация / Полное руководство / Надмодули /

Модуль «Комментарии» подключается к другим модулям. В стандартной комплектации diafan.CMS «Комментарии» подключены к следующим модулям: Фотогалерея, Новости, Статьи, Вопрос-Ответ, Магазин, Файлы, Страницы сайта. Подключение комментариев в рамках модуля настраивается в конфигурации конкретного модуля.

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

Подключение

Подключаемая часть – файл modules/comments/comments.inc.php. В нем описан класс Comments_inc. В модуле к объекту классам можно обратится через переменную $this->diafan->_comments.

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

Методы

string get() – показывает комментарии, прикрепленные к элементу, и форму добавления комментария.

access: public

Пример

 // получаем комментарии к новости и форму добавления комментария в файле modules/news/news.model.php  
$comments = $this->diafan->_comments->get(); 
// выводим комментарии в шаблоне модуля в файле modules/news/news.view.php   
echo $comments;

Как добавлять комментарии к модулю

В конфигурации модуля (modules/модуль/admin/модуль.admin.config.php) и в файле редактирования элементов модуля (modules/модуль/admin/модуль.admin.php) необходимо добавить параметр 'comments':

$this->variable_table = array(…, 'comments' => 'module', …);

Административная часть

В административной части модуля собираются все комментарии в одну таблицу и отображаются в порядке поступления. Комментарии можно сортировать по принадлежности к отдельному элементу. Для этого предусмотрены ссылки «Комментарии» в административной части модулей, к которым подключаются комментарии. К примеру, при редактировании фотографии появится ссылка «Комментарии» на комментарии к этой фотографии или надпись «Комментариев нет» при их отсутствии.

Кнопка служит для удаления комментария. Кнопка служит для быстрой публикации комментария (или, наоборот, блокирования).

При удалении какого-либо элемента, удаляются все комментарии, прикрепленные к нему.

Комментарии имеют следующие характеристики.

Основные:

Комментарий;
Дата добавления;
Показывать на сайте – публикация на сайте, активность;
Объект – объект, к которому прикреплены комментарии, ссылка на все комментарии к этой странице;
Пользователь – пользователь, добавивший комментарий (если комментарий добавлен зарегистрированным пользователем).

Настройки

Только для зарегистрированных пользователей – параметр позволяет запретить незарегистрированным пользователям добавлять комментарии.

Использовать защитный код – для добавления комментария пользователь должен ввести защитный код, комментировать могут все.

Модерация сообщений – комментарий не появится на сайте пока администратор не сделает его активным.

Ваше сообщение уже имеется в базе – сообщение пользователю при попытке повторного добавления сообщения.

Спасибо! Ваш комментарий будет проверен в ближайшее время и появится на сайте. – сообщение пользователю при удачном добавлении комментария

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

Отображать имя пользователя, добавившего комментарий.

Количество комментариев на странице.

Формат даты – позволяет настроить отображение даты в модуле.

CSS-форматирование

Форма добавления комментария:

.comments_form{} – форма добавления комментариев

.comments_form h2{} – заголовок «Оставьте комментарий»

.comments_form .button{} – кнопка «Отправить»

.comments_form .inptext{} – текстовое поле для комментария

Список комментариев:

.comments{} – список комментариев

.comments_date{} – дата добавления комментария

.comments_name{} – имя автора комментария

.comments .avatar {} – аватар автора комментария

.comments_text{} – текст комментария

Файлы

modules/comments/comments.inc.php – формирование вывода комментариев;
modules/comments/comments.view.php – шаблон вывода;
modules/comments/comments.ajax.php – обработка запроса на добавление комментария;
modules/comments/comments.install.php – установка модуля;
modules/comments/comments.js – JS-сценарий постраничной навигации комментариев;
modules/модуль/модуль.model.php – подключение комментариев к модулям;
modules/comments/admin/comments.admin.php – редактирование комментариев;
modules/comments/admin/comments.admin.edit.php – вывод комментариев в административной части модулей;
modules/comments/admin/comments.admin.save.php – сохранение комментариев в административной части модулей;
modules/comments/admin/comments.admin.del.php – удаление комментариев при удалении элементов модулей;
modules/comments/admin/comments.admin.config.php – конфигурация модуля.

← Модуль «Обратная связь»

Модуль «Форум» →

Не понятно? Уточните