Автор дополнения
Alexey Naumov
Пакетов
4
Закачек
4 021
Автор дополнения
Пакетов
4
Закачек
4 021
Обычно отвечает в течение суток
Версия 1.11.1-pl
Дата выпуска 27.04.2021
Загрузки 3 715
Просмотры 18 871
Внимание, этот компонент требует версию PHP 5.6 или выше! Если ваш сайт использует PHP ниже требуемого, установка этого дополнения может его сломать.
Внимание, этот компонент требует версию MODX не ниже 2.6 !
В магазине Modstore доступно 2 версии компонента:
  • для MODX 2.x: easyComm версии 1.x.x;
  • для MODX 3.x: easyComm версии 3.x.x (пока без поддержки добавления дополнительных полей через систему плагинов).

Назначение

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

Особенность компонента — механизм пользовательских оценкок (от 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 для формирования «красивой» даты.

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

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


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



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

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
























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

1.11.1-pl (27.04.2021)

  • Исправлена ошибка в работе параметров fileSize, filesCount сниппета ecForm

1.11.0-pl (22.04.2021)

  • Возможность прикреплять файлы к сообщениям (параметры files, fileTypes, fileSize, filesCount сниппета ecForm)

1.10.4-pl (23.05.2020)

  • Исправлена ошибка с неработающим параметром gravatarSize в сниппете ecMessages

1.10.3-pl (31.03.2020)

  • Исправлено появление WARN в панели управления из-за не указанного контекста в функции makeUrl
  • Добавлена системная настройка ec_message_window_system_tabs

1.10.2-pl (24.12.2019)

  • Исправлена js ошибка при создании Сообщения из админки

1.10.1-pl (19.12.2019)

  • Новый permission ec_vote_remove
  • Косметические улучшения в таблице голосов

1.10.0-pl (15.11.2019)

  • Возможность голосования за сообщения. Новый объект ecVote.

1.9.2-pl (27.05.2019)

  • Добавлен параметр validateEmail к сниппету ecForm. Указывает о необходимости проверки поля user_email на корректность введенного значения.

1.9.1-pl (01.04.2019)

  • Добавлен параметр itemReviewed к сниппету ecThreadRating для корректного формирования микроразметки (AggregateRating)

1.9.0-pl (06.03.2019)

  • Добавлена политика доступа easyCommPolicy
  • Подстановка в шаблонные ответы полей сообщения, например "Добрый день, {$user_name}"

1.8.6-pl (04.02.2019)

  • Прямая ссылка на сообщение в письме менеджеру (через параметр ecmessage)
  • Wysiwyg редактор в поле Ответ в панели управления (отключаемый)

1.8.5-pl (29.01.2019)

  • Возможность настраивать фильтры в списке сообщений в панели управления (настройка ec_message_grid_filters)
  • Удалено modAction при создании меню

1.8.2-pl (21.01.2019)

  • Исправлено Nan в сниппете ecThreadRating (деление на 0)

1.8.1-pl (16.01.2019)

  • Добавлены шаблоны для быстрых ответов (системная настройка ec_use_reply_templates)

1.7.2-pl (09.01.2019)

  • Исправлена ошибка в сниппете ecThreadRating при вызове метода getVotes
  • Изображение звездочек перенесено в css (base64)

1.7.0-pl (26.12.2018)

  • Добавлено отображение расширенного рейтинга в сниппете ecThreadRating
  • Исправлена не работающая опция перезаписи чанков при обновлении компонента

1.6.0-pl (18.12.2018)

  • Добавлена поддержка в ядро компонента множественных полей рейтинга

1.5.2-pl (19.11.2018)

  • Уменьшена длина поля name у объекта ecThread, т.к. были проблемы с созданием индекса по полю на некоторых серверах
  • Увеличена длина поля IP для возможности сохранения ipv6

1.5.1-pl (25.06.2018)

  • Микроразметка AggregateRating для сниппета ecThreadRating
  • Исправлена ошибка в передаче параметров в ecMessages при работе через Fenom

1.5.0-pl (24.05.2018)

  • Перевод чанков на шаблонизатор Fenom
  • Интегрирован механизм защиты дополнения
  • Добавлена вкладка История в окне редактирования Сообщения
  • Fix ширины поля с прикрепленным изображением
  • Поддержка произвольного Media Source в easyComm.utils.renderImage (параметр source)

1.4.3-pl (19.07.2017)

  • Исправлено поведение сниппета ecThreadRating при отсутствующем в базе объекте ecThread
  • Убрана лишняя инициализация pdoTools в сниппетах

1.4.2-pl (04.07.2017)

  • Значения по-умолчанию для некоторых полей сообщения (thread) и цепочки (resource, name) при создании из панели управления
  • Возможность указать значение рейтинга по-умолчанию при создании нового сообщения в панели управления (просто создайте настройку ec_rating_default = X)

1.4.0-pl (19.06.2017)

  • Новый параметр messages у сниппета ecMessages, в котором можно указать id конкретных сообщений

1.3.3-pl (19.06.2017)

  • В тексте письма менеджеру адрес панели управления теперь берется из системных настроек

1.3.2-pl (29.05.2017)

  • Добавлена поддержка Google ReCaptcha v2 для защиты от спама

1.3.1-pl (17.03.2017)

  • Графическое отображение рейтинга в админке, с возможностью отключения

1.3.0-pl (25.01.2017)

  • Добавлен en лексикон (спасибо Grigoriy Kolenko)
  • Переключение контекста при запросах к action.php
  • idx в сниппете ecMessages теперь привязан к idx от pdoTools, нумерация идет с 1, а не с 0
  • Процессоры редактирования/удаления объектов теперь наследуются от modObjectUpdateProcessor и modObjectRemoveProcessor
  • Добавлены события OnBeforeEcThreadRemove и OnEcThreadRemove

1.2.9-pl (19.01.2017)

  • Исправлена ошибка с пользовательским leftJoin в ecMessages

1.2.8-pl

  • Отключена перезапись чанков в скрипте установки
  • Добавлен параметр resourceFields в сниппет ecMessages

1.2.7-pl

  • Добавлен параметр mailManager к сниппету ecForm

1.2.6-pl

  • Добавлена колонка Ресурс в списке сообщений в панели управления

1.2.5-pl

  • Поддержка Gravatar в сниппете ecMessages

1.2.4-pl

  • В сниппете ecForm для отоборажения чанка формы теперь используется $pdoTools
  • Исправлена критическая ошибка при указании параметра tplWrapper в сниппете ecMessages
  • Добавлена функция "Посмотреть сообщение на сайте" в административной части

1.2.3-pl1

  • Исправлен баг при использовании tplWrapper, связанный с передачей данных в чанк, где фигурировала переменная $thread

1.2.3-pl

  • Добавлен сниппет ecMessagesCount

1.2.2-pl

  • Добавлен параметр $threads к сниппету ecMessages, позволяющий выводить сообщения из нескольких цепочек

1.2.1-pl

  • Добавлена настройка auto_reply_author - автоматическое заполнение поля Автор ответа

1.2.0-pl

  • Добавлены вспомогательные методы в utils.js для работы с дополнительными полями-изображениями
  • События на действия с сообщениями для возможности написания плагинов

1.1.3-pl

  • Добавлен параметр tplEmpty к сниппету cMessages

1.1.2-pl

  • Ошибка с непрописанным formId в html
  • Замена $ на jQuery для избежания проблем с jQuery.noConflict()

1.1.1-pl

  • Возможность автопубликации сообщений
  • Поддержка авторизованных пользователей в сниппете ecForm

1.1.0-pl

  • Устранена ошибка при редактировании цепочки сообщений

1.1.0-beta

  • Исправлено форматирование даты в окне редактирования сообщения
  • Возврат потерянного поля thread_name в списке сообщений

1.1.0-beta

  • Возможность настройки отображения списка колонок при просмотре списка сообщений и цепочек сообщений
  • Возможность настройки отображение разметки окна редактировани сообщения и цепочки
  • Интегрирована система плагинов для добавления полей сообщениям (ecMessage)

1.0.4-beta2

  • Добавлено поле IP адрес к объекту ecMessage
  • Добавлена Оценка к Сообщениям
  • Автоматический подсчет средней Оценки для Цепочки по 2-м алгоритмам: Средняя и Вильсон

1.0.2-beta1

  • Исправлена критическая ошибка, возникающая при установке пакета

1.0.0-beta

  • First version