Jot Комментарии пользователей

Jot
MODX Wiki
Перейти

Сниппет Jot дает возможность пользователям вашего сайта оставлять комментарии.

Установка

Первичная установка

Данный сниппет уже входит в комплект MODX Evolution, прежде чем устанавливать, убедитесь в том, что сниппет еще не установлен.

1. Скачайте и распакуйте архив.
2. Создайте папку «jot» в папке  assets/snippets/
3. Перенесите файлы из скаченного архива в папку jot
4. Создайте новый сниппет Jot и поместите в код сниппета содержимое файла jot.snippet.txt

Обновление

1. Скачайте последнюю версию сниппета
2. Сделайте Backup и удалите содержимое папки assets/snippets/jot
3. Скопируйте в эту папку файлы из скаченного архива
4. Обновите код сниппета Jot в административной панели MODX, поместив в него содержимое файла jot.snippet.txt

Параметры

Основные параметры

&action - Управление отображением

Формат: default | count-comments | count-subscriptions | comments | form
Значение по умолчанию: default
Примечание:
default - форма и коментарии
count-comments - счетчик-коментариев
count-subscriptions - счетчик-подписок
comments - комментарии
form - форма
Пример: 
&action=`count-comments`

&docid - Ссылка на документ

Формат: ID документа
Значение по умолчанию: родительский документ
Примечание:
Пример: 
&docid=`23`

&tagid - Дополнительные тег для использования в случаях, когда один и тот же docid используется два раза

Формат: строка [A-Za-z0-9]
Значение по умолчанию:
Примечание:
Пример: 
&tagid=`tag`

&subscribe - Оповещение по электронной почте

Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
0 - отключить возможность оповещения по эл.почте
1 - включить возможность оповещения по эл.почте.
Пример: 
&subscribe=`1`

&moderated - Модерация комментариев

Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Модератор может просматривать комментарии до публикации
0 - новые комментарии будут опубликованы
1 - новые комментарии будут не опубликованы
Пример: 
&moderated=`1`

&notify - Оповещение модераторов

Формат: 0 | 1 | 2
Значение по умолчанию: 1
Примечание:
Веб-группы модераторов указываются в параметре canmoderate
0 = без оповещений
1 = оповещать о новых не опубликованных комментариях
2 = оповещать о всех новых комментариях
Пример: 
&notify=`2`

&subjectSubscribe - Тема в оповещении на эл.почту для подписчиков

Формат: строка
Значение по умолчанию: нет
Примечание:
Пример: 
&subjectSubscribe=``

&subjectModerate - Тема письма для оповещения модератора

Формат: строка
Значение по умолчанию: нет
Примечание:
Пример: 
&subjectModerate=``

&captcha - Использование CAPTCHA кода

Формат: 0 | 1 | 2
Значение по умолчанию: 0
Примечание:
0 = отключение
1 = включение
2 = включение, но только для незарегистрированных и не авторизованных пользователей
Пример: 
&captcha=`2`

&badwords - Список фраз, запрещенных к использованию в комментариях

Формат: список фраз | имя чанка
Значение по умолчанию: нет
Примечание: Список фраз через запятую или имя чанка со списком фраз. Используется в сочетании с параметром bw
Пример: 
&badwords=`{{MyBadwordsChunk}}`

&bw - Действие при обнаружении нецензурных выражений из параметра badwords

Формат: 0 | 1 | 2
Значение по умолчанию: 1
Примечание:
0 - опубликовывает
1 - не опубликовывает
2 - отклоняет комментарий. В особых случаях сообщение теряется навсегда
Пример: 
&bw=`2`

&customfields - Список дополнительных полей с информацией о пользователе

Формат: дополнительные поля, через запятую
Значение по умолчанию: name,email
Примечание: Поля будут созданы в дополнительной таблице автоматически. Стандартное значение "name,email". (Примечание: В списке, через запятую, не должно быть пробелов)
Пример: 
&customfields=``

&authorid - id автора

Формат: ID автора
Значение по умолчанию: автор комментария
Примечание: По-умолчанию автор комментария.
Пример: 
&authorid=``

&title - Заголовок по умолчанию

Формат:
Значение по умолчанию: longtitle
Примечание: Используется для темы комментария, когда в форме поле заголовка оставлено пустым.
Пример: 
&title=``

&css - Подключение стилей в заголовок шаблона

Формат: 0 | 1
Значение по умолчанию: 1
Примечание:
0 - не включать <link rel="stylesheet" src="assets/snippets/jot/templates/jot.css" /> в заголовок шаблона, в тег <HEAD></HEAD>
1 - включить <link rel="stylesheet" src="assets/snippets/jot/templates/jot.css" /> в заголовок шаблона
Пример: 
&css=`0`

&cssFile - Альтернативный путь до файла стилей от корня сайта

Формат: путь к файлу
Значение по умолчанию: assets/snippets/jot/templates/jot.css
Примечание:
Пример: 
&cssFile=``

&sortby - Сортировка комментариев

Формат: список критериев через запятую
Значение по умолчанию: createdon:d
Примечание:
имя поля:a - по возрастанию
имя поля:d - по убыванию
Пример: 
&sortby=``

