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

07.06.2016 14:08
+ 0 -
Егор
Добрый день. В вашем скрипте можно активировать HTML, чтобы тэги отображались как нужно?
04.07.2016 09:55
+ 0 -
Геннадий
Добрый. Нет. Поверьте, это сделано для вашей же безопасности.
03.07.2016 23:43
+ 0 -
Константин
Здравствуйте в новостях написано последняя версия 1.8.1, у вас тоже версия тут 1.8.1, а для скачивания версия 1.9.1 чему в итоге верить?
04.07.2016 10:05
+ 0 -
Геннадий
Здравствуйте. Текущая версия 1.9.0
Спасибо за замечание, обновил тексты на сайте. Новости об этой версии не было. А версия комментов на самом сайте не обновлена по причине собственной природной лени. Обновлю сегодня))
15.07.2016 07:55
+ 0 -
Александр
HELP... Помогите...
Я очень мало разбираюсь в установках на хостинг... Вроде бы все правильно прописываю...
Кто может пожалуйста помогите.
Сайт на хостинге ho.ua
При необходимости вышлю все данные с паролем.
заранее благодарен.
15.07.2016 09:07
+ 0 -
Геннадий
А в чем у вас возникает проблема? Не работает только на хостинге или локально тоже?
15.07.2016 16:01
+ 0 -
Александр
Добрый день Геннадий.
Не работает ни на хостинге ни локально. Обратился к спецам, выслал логин и пароль для входа в систему. но у них тоже не получилось. У меня версия eComment v.1.7.2
Я буду очень Вам признателен если Вы мне поможете. Знаю, что Вы не занимаетесь такими мелочами, но ради исключения...
Заранее благодарен при любом ответе.
С Уважением Александр.
15.07.2016 16:13
+ 0 -
Александр
Еще раз добрый день.
Геннадий, я даже не могу скачать последнюю версию... Почему не знаю. Видно регион заблокирован...
15.07.2016 16:20
+ 0 -
Геннадий
Я вам уже в личку отписался. Вы реальный мейл указали, когда писали комментарий?
20.07.2016 16:10
+ 0 -
Александр
Уважаемый Геннадий, я Вам очень благодарен за оказанную помощь.
Насколько я понял, я неправильно прописал путь в файле ecomment.php
Видно в свои 60 и со своим зрение я что-то пропустил.
Сейчас работает все отлично.
Еще раз очень Вам признателен за помощь и классный скрипт.
Легкий и функциональный, именно его и хотел установить на сайт.
Удачного Вам развития вашего бизнеса и наилучших пожеланий.
С Уважением Александр.
25.07.2016 09:40
+ 0 -
Геннадий
Рад был помочь)
За пожелания - спасибо, только это не бизнес, а мини-проект для души)
21.07.2016 15:43
+ 0 -
Сергей
А почему после каждого комментария создаться дубли страниц? Как решить эту проблему? Пока что сайт на компьютере, но ссылки комент создает такие ?id=, можно кроме как в файле robots, выполнить настройки?
25.07.2016 09:39
+ 0 -
Геннадий
Дубли страниц? Нужно уточнять в таких случаях, что, видимо. имеются в виду дубли в поисковых системах. Видимо, потому, что в комментариях используются ссылки в качестве управляющих кнопок и элементов. Пока исправляется только через robots. В будущей версии исправлю этот момент - или просто оберну в noindex, или капитально перелопачу JS составляющую и уберу ссылки. Внесу это в список пожеланий к будущей версии.

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

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

Новости

21.09.2016

Обновление 1.9.1

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

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

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

Обновление 1.8.1

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


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