Последняя версия
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 и перестану отвечать на вопросы в комментах :)

25.07.2016 16:02
+ 0 -
Вячеславответить 
Здравствуйте!
У меня сайт с регистрацией пользователя. Никак не могу придумать, как использовать ваш скрипт так, чтобы авторизованному пользователю постоянно не вводить email и Имя, а при условии авторизации автоматически учитывать это.
Подскажите, пожалуйста, как это можно осуществить?
Спасибо!
08.08.2016 09:36
+ 0 -
Геннадийответить 
Здравствуйте.
Пока - никак. Скрипт не работает со стороней авторизацией и, в ближайшее время, таких изменений не предполагается. Как вариант, я могу предложить некий хак, который добавлю в следующей версии. Мейл для соответствующего поля буду дополнительно смотреть в cookies и подставлять, если оно там найдется. А как уж подложить его туда - ваша забота как администратора сайта. Такой вариант подойдет?
08.08.2016 11:58
+ 0 -
Вячеславответить 
Огромное Вам спасибо!
Это будет отличным решением!
Очень буду ждать.
Спасибо!
01.08.2016 02:53
+ 0 -
Вячеславответить 
Здравствуйте! Активной ссылочки в сообщение никак не подставить?
08.08.2016 09:37
+ 0 -
Геннадийответить 
Здравствуйте. Нет, никак. Текст сообщения намеренной фильтруется для того, чтобы пользователи не смогли внедрить вредоносный код на сайте. Но так как это не первая просьба о подобном, я вынесу отключение фильтра в настройки. Запишу в список правок для следующей версии.
08.08.2016 11:59
+ 0 -
Вячеславответить 
Благодарю Вас. Очень классный у Вас скрипт.
Блеск! Подобного в интернете не встречал.
Спасибо за Ваш труд.
07.08.2016 04:51
+ 0 -
Александрответить 
Здравствуйте, Геннадий!

Подскажите пжл с чем может быть связано что не приходят уведомления на почту?
На хостере ошибок не обнаружил, подскажите куда копать?
08.08.2016 09:48
+ 0 -
Геннадийответить 
Здравствуйте.
Скрипт запускает команду РНР на отправку мейла. Если команда не отрабатывает, скрипт возвращает об этом соответствующее текстовое сообщение. Если этого нет, то по всем формальным параметрам мейл был отправлен. К сожалению, на некоторых хостингах ставятся заглушки, которые возвращают положительный результат отработки, хотя на самом деле мейл не отправился. Как другой вариант, мейл был отправлен, но попал в спам. Ну и не стоит исключать варианта неверной настройки адреса уведомления)
17.08.2016 15:03
+ 0 -
Андрейответить 
Могут ли перестать работать другие скрипты?? например рейтинг
22.08.2016 09:17
+ 0 -
Геннадийответить 
Здравствуйте. Сам по себе скрипт - нет. А вот некорректная установка - да. Например, вы можете по инструкции от моего скрипта установить второй раз библиотеку jQuery. Кроме того, сама по себе библиотека может конфликтовать с другими расширениями и т.д.
26.08.2016 03:11
+ 0 -
Вы слишком часто оставляете комментарии. Подождите еще -24536165 и -24 .
Сообщение не было сохранено. Заполните все поля корректно.
Вот такое показывает при отключённом ява-скрипте в браузере (
Сообщение отправить так и не удалось.
Сейчас включу яваскрипт.

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

Имя:
Email:
Комментарий:
- я не робот
- подписаться на обновления
eComment v.1.9.1

Новости

21.09.2016

Обновление 1.9.1

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

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

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

Обновление 1.8.1

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


Обращение к незаданной переменной post
Указанная операция "get_list" не существует