Сниппет Jot

Опубликовано: 19 Мая 2014

Сниппет 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= `{{MyBadwordsChunk}}`

&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=`{{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+] - Четвертый. Место на странице для навигации

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

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

 

Комментарии (0)


Оставить комментарий




Разрешённые теги: <b><i><br>Добавить новый комментарий: