Полноценные комментарии D7 под Битрикс
 

Настройки модуля

В настройках модуля собраны все основные параметры, влияющие на ключевые механизмы модуля.

Администрирование

Полноценные комментарии D7 под Битрикс. Документация. Настройки модуля

Доменное имя сайта — обязательно должно быть указано. Используется при проверке на безопасность аякс-запросов а также во всех почтовых шаблонах. Как правило, указывается основное доменное имя, например: «site.ru». Основное доменное имя прописывается автоматически при установке и заносится в список параметров по умолчанию.

«Доменное имя сайта» поддерживает мультидоменность — когда у вас многосайтовость настроена на разных доменах. В этом случае список доменных имён указывается через запятую. При составлении почтовых уведомлений для построения адресов к страницам обсуждения используется параметр HTTP_HOST массива $_SERVER.

Электронный адрес менеджера, на который будут отправляться копии всех исходящих писем — и тех, что предназначались программисту и тех, что были отправлены администратору. Несколько адресов указываются через запятую без пробелов. Данный параметр является рекомендательным. Фактически это аналог общего для всего сайта параметра «E-Mail адрес или список адресов через запятую на который будут дублироваться все исходящие сообщения», только в рамках конкретного модуля.

Электронный адрес администратора, на который будут отправляться все технические уведомления а также письма про возникшие в работе ошибки. Несколько адресов указываются через запятую без пробелов. Администратор будет получать письма про каждый новый комментарий, его содержание и размещение; в частности — уведомления про неактивные сообщения (если комментарий не прошёл стоп-фильтр или в настройках компонента стоит указание деактивировать все новые комментарии). Кроме того, во всех значимых местах программного кода расставлены проверочные условия, которые могут выявить ошибки в работе. Наиболее распространённые ошибки: не хватает прав доступа к файлам или папкам. Если всё делать через механизм установки модуля и сам сайт проинсталлирован с правильными правами доступа, таких ошибок не возникает.

Электронный адрес программиста или администратора (несколько адресов указываются через запятую без пробелов), на который приходит уведомление про любой загруженный файл (даже при попытке что-то загрузить, без фактического комментария). Один из барьеров от вживления скриптов взлома (в частности phpBackDoor). Адресат получает уведомление в любом случае: опубликован комментарий или нет — каждая загрузка файла сопровождается письмом-уведомлением, в котором информация про загруженный файл и данные про запрос: IP, HTTP_REFERRER, COOKIE.

GET-ключи в урле, которые подлежат чистке (чтобы в режиме отладки ветка комментариев отображала общение по реальному урлу). Указывается базовый список для всего сайта, ключи через запятую без пробелов. В каждом размещённом компоненте можно этот список дополнить особыми ключами. Читать: логика использования GET-ключей. Внимание! Если вы не используете ЧПУ (человеко-понятные урлы), удалите из этого списка параметры, которые вам нужны (например, чтобы не чистился из урла SECTION_ID или ELEMENT_ID). Если же конечные страницы на ЧПУ, оставьте набор ключей по умолчанию — практика показывает, что всех их в конечном итоге нужно чистить.

Время в минутах, в течении которого зарегистрированный пользователь может редактировать своё сообщение. Если пусто или ноль — возможность редактировать сообщение не предоставляется.

Период «устаревания» комментария. Указывается количество в часах или днях, после истечения которых сообщение считается устаревшим. В стилях предусмотрен css-класс _fresh, которым маркируются свежие комментарии. Если поле пустое — механизм не задействован. Если нужно указать количество в днях — просто внести число, например: «1» (буквально: сутки — 24 часа). Если нужно указать количество в часах, указывается число с суффиксом «h», например: «2h» Значение по-умолчанию: 1h

Сообщение для маркировки скрытых модератором комментариев — фраза, на которую заменяется текст комментария, когда его скрывает модератор. Зачастую так бывает, что определённый комментарий в ветвлении обсуждения «бракуется» цензором и потому не может быть допущен к дальнейшему отображению. Однако если в подветках под ним есть полезные комментарии, этот бракованный комментарий удалить не представляется возможным. В таком случае модератор может скрыть текст комментария. В этом случае вместо текста комментария отображается фраза из данного свойства. Например: «Комментарий скрыт модератором». Модератор продолжает видеть текст комментария и может в любой момент его раскрыть.

Заголовок страницы. При сохранении информации о странице, на которой оставлен комментарий, модуль пытается определить её заголовок. Заголовок используется в компоненте «Последние комментарии» при публикации названия страницы, на которой оставлен комментарий. В данной настроке нужно выбрать, какое поле считать главным в этом случае (если заголовок не будет определён по главному полю, модуль попробует определить его по альтернативному — альтернативное отображается тут же, в списке выбора).

Поддерживать заголовок страницы в актуальном состоянии. Чекбокс указывает, как поступать в том случае, если при очередном комментарии оказалось, что заголовок страницы не совпадает с тем, который был определён ранее. Установленный чекбокс говорит о том, что прежний заголовок следует заменить на новый.

Внешний вид

Полноценные комментарии D7 под Битрикс. Документация

На данной вкладке вы можете изменить настройки ресайзов для картинок. Параметры ширины и высоты обозначают прямоугольную область, в которую будет пропорционально вписано изображение.

Дата-атрибут, которым будут маркироваться изображения-превью для всплывающей галереи. Если не установлено ничего, используется data-image-id — превью картинок маркируются специальным атрибутом, по которому всплывающая галерея собирает фото для отображения. Если дата-атрибут по-умолчанию (data-image-id) совпадает с атрибутом, который уже используется в вашем проекте, вы можете переименовать здесь его.

