Перед установкой

Загрузка

Используя панель управления MODX, перейдите в Управления пакетами в строке поиска пакетов, наберите "modxTalks", загрузите и установите пакет.

Исходный код расположен на github.com

Подключение modxTalks на сайте

Есть два способа подключения комментарие для вашего сайта.

Создание ресурса с комментариями

Чтобы создать ресурс с комментариями, достаточно щелкнуть правой кнопкой мыши на ресурс в дереве, а затем перейти на "Создать", вы должны увидеть это:

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

Вставка снипета в удобное место в сайте

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

[[!modxTalks]]

Убедитесь, что снипет вызываете не кэшированный

Основная настройка

Основные настройки modxTalks находяться в Настройки системы, в разделе "modxtalks".

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

Настройка modxTalks в ресурсе

После создания ресурса с комментариями, у вас появится вкладка с настройками для комментариев

1

Показывает количество не потверждённых комментариев привязанных к данному ресурсу.

2

Показывает количество удалённых комментариев привязанных к данному ресурсу.

3

Показывает общее количество комментариев привязанных к данному ресурсу.

4

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

5

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

6

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

7

Шаблон для вывода удалённых комментариев. Оставьте не заполненным, если хотите использовать настройки по умолчанию.

8

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

9

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

Вызов modxTalks через снипет

Для простого вызова снипета modxTalks, в удобном месте шаблона или чанка ресурса, мы ставим вызов [[!modxTalks]]

В снипете доступны следующие параметры вызова.

Для вывода последних комментариев на вашем сайте. достаточно установить вызов снипета [[!modxTalksLatestComments]]

Параметры снипgета // Параметры сниппета modxTalksLatestComments

Пример подключения скриптов // на странице с вызовом последних комментариев

<script src="[[++assets_url]]components/modxtalks/js/web/lib/jquery-1.9.min.js" type="text/javascript"></script>
<script src="[[++assets_url]]components/modxtalks/js/web/lib/timeago.js" type="text/javascript"></script>
<script src="[[++assets_url]]components/modxtalks/js/web/lib/timeago/ru.js" type="text/javascript"></script>

Вы можете указать свой созданный шаблон ориентируясь и сохраняя логику шаблона, примеры шаблонов можете посмотреть на github.com или посмотреть у себя на сервере, в директории - путь к папке core/ components/modxtalks/elements/chunks

commentTpl // Шаблон для вывода комментариев

deletedCommentTpl // Шаблон для вывода удалённых комментариев

commentAddFormTpl // Шаблон формы добавления комментария

commentEditFormTpl // Шаблон формы редактирования комментария

comment_auth_tpl // Шаблон формы авторизации

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

mt_send_mail // Шаблон для писем и уведомлений

Вы можете изменить дизайн или элементы дизайна на своё усмотрение

comment_latest // Шаблон отдельного комментария для блока.

Шаблон отдельного комментария для блока. Может быть название чанка. Если установленно значение, то заменит исходный шаблон.

comments_latest_out // Шаблон оболочки комментариев для блока.

Шаблон оболочки комментариев для блока. Может быть название чанка. Если установленно значение, то заменит исходный шаблон.

Параметры

Событие OnModxTalksCommentAfterAdd вызываеться при добавлении комментария.

Наверное каждый задаётся вопросом о выводе в ленте новостей к примеру, количества комментариев в ресурсе.

Расмотрим пример вывода ресурса через getPage или getResources. Откроем ваш чанк вывода ресурса и вставим на место отображения количества комментария тег {%mtr_[[+id]]%}

Пример чанка

Пример чанка для getResources.

... ...
<div class="comments"><i class="icon-eye-open">comments {%mtr_[[+id]]%}</i></div>
... ...

Если вы вызываете комментарии через снипет и у вас своя структура привязки к ресурсу, то вызов должен состоять такой-же как и название, которое вы вставили или сформировали в самом вызове снипета

Вызов тега в таком случае будет следующий: {%mtc_myBlog-2%} - myBlog-2, это и есть само название conversation