Последняя версия
1.9.1

Экологически чистая система комментирования

Документация

страница в процессе наполнения...

Описание дистрибутива

Весь дистрибутив скрипта состоит из четырех файлов:

ecomment.php
Это серверная часть скрипта, обслуживающая AJAX-запросы от страницы с подключенным комментированием.
ecomment.js
Клиентская часть скипта, которая будет отправлять AJAX-запросы на серверную сторону.
ecomment.css
Стилевое оформление списка комментариев. Легко кастомизируется под дизайн вашего сайта простой сменой цветов.
test_page.html
Тестовая страница скрипта с примером интеграции. Для работы должна быть помещена в ту же папку, где лежат предыдущие три файла. Содержит в себе пример инициализации скрипта комментирования.
ecomment_connector.php

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

Размещение файлов на сервере

Обязательными для работы скрипта являются первые три файла из перечисленных выше + подключенный на странице фреймворк jQuery (в дистрибутив не входит).

Все файлы необходимо разместить в одной папке и настроить в самих скриптах корректные пути. Лучше всего использовать абсолютные пути - от корня сайта, начинаяются со слеша "/".

Все дальнейшие примеры приводятся с условием размещения файлов в корне сайта.

В файле ecomment.js указываем путь до размещения ecomment.php:


    settings = $.extend({
        'ref'		: location.href,
        'http_ref'	: location.href,
        'path' 		: '/ecomment.php'
    }, options),

Параметр path можно передать позднее, при инициализации скрипта на конкретном блоке. Это может быть полезным, когда у вас установлено несколько версий eComment с разными настройками.

Так же на хосте необходимо создать папку для хранения файлов данных с комментариями. Корректный путь до нее необходимо указать в серверной части скрипта ecomment.php:


class ecomment {
    //основные настройки
    private $store = "/store/";
    ...

Подключение стилей и плагина

Для корректного отображения комментариев необходимо подключить в заголовке страницы (между <HEAD> и </HEAD> ) файл стилей ecomment.css и сам плагин ecomment.js.


    <link rel="stylesheet" href="/ecomment.css" type="text/css" media="all">
    <script type="text/javascript" src="/ecomment.js"></script>

Содержимое файла ecomment.css можно перенести в ваш основной файл стилей. В таком случае, отдельно подключать этот файл уже не нужно, что благоприятно скажется на производительности.

Все правки внешнего вида комментариев удобнее будет вносить в отдельный css-Файл (или ваш основной стиль), не затрагивая сам ecomment.css. В будущем, это позволит вам легко обновлять версию скрипта целиком, без повторного внесения правок в ecomment.css.

Инициализация комментариев

Для инициализации комментариев необходимо в нужном месте разметки вашей страницы разместить пустой контейнер и навесить на него сам плагин. После загрузки скрипт самостоятельно создает необходимые HTML-контейнеры, обвешивает их JS-скриптами и делает первый AJAX-запрос к серверной части ecomment.php для получения списка комментариев, принадлежащих текущей странице. Плагин может принимать объект с параметрами инициализации. Например, можно передать ref параметр для вывода комментариев определенной страницы, не пренадлежащих той, с которой запускается скрипт. Такой пример включен в тестовую страницу дистрибутива.


    <div class="ecomment_wrapper"></div>
    <script>
    // одиночное подключение скрипта на странице
    $('.ecomment_wrapper').ecomment()
    </script>

    <div class="ecomment_wrapper" rel="some_ref_one"></div>
    <div class="ecomment_wrapper" rel="some_ref_two"></div>
    <script>
        // многократное подключение скрипта на странице
        $('.ecomment_wrapper').each(function(){
            $(this).ecomment({
                ref: $(this).attr('rel')
            });
        });
    </script>

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


    <div class="ecomment_wrapper" rel="http://mysite.com/feedback.html"></div>
    <div class="ecomment_wrapper" rel="http://mysite.com/faq.html"></div>

ВАЖНО!

Некоторые вопросы в комментариях могут остаться без ответа без объяснения причин. Основная причина в таких случаях - или я его еще не прочитал, или ответ уже много раз звучал ранее. Не поленитесь полистать комментарии и воспользоваться поиском.

... когда-нибудь я сделаю раздел FAQ и перестану отвечать на вопросы в комментах :)

15.08.2018 01:59
+ 0 -
AllaurHost
Вычислил я проблему почему на главной не выводятся комментарии. Данным скриптом не воспринимаются расширения файлов .tpl Но ведь многие шаблонизаторы используют .tpl. Как быть в этом случае? Что нужно прописать в файле homepage.tpl чтобы комментарии выводились на главной странице?
15.01.2019 16:42
+ 0 -
Администратор
Данный скрипт вообще не принимает в расчет расширения файлов, если они не принимают участие в формировании URL.
23.08.2018 16:57
+ 0 -
Геннадий
Отключена подписка на уведомления о новых комментариях для пользователей в виду недобросовестного заполнения комментаторами поля Email. Из-за чего письма с нашего сайта стали получать отметку спама.
21.03.2019 08:32
+ 0 -
Самвел
А можно его использовать для личных переписок отдельно с каждым пользователем сайта, чтобы другие не видели? Как тех. поддержка на сайте?
10.12.2019 14:07
+ 0 -
Администратор
Такая переписка не будет приватной, так как скрипт не имеет авторизации пользователей (только авторизация админа для админских операций). Но да, для каждого пользователя может быть своя история переписки. Достаточно будет указать параметр из запроса (например, логин или идентификатор в адресе страницы), который будет учитываться при формировании внутреннего идентификатора комментариев
08.12.2019 18:59
+ 0 -
Егор
Здравствуйте!
Подскажите пожалуйста. Можно ли сделать так чтобы все комментарии отображались на главной(или другой странице) и как это прописать. Заранее спасибо.
П.С. Просмотрел 30 страниц- не нашёл. Извините если повторился.
10.12.2019 14:22
+ 1 -
Администратор
День добрый. Придется немного поскриптовать для этого)
Дело в том, что выполянемый скрипт не знает, где еще могут быть страницы с комментариями.
Он натравлен по конкретному адресу. Поэтому, на главной странице можно разве что вывести последние комменты из определенного источника\страницы.
Можно дополнительно задействовать stat_filename (см настройки в скрипте). Распарсировав его, вы получите перечень всех страниц, где есть (подсчитаны) комментарии. Следовательно, сможете в цикле обойти их, прочитать комментарии и что-то сделать с ними. Например, вывести на главной странице.
Но если на вашем сайте много где используются комментарии, то эта операция может быть тяжелой. Прямо скажем, концепцией данного скрипта не предусмотрено обслуживание сложных порталов. Хотя и возможно технически)
26.08.2020 20:11
+ 0 -
Ярослав
Спасибо автору. Переделал под отзывы для себя. Сделал многоязычность. Заменил рейтинг на оценку в звездах. Добавил семантическую разметку. Поправил стили, чтоб выглядело минималистично, но современнее. Возможно автору тоже захочется что то добавить из этого. Хотя нарушается основной принцип чистой, простой системы. В целом автору респект. Код прост и понятен.

Оставить комментарий

Имя:
Email:
Комментарий:
- я не робот
eComment v.1.9.3

Новости

21.09.2016

Обновление 1.9.1

Пакет правок по заявкам пользователей.…
04.07.2016

Пожелания к обновлению

Сбор пожеланий от пользователей для очередного обновления функционала скрипта…
12.05.2015

Обновление 1.8.1

Небольшие косметические правки.…
Все новости


Обращение к незаданной переменной post