Голосование. Не показывать расширенную информацию при составном нуле (когда например три плюса и три минуса, то есть какая-то реакция на комментарии всё-таки происходила). По-умолчанию показывается расширено, например: 0(+3/-3)

Дополнительный css-код. В модуль встроен механизм, позволяющий интегрировать в дополнение к стандартным стилям свой css-код. Это полезно тогда, когда возникает необходимость переопределить некоторые правила. Например, изменить цвет, отступы, размеры и так далее. Код, размещённый в свойстве «Дополнительный css-код», записывается в файл
/bitrix/components/realcommenter_2.0/tape.show.tree/templates/.default/user_custom.css
... и при установленном чекбоксе «активировать использование» подключается к документу через стандартный механизм (то есть поддерживаются все механизмы оптимизации и объединения css-файлов).

Аватар, сопровождающий комментарий зарегистрированного пользователя берётся из поля Личные данные / Фотография карточки пользователя.

Полноценные комментарии D7 под Битрикс. Документация

Визуальный редактор

Форма сбора комментариев может работать в двух режимах: с использованием визуального редактора (по умолчанию) и без. Обработка текста нового комментария, для сбора которого используется визуальный редактор, производится с применением всех правил Стоп-фильтра. К тексту комментария, для которого визуальный редактор отключен, применяются только фильтры, отвечающие за стоп-слова, html-теги запрещены.

Полноценные комментарии D7 под Битрикс. Документация

Распознавать линки с youtube, vimeo. Если в тексте встречается ссылка на видео-ролик, например: http://www.youtube.com/watch?v=K4RMHIPEKoU, она будет заменена на видео-вставку. Для полноценной работы необходима включённая опция "Задействовать линко-детектор".

Ширина и высота для видео-блока. Каждое видео, найденное по механизму обнаружения видео-ссылок, будет сконвертировано в видео-вставку. Данные параметры указывают ширину и высоту видео-фрейма. По умолчанию: 560×315.

Задействовать линк-детектор. Будет производится поиск в тексте сообщения на предмет интернет-ссылок, которые нужно оформить в html-тег. Обнаруживает как адреса, начинающиеся на http, https, так и на www

Закрывать ссылки (теги <a>) в тег <noindex>. Если установлен данный параметр, все найденные в сообщении ссылки будут помещены в тег noindex. Данная опция не применяется к ссылкам, ведущим на этот же домен.

Маркировать ссылки аттрибутом rel="nofolow". При включенном данном параметре, все ссылки, найденные в тексте, будут промаркированы аттрибутом rel="nofollow". Не применяется к ссылкам, ведущим на этот же домен.

Настройки стоп-слов и условий для стоп-фильтра

Ограничения по стоп-словам и стоп-тегам не срабатывают для сообщений от модераторов.

Полноценные комментарии D7 под Битрикс. Документация

В данной вкладке администратор настраивает список слов, которые он считает нецензурными либо такими, наличие которых недопустимо к использованию при общении. Стоп-слова и условия заполняются каждая с новой строки. Поиск в стоп-фильтре регистронезависимый, то есть не зависит от регистра букв: прописные, строчные в любой комбинации.

Доступны два вида списка:

  • список для простого поиска — точное вхождение конкретного слова;
  • поиск по технологии регулярных выражений.

Следующая группа параметров указывает стоп-фильтру правила для поведения с html-тегами. Каждое сообщение проверяется на наличие тегов а также нет ли ошибок при использовании парных тегов.

Если для комментариев отключен визуальный редактор, все без исключения теги будут вычищены.

Список разрешённых тегов. Список тегов, которые считаются разрешёнными. Если стоп-фильтр находит тег из этого списка, он его пропускает. Указывать следует только тела тегов (br, em, span), разделяя их новой строкой.

Список запрещённых тегов. Список тегов, которые запрещёны к использованию. Если стоп-фильтр находит в сообщении тег из данного списка, он возвращает в форму предупреждение с указанием тега, который запрещён к использованию. Данный список не участвует в проверке, если установлен параметр «Чистить всё кроме разрешённых и пропускать». Указывать следует только тела тегов (iframe, object, script), разделяя их новой строкой.

Чистить всё кроме разрешённых и пропускать. Если установлен данный параметр, стоп-фильтр оставляет в сообщении только те теги, которые находятся в списке разрешённых, остальные чистит и пропускает сообщение без стоп-предупреждения (если не сработало другое стоп-условие, например — встретилось ругательное слово, которое отслеживается в стоп-словах).

Комбинацией указанных параметров можно покрыть всевозможные ситуации. Например: список разрешённых и список запрещённых тегов пуст, но стоит опция на чистку. Тогда из сообщения будут удалены все теги и сообщение будет пропущено дальше. Или задать только список запрещённых тегов, а все остальные будут пропускаться.

Следует помнить, что стоп-фильтр не применяется для сообщения, отправленного модератором.

Валидация с помощью reCaptcha

Настройками активируется механизм валидации через Google reCaptcha. На выбор вторая и третья (в разработке) версии. reCaptcha подключается к форме комментирования, если пользователь не прошёл валидацию, он не сможет добавить комментарий.

Полноценные комментарии D7 под Битрикс. Документация

Расширенные поля

Полноценные комментарии D7 под Битрикс. Документация

Например, если стоит задача запустить сбор отзывов о товаре, — обычной формы комментирования с одним текстовым полем нам будет недостаточно. В модуль встроен механизм, позволяющий составить свой набор полей для формы комментирования, например чтобы форма состояла из полей: Преимущества, Недостатки и Отзыв.

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




Читать дальше: Параметры компонента.