&numdir - Сортировка комментариев по их добавлению

Формат: 0 | 1
Значение по умолчанию: 1
Примечание:
0 - первый комментарий внизу
1 - первый комментарий вверху.
Пример: 
&numdir=`0`

&validate - Проверка полей на правильность заполнения

Формат:
Значение по умолчанию: content:You forgot to enter a comment.
Примечание:
Синтаксис: fieldname:message(:validation)
Если поле добавлено в validate то оно становится обезательным для заполнения. Возможные значения:
number
email
регулярное выражение
Примеры.
Обязательное поле:
MyRequiredField:Поле обязательно должно быть заполнено!
Проверка электронной почты:
MyEmailField:Адрес электронной почты внесён вами не правильно.:email
Проверка на числовое значение:
MyNumberField:Номер дома должен быть в цифровом значении.:number
Комбинация требований:
MyRequiredField:Поле обязательно должно быть заполнено!,MyEmailField:Адрес электронной почты внесён вами не правильно.:email,MyNumberField:Номер дома должен быть в цифровом значении.:number
Пример: 
&validate=`MyRequiredField:Поле обязательно должно быть заполнено!,MyEmailField:Адрес электронной почты внесён вами не правильно.:email,MyNumberField:Номер дома должен быть в цифровом значении.:number`

&guestname - Анонимное имя автора, не зарегистрированного и не авторизованного

Формат: строка
Значение по умолчанию: anonymous
Примечание:
Пример: 
&guestname=`Гость`

&postdelay - Число секунд ожидания между отправкой следующего сообщения тем же пользователем

Формат: секунды, как целое число
Значение по умолчанию: 15
Примечание:
Пример: 
&postdelay=`10`

&pagination - Число комментариев на одной странице

Формат: число
Значение по умолчанию: 0
Примечание:
0 - отключение, показывать все комментарии на одной странице (стандартное значение)
1 > любое числовое значение
Пример: 
&pagination=`10`

&placeholders - Добавление плэйсхолдеров

Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
0 - никаких плейсхолдеров не создано (по-умолчанию)
1 - плейсхолдеры созданы для каждого значения debug (смотрите параметр debug)
если tagid не найден, плесхолдеры создаются так:
[+jot.html.form+]
если tagid найден, плейсхолдеры будут созданы так:
[+jot.html.form.tagid+]
Пример: 
&placeholders=`1`

&output - Показать результаты

Формат: 1 | 0
Значение по умолчанию: 1
Примечание:
0 - спрятать результаты (может использоваться с параметром placeholder)
1 - показать результаты (по-умолчанию)
Пример: 
&output=`0`

&debug - Отладка

Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
0 - отключить вывод "скрытых" переменных. (По умолчанию)
1 - включить вывод "скрытых" переменных.
Пример: 
&debug=`1`

&trusted - Список доверенных веб-групп через запятую

Формат: список групп пользователей
Значение по умолчанию:
Примечание: Коммментарии пользователей из этих групп будут публиковаться по умолчанию, когда moderated установлен 1. Параметр badwords не применяется к этим группам.
Пример: 
&trusted=``

&canpost - Список веб-групп через запятую, которые могут размещять комментарии

Формат: список групп пользователей
Значение по умолчанию:
Примечание: Оставьте пустым, для публичного комментирования
Пример: 
&canpost=``

&canview - Список веб-групп через запятую, которые могут просматривать комментарии

Формат: список групп пользователей
Значение по умолчанию:
Примечание: Оставьте пустым для публичного просмотра.
Пример: 
&canview=``

&canedit - Список веб-групп через запятую, которые могут редактировать свои комментарии

Формат: список групп пользователей
Значение по умолчанию:
Примечание: Оставьте пустым для того чтоб пользователи не могли редактировать комментарии.
Пример: 
&canedit=``

&canmoderate - Список веб-групп через запятую, которые могут модерировать комментарии

Формат: список групп пользователей
Значение по умолчанию:
Примечание:
Пример: 
&canmoderate=``

&notifyAuthor - Информировать автора когда кто-то добавляет коментарии

Формат: 0 | 1
Значение по умолчанию: 0
Примечание:
Пример: 
&notifyAuthor=`1`

&subjectAuthor - Тема письма для оповещения автора

Формат: строка
Значение по умолчанию:
Примечание:
Пример: 
&subjectAuthor=``

Шаблоны

&tplForm - Шаблон формы добавления комментария

Формат: имя чанка
Значение по умолчанию: chunk.form.inc.html
Примечание:
Пример: 
&tplForm=``

&tplComments - Шаблон комментариев

Формат: имя чанка
Значение по умолчанию: chunk.comment.inc.html
Примечание: Повторяется для каждого комментария на странице
Пример: 
&tplComments=``

&tplModerate - Шаблон для модерации блока

Формат: имя чанка
Значение по умолчанию: chunk.moderate.inc.html
Примечание: Этот шаблон используется один раз над комментариями
Пример: 
&tplModerate=``

&tplNav - Шаблон для навигации

Формат: имя чанка
Значение по умолчанию: chunk.navigation.inc.html
Примечание: Этот шаблон применяется в верхней и частях блока
Пример: 
&tplNav=``

&tplSubscribe - Шаблон для блока подписки

Формат: имя чанка
Значение по умолчанию: chunk.subscribe.inc.html
Примечание:
Пример: 
&tplSubscribe=``

&tplNotify - Шаблон для уведомления подписчиков по электронной почте

Формат: имя чанка
Значение по умолчанию: chunk.notify.inc.txt
Примечание:
Пример: 
&tplNotify=``

&tplNotifyModerator - Шаблон для уведомления по электронной почте для модераторов

Формат: имя чанка
Значение по умолчанию: chunk.notify.moderator.inc.txt
Примечание:
Пример: 
&tplNotifyModerator=``

&tplNotifyAuthor - Шаблон для уведомлений по электронной почте для автора

Формат: имя чанка
Значение по умолчанию: chunk.notify.author.inc.txt
Примечание:
Пример: 
&tplNotifyAuthor=``

&cssRowAlt - CSS style classname for alternate row

Формат:
Значение по умолчанию:
Примечание:
Пример: 
&cssRowAlt=``

&cssRowMe - CSS style classname for current user row

Формат:
Значение по умолчанию:
Примечание:
Пример: 
&cssRowMe=``

&cssRowAuthor - CSS style classname for author row

Формат:
Значение по умолчанию:
Примечание:
Пример: 
&cssRowAuthor=``

Примеры

Простой вызов

  • с оповещением на эл.почту.
  • с постраничной навигацией: 10 комментариев на странице.
[!Jot? &subscribe=`1` &pagination=`10`!]

С альтернативной сортировкой

  • с оповещением на эл.почту.
  • с постраничной навигацией: 10 комментариев на странице.
  • комментарии сортируются начиная с самого старого.
[!Jot? &subscribe=`1` &pagination=`10` &sortby=`createdon:a`!]

Модерация

  • с оповещением на эл.почту.
  • с постраничной навигацией: 10 комментариев на странице.
  • новые комментарии не публикуются, их опубликовывает модератор.
  • автору не будут приходить уведомления. Вы должны создать веб-группу с веб-пользователями, которые бы выступали в качестве модераторов.
  • Но автор будет получать уведомления
    • если используется Jot 1.1.3+
    • менеджером является автор комментария
    • вы добавите &notifyAuthor=`1`
[!Jot? &subscribe=`1` &pagination=`10` &moderated=`1`!]

Расширенная модерация

  • с оповещением на эл.почту.
  • с постраничной навигацией: 10 комментариев на странице.
  • новые комментарии не публикуются, их опубликовывает модератор.
  • новые комментарии будут опубликованы лишь в том случае, если автор входит в состав группы "Доверенные Пользователи".
[!Jot? &subscribe=`1` &pagination=`10` &moderated=`1` &trusted=`Доверенные Пользователи`!]

Анти-спам: автоматический

  • с постраничной навигацией: 10 комментариев на странице.
  • с предоставлением динамически меняющейся картинкой с кодом (captcha).
  • если в чёрный список слов входит слово, используемое в комментарии, комментарий будет отклонён, возможно, что даже потерян.
  • чёрным списком фраз является чанк "myBadwordList"
[!Jot? &pagination=`10` &captcha=`1` &badwords=`{{myBadwordList}}` &bw=`2`!]

Анти-спам: с модерацией

  • с постраничной навигацией: 10 комментариев на странице.
  • с предоставлением динамически меняющейся картинкой с кодом (captcha).
  • если в чёрный список слов входит слово, используемое в комментарии, комментарий не будет опубликован, и модератор при этом будет оповещён.
  • веб-пользователи из группы "Модераторы комментариев" могут редактировать комментарии.
  • чёрным списком фраз является чанк "myBadwordList".
[!Jot? &pagination=`10` &captcha=`1` &canmoderate=`Модераторы комментариев` &badwords=`{{myBadwordList}}` &bw=`1`!]

Расположение блоков

Для того, чтобы изменить на странице место и порядок вывода блоков (форма, модерация, комментарии, навигация), поместите вызов сниппета, как обычно:

[!Jot? &placeholders=`1` &output=`0` &pagination=`10` &captcha=`1` &canmoderate=`Jot Moderators` &badwords=`{{myBadwordList}}` &bw=`1`!]

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

&placeholders=`1` &output=`0`

Теперь, разместите на странице с вызовом сниппета Jot следующие плейсхолдеры:

[+jot.html.navigation+] - Первый. Место на странице для навигации
[+jot.html.comments+] - Второй. Место на странице для комментариев
[+jot.html.moderate+] - Третий. Место на странице для модерации
[+jot.html.form+] - Четвертый. Место на странице для формы

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

[+jot.html.form+] - Первый. Место на странице для формы
[+jot.html.comments+] - Второй. Место на странице для комментариев
[+jot.html.moderate+] - Третий. Место на странице для модерации
[+jot.html.navigation+] - Четвертый. Место на странице для навигации

Поделитесь ссылкой

Статистика

Яндекс цитирования
© 2011 - 2023 Школа MODX
Напишите нам в Telegram