Quip

Что такое Quip?

Quip - сниппет простого комментирования для MODX Revolution. Он позволяет быстро и легко писать комментарии на своем сайте, в том числе с поддержкой веток, модерации, преобразованием url в ссылки, автоматическим закрытием тем и многое другое. Он также позволяет полностью управлять комментариями через админку системы или сайта.

Требования

MODX Revolution 2.0.0 RC2 или новее

PHP5 или новее

История

Quip был написан Шоном Маккормиком как компонент простого комментирования, первый релиз состоялся 7 мая 2009 года.

Скачать

Компонент можно скачать через админку MODX Revolution с помощью менеджера пакетов или из репозитория дополнений MODX, это здесь: http://modx.com/extras/package/quip

Документацию по API для Quip можно найти здесь: http://api.modx.com/quip/

Использование

Quip работает в 2-х режимах - древовидные комментарии и обычные

Обычные комментарии

Сниппет Quip можно вызвать на странице там, где вы хотите показать комментарии, вот так:



Древовидные комментарии

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

<h2>Reply to Thread</h2>

<br />

Вам не нужно задавать другие параметры в этом вызове, так как они будут взяты из вашего оригинального вызова QuipReply на главной странице темы.

И затем вам нужно будет добавить параметр "replyResourceId" в ваш исходный вызов сниппета Quip на странице, где будут загружаться комментарии (например, в блоге), так это будет выглядеть с ресурсом, у которого id 123:


<br />

Кроме этого, Quip дает возможность пользователям с помощью вызова сниппета QuipCount получить количество ветвей комментариев или обычных комментариев пользователей.

Сниппеты Quip

Quip поставляется с 4 отдельными сниппетами:

  • Quip - показывает комментарии для ветки
  • QuipReply - отображает форму для ответа в ветке
  • QuipCount - возвращает количество комментариев в ветке
  • QuipLatestComments - отображает список последних комментариев для все веток, пользователей или конкретной ветки.

Системные настройки

Quip поставляется с предварительно заданными некоторыми параметрами, распространяющимися на весь сайт.

Ключ Описание
quip.emailsFrom Email, от которого будут отсылаться системные письма и письма для модерации.
quip.emailsTo Email, на который будут отсылаться системные письма и письма для модерации.
quip.emailsReplyTo Email, который будет установлен в поле reply-to. По умолчанию поле emailFrom.
quip.allowedTags Теги разрешеннные пользователям в комментариях. Смотрите список возможных значений тут php.net/strip_tags

Кроме того есть 3 настройки для поддержки reCaptcha в пространстве имен recaptcha:

Ключ Описание
recaptcha.public_key Ваш публичный ключ для reCaptcha
recaptcha.private_key Ваш секретный ключ для reCaptcha
recaptcha.use_ssl Если да, будет использован протокол SSL для подключения reCaptcha

Примеры

Строка с простым кодом для поста в блоге, который в ресурсе без ветвления:


Показать комментарии для ветки "post45", но только для зарегистрированных пользователей и будет видна кнопка "Ответить в теме" для ресурса с ID 123:


<br />

Показать комментарии для ветки "spamproof123" без ветвления, но с поддержкой reCaptcha.


<br />

  • Реклама

  • Недавние публикации

  • Недавние комментарии

© 2011 — 2014 MODX Беларусь
По всем вопросам обращаться в компанию Alroniks Experts