=== Правки.Про — виджет правок ===
Contributors: pravkipro
Tags: правки, приёмка, обратная связь, feedback, скриншот
Requires at least: 5.6
Tested up to: 6.7
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Кнопка «Правка» на сайте: клиент кликает по элементу и оставляет замечание — оно
падает в пул студии на Правки.Про.

== Описание ==

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

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

Настраивать нужно ровно две вещи:

* **Ключ виджета** — берётся в кабинете (проект → «Виджет на сайте»).
* **Показывать только администраторам** — галочка, чтобы кнопку «Правка» видели
  только вошедшие пользователи с правом управления сайтом.

Виджет — платная возможность Правки.Про; нужен аккаунт студии с активным
тарифом.

== Установка ==

1. Плагины → Добавить новый → Загрузить плагин → выберите ZIP → Установить →
   Активировать.
2. Настройки → Правки.Про.
3. Вставьте ключ виджета из кабинета. Можно вставить и всю строку
   `<script src="https://pravki.pro/widget.js" data-key="…" defer></script>` —
   ключ вынется сам.
4. При необходимости поставьте галочку «Показывать только администраторам».
5. Сохранить. Рядом с полем появится состояние виджета: принимает правки или
   почему нет.

== Часто задаваемые вопросы ==

= Где взять ключ виджета? =

В кабинете Правки.Про: проект → «Виджет на сайте» → «Код для установки».
Ключ — это значение `data-key` в скопированной строке.

= Ключ виджета — это секрет? =

Нет. Он и так виден в исходном коде страницы. Ключ даёт право только *создавать*
правки в целевом пуле и ничего не позволяет прочитать. Чтобы виджет не работал
на посторонних сайтах, укажите в кабинете список разрешённых доменов.

= Что делает галочка «Показывать только администраторам»? =

Скрипт виджета вставляется в страницу только для вошедших пользователей с правом
`manage_options`. Остальные посетители кнопку «Правка» не видят и никаких
запросов к Правки.Про не делают. Такие страницы плагин помечает как
некешируемые, чтобы кеш-плагин не отдал «админскую» версию всем подряд.

= Можно разрешить виджет и редакторам? =

Да, фильтром в теме или mu-плагине:

`add_filter('pravki_pro_user_allowed', fn() => current_user_can('edit_pages'));`

= Как отключить виджет на отдельных страницах? =

Фильтром `pravki_pro_should_render`:

`add_filter('pravki_pro_should_render', fn($yes) => is_page('checkout') ? false : $yes);`

= Виджет не появляется =

Проверьте по порядку: состояние на экране настроек плагина (оно приходит с
сервера и объясняет причину); включён ли виджет в кабинете; выбран ли пул;
не закрыт ли пул; не мешает ли галочка «только администраторам»; вызывает ли
тема `wp_footer()`.

= Плагин на своём домене Правки.Про =

Настройки → Правки.Про → «Дополнительно» → «Адрес сервиса». Либо в
`wp-config.php`:
`define('PRAVKI_PRO_DEFAULT_HOST', 'https://my.pravki.host');`

== Что собирается ==

Скриншот выбранного места, адрес страницы, CSS-селектор и координаты элемента,
размер окна, user-agent, плотность пикселей. Имя клиента сохраняется в
`localStorage` его браузера. При записи действий поля ввода маскируются.
Данные уходят на сервер Правки.Про, указанный в настройках.

== Журнал изменений ==

= 1.0.0 =
* Первая версия: ключ виджета, галочка «только администраторам», проверка
  состояния виджета прямо в настройках.
