Апельсинки › Разработчикам
Виджеты для сайтов
Кнопка «Поделиться»Виджет группыВиджет комментариевМои сайтыКонструктор
Приложения и игры
ОбзорАвторизация и подписьМетоды APIПлатежиКлиентская библиотекаМобильная версияКабинет разработчика
Прочее
Робот SvBot

Виджет комментариев

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

Установка

<script src="http://api.apelsinki.com/widgets/comments.js"></script>
<div class="sv-comments" data-width="100%" data-count="10"></div>
АтрибутЗначениеПо умолчанию
data-urlадрес страницы, к которой комментарии. Укажите, если одна статья открывается по нескольким адресам (например, с параметрами)адрес текущей страницы
data-widthширина в пикселях (200–1200) или 100% — по ширине блока, на телефонах удобнее всего. Высота подбирается сама100%
data-countсколько комментариев показать сразу (1–50), остальные — по ссылке «Показать ещё»10
data-sortnew — новые сверху (поле ввода сверху), old — по порядку, поле ввода внизуnew
data-themelight или darklight

Собрать виджет в конструкторе

Одно обсуждение на страницу

Для каждой страницы в Апельсинки есть ровно одна запись-обсуждение со ссылкой и превью страницы. Адреса http:// и https://, с www. и без, с / на конце и без, с index.html, метками utm_* и якорем #… считаются одной страницей. Все комментарии с сайта — это комментарии под этой записью, а комментарии, оставленные в самих Апельсинки, видны на сайте. Ссылка «Обсуждение в Апельсинки» ведёт в это обсуждение — там разговор можно продолжить.

Запись появляется на странице того, кто написал первым. У остальных комментаторов в ленте одно событие «прокомментировал страницу» (повторные комментарии его обновляют). Автор записи и участники получают оповещения и «Обсуждения» о новых ответах — как у обычных комментариев. Если автор удалит запись, обсуждение перейдёт к следующему участнику: чужие комментарии не пропадают.

Модерация

  • Автор может удалить свой комментарий — в виджете или в Апельсинки.
  • Владелец сайта удаляет любые комментарии на страницах своего сайта, закрывает новые комментарии и получает оповещения о новых. Подтвердите сайт на странице «Комментарии на ваших сайтах» — мета-тегом <meta name="apelsinki-verification" content="КОД"> на главной странице или файлом apelsinki-КОД.html в корне сайта.
  • Защита от спама: ограничения на число комментариев от одного профиля, с одного IP-адреса и на одном сайте, проверка, что текст набран человеком в видимом виджете, запрет ссылок для новых профилей. Подозрительный комментарий не отклоняется, а подтверждается в окне Апельсинки. Виджет, вставленный на чужой сайт для обсуждения не его страницы, работает только на чтение.

Старые браузеры и телефоны

Виджет — iframe с обычной HTML-формой: работает в Internet Explorer 5.5/6, Opera 9, Firefox 1.5 и новее, на телефонах и в приложениях. Адреса без протокола (//): на http-сайте виджет открывается по http, на https — по https.

Число комментариев

http://api.apelsinki.com/widgets/comments/count?url=АДРЕС — JSON {"url":"…","count":5}; несколько адресов через | (до 50) — {"counts":{"адрес":5,…}}; с &cb=имя — JSONP.

Попробуйте

Ниже — обсуждение этой страницы документации.