В магазине Modstore доступно 2 версии компонента:

• для MODX 2.x: easyComm версии 1.12.0-pl (от 18.09.2023);
• для MODX 3.x: easyComm версии 3.2.0-pl (от 19.09.2023) (пока без поддержки добавления дополнительных полей через систему плагинов).

Нужная версия будет выбрана при установке автоматически, в зависимости от версии MODX на вашем сайте.

Назначение

Компонент предназначен для создания на сайтах таких разделов и блоков, как:

• отзывы;
• комментарии;
• вопросы пользователей.

Особенность компонента — механизм пользовательских оценкок (от 1 до 5, настраивается), на основании которых считается рейтинг по 2-м алгоритмам (средний и продвинутый).

Продвинутый рейтинг считается как нижняя граница доверительного интервала Вильсона (Wilson) для параметра Бернулли (описание). Этот алгоритм позволяет избежать проблем расчета рейтинга при небольшом количестве оценок.

easyComm работает как с неавторизованными пользователями (гостями), так и с авторизованными.

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

— Пользователь сайта оставляет свой комментарий/отзыв/вопрос к чему либо (например, товару) через специальную форму.
— Администратор сайта получает уведомление на почту, в специальном разделе панели управления сайтом управляет сообщениями (можно опубликовать, удалить, отредактировать), а также оставить свой ответ на него.
— Если пользователь оставил электронную почту, то он получит уведомление на свой email.
— Если используется поле Оценка, то после публикации сообщения происходит перерасчет рейтинга.
— Вы можете включить голосование за каждое сообщение, чтобы пользователи могли оценить его полезность.

Замечание
Компонент работает с не авторизованными пользователями и не носит социальной направленности. Т.е. он не проектировался как модуль для добавления комментариев в блогах или каких-либо социальных сетях (хотя вы можете попробовать использовать его и там на свой страх и риск).
Цель easyComm — связь с покупателями интернет магазинов, посетителями сайтов компаний, продающих услуги.

Пример работы

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

Возможности

1. Создание произвольного количества цепочек сообщений. Сообщения привязаны не к ресурсам, а к цепочкам, а те в свою очередь к ресурсу, это позволяет на одной странице создать несколько цепочек сообщений, к примеру, Отзывы и Вопросы.

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

3. Вкладка «Сообщения» на странице ресурса. Повторяет функционал, описанный в предыдущем пункте, но с условием, что здесь доступны только сообщения и цепочки, относящиеся к текущему ресурсу.

4. Уведомления по почте. Приходит уведомления администратору о новом сообщении, а если пользователь оставил свою электронную почту, то и ему о том, что он оставил сообщение и о том, что его сообщение опубликовано на сайте.

5. Оценки и рейтинг. В компонент добавлен функционал, позволяющий пользователям давать свою оценку чего-либо, а на ее основании рассчитывается общий рейтинг по 2-м алгоритмам.

6. Добавление произвольных полей. Если вам недостаточно стандартного набора полей у сообщения (а это Дата, Имя пользователя, Эл. почта, Контакты, Оценка, Тема сообщения, Текст сообщения, Автор ответа, Текст ответа), то при помощи системы плагинов есть возможность добавить произвольное количество своих полей.

7. Несколько полей рейтинга. Хоть в компоненте присутствует одно поле rating, но механизм добавления дополнительных полей позволяет добавить в том числе и поля с типом рейтинг (звездочками), причем для них так же будут высчитываться средние показатели. Таким образом вы можете дать возможность проставлять сразу несколько оценок.

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

9. Поддержка Gravatar. Сниппет ecMessages поддерживает gravatar. Если у сообщения заполнен email, то в чанке вывода сообщения доступен плейсхолдер gravatar.

10. Вывод расширенного рейтинга. Сниппет ecThreadRating поддерживает вывод подробной информации о голосах пользователей. Вместе с компонентом идет отдельный чанк tpl.ecThreadDetailedRating, в котором реализован подобный вывод.


11. Голосование за сообщение. Вы можете включить голосование (нравится/не нравится) за каждый отзыв на вашем сайте и, например, в дальнейшем выводить сначала полезные отзывы.

12. По-умолчанию оценка проставляется от 1 до 5, но вы можете это изменить, например сделать от 1 до 10. Для этого есть специальная настройка, также потребуется внести изменения в html разметку и css правила.

13. Прикрепление файлов (фото), начиная с версии 1.11.0-pl. Теперь вы можете дать возможность прикреплять файлы (фотографии) к сообщениям, используйте для этого параметры files, fileTypes, fileSize, filesCount сниппета ecForm.

Зависимости

Для корректной работы компонента необходимо:

• подключенные на сайте jQuery и плагин jquery.form, их НУЖНО ПОДКЛЮЧИТЬ САМОСТОЯТЕЛЬНО, компонент это не делает;
• установленная библиотека pdoTools,
• в чанке вывода сообщения дополнительно используется сниппет dateAgo для формирования «красивой» даты.

Внимание! Начиная с версии 1.11.4-pl (15.02.2022) и 3.1.3-pl (03.05.2023) добавлен файл скриптов /assets/components/easycomm/js/web/ec.js, не требующий зависимостей в виде jQuery и jquery.form. Вы можете указать этот файл в настройках компонента.

Более подробные сведения о работе с компонентом содержатся в документации.

Видео с демонстрацией работы

На видео показаны основные возможности компонента. Хотя видео довольно старое и часть нового функционала не показана.

Фото-презентация

Пример использования компонента, создаются 2 цепочки сообщений (Отзывы и Вопросы), показаны основные возможности (на скриншотах версия 1.8.5-pl).
























Обсуждение компонента в сообществе MODX.PRO