Плагин для WordPress
Плагин ставит пометки на сервере и сохраняет их прямо в HTML записи: их видят читатели, поисковики, RSS-агрегаторы и проверки. Текущая версия — 1.4.2, скачать архив. Плагин бесплатный, работает на любом тарифе с секретным ключом сайта.
Установка
- В WordPress: «Плагины» → «Добавить новый» → «Загрузить плагин» → выберите архив → «Активировать».
- «Настройки» → «agent-mark»: вставьте секретный ключ сайта, отметьте согласие и сохраните.
- Нажмите «Проверить подключение».
Секретный ключ показывают один раз при добавлении сайта в кабинете; новый можно выпустить на странице сайта — «Ключи и домены».
Режимы
- На сервере (по умолчанию) — при первом показе запись отправляется в agent-mark, размеченный HTML сохраняется в кеше записи. Дальше страница отдаётся из кеша, сайт не тормозит.
- JS-виджет — на страницы добавляется виджет, пометки ставятся в браузере читателя. RSS-ленты размечаются на сервере и в этом режиме: в RSS-читалках скрипты не работают.
Отдельная настройка — подстраховка виджетом: если сервер agent-mark недоступен, страница всё равно получит пометки в браузере.
Где ставятся пометки
- страницы записей выбранных типов — типы выбираются в настройках плагина;
- анонсы записей — статусом в скобках, без предупреждения о вреде наркотиков;
- RSS-ленты — полный текст и анонс; разметку лент можно выключить.
Обновление пометок
Раз в час плагин спрашивает у сервера версию разметки (/api/site). Если реестры обновились, изменились настройки пометок, тариф, доп. услуга или исключения однофамильцев, пометки во всех записях пересчитываются в фоне. Запросы плагина считаются проверками по тарифу сайта — «Лимиты и расход». Начиная с версии 1.4.0 плагин передаёт адрес записи, поэтому исключения однофамильцев действуют и в нём.
Настройки вида
Вид пометки, значок сноски, цвет и курсив статуса в скобках задаются в настройках плагина — в режиме «на сервере» действуют они, а не настройки кабинета. Какие реестры размечать — из настроек сайта в кабинете.
Что отправляется на сервер
HTML опубликованных записей выбранных типов — когда запись показывается и её пометки ещё не в кеше или после обновления реестров — и секретный ключ сайта для авторизации. Данные посетителей не отправляются. Перед включением плагин просит подтвердить согласие на отправку текстов.