MODx Украина » Встроенные сниппеты » Jot

Jot

 

Jot — это сниппет для MODx, который даёт возможность пользователям cайта оставить отзыв о странице, комментарий к статьям, запись в гостевой книге.

Пример вызова:

[!Jot? &subscribe=`1` &pagination=`10` &captcha=`2` &title=`[*longtitle*]`!]

 

Параметры:

&pagination - Комментариев на странице;

&captcha (значения: 1,2,3) - CAPTHA код (1 - НЕТ, 2 - НЕТ если авторизован, 3 - всегда есть);

&title - Стандартное название коментария ( [*longtitle*] - Расширенный заголовок);

 

 

параметры значение описание
&action
  • default (форма & коментарии)
  • count-comments
  • count-subscriptions
  • comments
  • form

Что отображать при вызове.

  • по-умолчанию (форма & комментарии)
  • счетчик-коментариев
  • счетчик-подписок
  • комментарии
  • форма

 

&docid (Id документа в числе) Ссылка на экземпляр этого документа, по-умолчанию на родительский id.
&tagid (tagid как string[A-Za-z0-9]) Дополнительные тег для использования при случаях, когда используется тот же идентификатор документа.
&subscribe
  • 0 (по-умолчанию)
  • 1
  • 0 = отключает подписку.
  • 1 = включает подписку.
&moderated
  • 0 (по-умолчанию)
  • 1
  • 0 = новые комментарии будут опубликованы
  • 1 = новые комментарии будут не опубликованы
    Модератор / менеджер должен утверждать до публикации.
&notify
  • 0
  • 1 (по-умолчанию)
  • 2

Оповещять модератора &canmoderate по email

  • 0 = не оповещать
  • 1 = оповещать при появлении новых записей
  • 2 = оповещать при появлении любых записей
&subjectSubscribe (string) Тема письма для подписки по email.
&subjectModerate (string) Тема письма оповещения для модератора .
&captcha
  • 0 (по-умолчанию)
  • 1
  • 2
  • 0 = отключает captcha в форме.
  • 1 = включает captcha в форме.
  • 2 = включает captcha в форме, но отключает captcha для авторизованых.
&badwords (слова через кому которые не должны быть в комментариях) Лучше всего создать чанк с плохими словами и вызвать в Jot так:
                &badwords=`{{MyBadwordsChunk}}`
чтобы включить централизованое управление списком плохих слов.

Используйте &bw параметр для указания мер по выявлению плохих слов.

&bw
  • 0
  • 1 (по-умолчанию)
  • 2
Когда плохие слова заданы в &badwords то Jot:
  • 0 = ничего не сделает.
  • 1 = не будет публиковать плохой комментарий.
  • 2 = будет отклонять коментарий.
&customfields (список специальных названий полей в форме разделеных комой) С помощью этой команды будут сохранены специальные поля при отправке .

по-умолчанию это  "name,email". (Примечание: Убедитесь, что нет пробелов в  списке пользовательских полей в вызове Jot.)

&authorid (id автора) по-умолчанию автор текущего документа.
&title (title комментария) по-умолчанию это расширенный заголовок текущего документа.

Используется для темы комментария когда, в форме поле оставлено пустым.

&css
  • 0
  • 1 (по-умолчанию)
  • 0 = по-автомату не включать CSS стили JOT в header документа.
  • 1 = по-автомату включать CSS стили JOT в header документа.
&cssFile (относительный путь от корня к CSS файлу) по-умолчанию путь к jot.css
&sortby (упорядоченный string через кому) Синтаксис:

fieldname:a (по возрастанию) или fieldname:d (по убыванию) по-умолчанию to "createdon:d".

&numdir
  • 0
  • 1 (по-умолчанию)
  • 0 = первый комментарий наименшее число.
  • 1 = первый комментарий наибольшее число.
&validate (string разделенная коммами, для валидации формы) Синтаксис: fieldname:message(:validation)

Если поле добавлено в &validate то оно становится обезательным. Если проверка опущена то предполагается, что оно обезательно. Остальные проверки:

  • Телефон
  • email
  • пользовательское регулярное выражение

Примеры:

  • required поле:
    • "MyRequiredField:This field is required!"
  • чтобы проверять электронную почту:
    • "MyEmailField:Not a valid e-mail address.:email"
  • чтобы проверить номер телефона:
    • "MyNumberField:Not a number.:number"
  • Комбинации проверок:
    • "MyRequiredField:This field is required!,MyEmailField:Not a valid e-mail address.:email,MyNumberField:Not a number.:number"

 

по-умолчанию "content:You forgot to enter a comment."

 

&guestname (string) Имя человека который не указал его в форме. Например, Гость.

по-умолчанию: anonymous.

&postdelay (секунды в числовом формате) Какие промежутки времени должны проходить между размещением комментариев одним пользователем.

Введите 0 чтобы выключить, по-умолчанию : 15 с.

&pagination (количество коментариев на страницу)
  • 0 = выключено, показывать все комментарии на одной странице (по-умолчанию)
  • 1 > включено разбиение на страницы с соответствующим числом комментариев на страницу.
&placeholders
  • 0
  • 1
  • 0 = никаких плейсхолдеров не создано(по-умолчанию)
  • 1 = плейсхолдеры созданы для каждого debug value (смотрите &debug параметр)
    • если tagid не найден, плесхолдеры создаются так:
                                      [+jot.html.form+]
    • если tagid найден, плейсхолдеры будут созданы так:
                                      [+jot.html.form.tagid+]
&output
  • 0
  • 1
  • 0 = спрятать выдачу(может использоваться с &placeholder параметром)
  • 1 = показать выдачу (по-умолчанию)
&debug
  • 0
  • 1
  • 0 = выключить выдачу of jot "hidden" variables. (по-умолчанию)
  • 1 = включить выдачу of jot "hidden" variables.
&trusted (веб группы через кому) Доверенные веб группы через кому.

Опубликовано по-умолчанию когда &moderated установлен 1. Список исключенных плохих слов не фильтруется для етих групп. Менеджеры всегда доверенные.

&canpost (веб группы через кому) Веб-группы которые могут размещять комментарии.
Оставьте пустым для публичного комментирования.
&canview (веб группы через кому) Веб-группы которые могут смотреть комментарии.

Оставьте пустым для публичного просмотра.

&canedit (веб группы через кому) Веб-группы которые могут редактировать СВОИ комментарии.

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

&canmoderate (веб группы через кому) Веб-группы которые могут модерировать комментарии.

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

&notifyAuthor
  • 0 (по-умолчанию)
  • 1
Информировать автора когда кто-то добавляет коментарии(v 1.1.3+)
&subjectAuthor (string) Тема письма для оповещения автора (v 1.1.3+)

 

Источник wiki.modxcms.com

P.S. Это любительский перевод, поэтому могут быть недочеты.

   

Понравилась статья?

Тогда подпишитесь на:

  1. RSS-ленту
  2. Email рассылку
  3. Twitter ленту
  4. Facebook ленту или нашу Facebook страницу!

Также вас могут заинтересовать:


Комментариев
Комментарии работают на Disqus