Главная » MODx- профессиональный инструмент для разработки сайтов » Подключение комментариев к сайту сниппет Jot в MODx Evo
    РейтингРейтингРейтингРейтингРейтинг

Подключение комментариев к сайту сниппет Jot в MODx Evo

Для создания комментариев на сайте MODx используется сниппет 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

&action=`count-comments`

&authorid

id автора

Автор комментария

&authorid=``

&badwords

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

нет

&badwords= ``

&bw

Действие при обнаружении нецензурных выражений из параметра badwords
0 - опубликовывает
1 - не опубликовывает
2 - отклоняет комментарий. В особых случаях сообщение теряется навсегда

1

&bw=`2`

&canedit

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

нет

&canedit=``

&canmoderate

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

нет

&canmoderate=``

&canpost

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

нет

&canpost=``

&canview

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

нет

&canview=``

&captcha

Использование CAPTCHA кода
0 = отключение
1 = включение
2 = включение, но только для незарегистрированных и не авторизованных пользователей

0

&captcha=`2`

&css

Подключение стилей в заголовок шаблона
0 - не включать <link rel="stylesheet" src="assets/snippets/jot/templates/jot.css" /> в заголовок шаблона, в тег <HEAD></HEAD>
1 - включить <link rel="stylesheet" src="assets/snippets/jot/templates/jot.css" /> в заголовок шаблона

1

&css=`0`

&cssFile

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

assets/snippets /jot/templates/jot.css

&cssFile=``

&cssRowAlt

CSS стиль имя класса для альтернативно строки

нет

&cssRowAlt=``

&cssRowAuthor

CSS стиль имя класса для строки автора

нет

&cssRowAuthor=``

&cssRowMe

CSS стиль имя класса для текущего пользователя

нет

&cssRowMe=``

&customfields

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

name, email

&customfields=``

&debug

Отладка

0

&debug=`1`

&docid

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

Родительский документ

&docid=`23`

&guestname

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

anonymous

&guestname =`Гость`

&moderated

Модерация комментариев
0 - новые комментарии будут опубликованы
1 - новые комментарии будут не опубликованы

0

&moderated=`1`

&notify

Оповещение модераторов
Веб-группы модераторов указываются в параметре canmoderate
0 = без оповещений
1 = оповещать о новых не опубликованных комментариях
2 = оповещать о всех новых комментариях

1

&notify=`2`

&notifyAuthor

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

0

&notifyAuthor=`1`

&numdir

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

1

&numdir=`0`

&output

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

1

&output=`0`

&pagination

Число комментариев на одной странице
0 - отключение, показывать все комментарии на одной странице (стандартное значение)
1 > любое числовое значение

0

&pagination=`10`

&placeholders

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

0

&placeholders=`1`

&postdelay

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

15

&postdelay=`10`

&sortby

Сортировка комментариев
имя поля:a - по возрастанию
имя поля:d - по убыванию

createdon:d

&sortby=``

&subjectAuthor

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

нет

&subjectAuthor=``

&subjectModerate

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

нет

&subjectModerate=``

&subjectSubscribe

Тема в оповещении на почту для подписчиков

нет

&subjectSubscribe=``

&subscribe

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

0

&subscribe=`1`

&tagid

Дополнительные тег для использования в случаях, когда один и тот же docid используется два раза
строка [A-Za-z0-9]

нет

&tagid=`tag`

&title

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

longtitle

&title=``

&tplComments

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

chunk. comment.inc.html

&tplComments=``

&tplForm

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

chunk. form.inc.html

&tplForm=``

&tplModerate

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

chunk. moderate.inc.html

&tplModerate=``

&tplNav

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

chunk. navigation.inc.html

&tplNav=``

&tplNotify

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

chunk. notify.inc.txt

&tplNotify=``

&tplNotifyAuthor

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

chunk. notify.author.inc.txt

&tplNotifyAuthor=``

&tplNotifyModerator

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

chunk. notify.moderator.inc.txt

&tplNotifyModerator=``

&tplSubscribe

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

chunk. subscribe.inc.html

&tplSubscribe=``

&trusted

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

нет

&trusted=``

&validate

Проверка полей на правильность заполнения
Синтаксис: fieldname:message(:validation)
Если поле добавлено в validate то оно становится обезательным для заполнения. Возможные значения:
number
email
регулярное выражение
Примеры.
Обязательное поле:
MyRequiredField:Поле обязательно должно быть заполнено!
Проверка электронной почты:
MyEmailField:Адрес электронной почты внесён вами не правильно.:email
Проверка на числовое значение:
MyNumberField:Номер дома должен быть в цифровом значении.:number
Комбинация требований:
MyRequiredField:Поле обязательно должно быть заполнено!,MyEmailField:Адрес электронной почты внесён вами не правильно.:email,MyNumberField:Номер дома должен быть в цифровом значении.:number

content:You forgot to enter a comment.

&validate= `MyRequiredField:Поле обязательно должно быть заполнено!, MyEmailField:Адрес электронной почты внесён вами не правильно.:email, MyNumberField:Номер дома должен быть в цифровом значении.:number`



Примеры

С оповещением на эл.почту, с постраничной навигацией: 8 комментариев на странице.

[ !Jot? &subscribe=`1` &pagination=`8`! ]

Пример расположения блоков

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

[ !Jot? &placeholders=`1` &output=`0` &pagination=`10` &captcha=`1` &canmoderate=`Jot Moderators` &badwords=`` &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+ ] - Четвертый. Место на странице для навигации

Настройка стиля

jot.css — файл с настройками стиля отображения находится в папке assets/snippets/jot/templates/jot.css


css template

Не забывайте написать ваш комментарий, понравилась ли статья. От вас пару слов, а мне — признание поисковых систем, что пишу нормальные человеческий статьи. Заранее спасибо вам!