Документация плагина

Требования

• WordPress 6.2 или новее, PHP 7.4 или новее.
• WooCommerce 7.0 или новее, плагин должен быть активен. Без WooCommerce ThanklyClub покажет предупреждение и не запустится.
• Поддерживается хранилище заказов HPOS (High-Performance Order Storage).
• Настраивать плагин может пользователь с правом manage_woocommerce — администратор или менеджер магазина.

Установка

• Скачайте архив thanklyclub.zip в кабинете ThanklyClub.
• В WordPress откройте Plugins → Add New → Upload Plugin (Плагины → Добавить новый → Загрузить), выберите архив и нажмите Install Now. Можно и вручную: распакуйте папку thanklyclub в /wp-content/plugins/.
• Нажмите Activate (Активировать).
• В меню админки появится пункт ThanklyClub с четырьмя вкладками: Dashboard (Обзор), Offer categories (Категории офферов), Placement (Размещение), Connection (Подключение).

Демо-режим

Сразу после установки плагин работает в демо-режиме — на вкладках видна метка Demo mode. В этом режиме плагин не обращается к серверу: AI-анализ заменён упрощённым анализом по ключевым словам в каталоге, а подарки берутся из встроенного набора примеров.

Демо-режим нужен, чтобы посмотреть блок на своём магазине до регистрации. Начислений в нём нет. Плагин остаётся в демо-режиме, пока включена галочка Demo mode или не указан ключ сайта.

Подключение ключа

На той же вкладке есть настройка Privacy (Конфиденциальность): галочка Send product titles of the order for better matching (Передавать названия товаров заказа для точного подбора). Если её снять, сервер получает только категории товаров.

• Зарегистрируйтесь в кабинете ThanklyClub и добавьте сайт — вы получите ключ сайта (site key).
• Откройте вкладку Connection (Подключение) и вставьте ключ в поле Site key (Ключ сайта).
• Поле API URL оставьте по умолчанию: https://thanklyclub.com.
• Снимите галочку Demo mode (Демо-режим) и нажмите Save connection (Сохранить подключение).
• Нажмите Test connection (Проверить подключение). При успехе появится сообщение «Connected to the ThanklyClub server.»

AI-анализ магазина

На вкладке Dashboard (Обзор) нажмите Run AI analysis (Запустить AI-анализ). Плагин отправит на сервер снимок каталога: название и описание сайта, до 40 самых крупных категорий, 60 последних товаров с ценами и категориями, валюту, страну магазина и диапазон цен. Данных покупателей в снимке нет. Анализ занимает до минуты.

После анализа на Dashboard появится карточка AI store analysis (AI-анализ магазина): тип магазина (Store type), ценовой сегмент (Price segment), сколько категорий показывается (Shown categories), дата анализа (Analysed) и модель (Model). Если ассортимент изменился, нажмите Re-run AI analysis (Повторить анализ).

До первого анализа плагин показывает только приложения и сервисы, а товарные категории, которые могут конкурировать с магазином, скрыты.

Категории подарков

На вкладке Offer categories (Категории офферов) — все категории подарков, сгруппированные в Apps & subscriptions (Приложения и подписки), Services (Сервисы), Retail (Товары — могут конкурировать с вашим ассортиментом) и Sensitive (Чувствительные — только если вы включите сами).

У каждой категории видна рекомендация AI: AI: show (показывать), AI: hide (скрыть) или AI: your call (решайте сами), а также оценка совместимости от 0 до 100. В колонке Your choice (Ваш выбор) можно оставить Follow AI (Как решил AI) или выбрать Always show (Всегда показывать) и Never show (Никогда не показывать). Колонка Shown (Показывается) показывает итог.

Чувствительные категории — Banking & payment apps, Insurance, Health & supplements, Wine & alcohol (18+), Dating — AI никогда не включает сам: только через Always show. Запрещённые — Gambling & betting, Crypto & trading, Loans & credit, Tobacco & vaping, Adult content — помечены Not available (Недоступно) и не включаются.

Кнопка Reset all to AI recommendations (Сбросить всё к рекомендациям AI) удаляет ваши ручные решения.

Чёрный список доменов

Внизу вкладки Offer categories — поле Blocked brands and domains (Заблокированные бренды и домены). Впишите домены, которые не хотите видеть в подарках, по одному в строке, например competitor.com. Протокол https:// и слеши можно не убирать — плагин очистит их сам.

Плагин отправляет список на сервер с каждым запросом и дополнительно сам отбрасывает подарки с этих доменов и из выключенных категорий, даже если сервер их вернул. После правок нажмите Save categories (Сохранить категории).

Места показа

Вкладка Placement (Размещение) управляет тем, где и как выглядит блок.

• Where to show (Где показывать): Thank-you page after checkout (Страница «Спасибо» после оформления) и Customer order emails (Письма покупателю о заказе). По умолчанию включены оба.
• Emails (Письма): Processing order (Заказ в обработке), Order on hold (Заказ на удержании), Completed order (Заказ выполнен), Invoice / order details (Счёт / детали заказа). По умолчанию выбраны первые три.
• Gifts per order (Подарков на заказ): от 1 до 3, по умолчанию 3.
• Headline (Заголовок) и Subheadline (Подзаголовок) блока. По умолчанию — «A gift with your order» и «Pick one bonus from our partners — it is free.»
• Minimum order total (Минимальная сумма заказа): ниже этой суммы блок не показывается. 0 — показывать на всех заказах.
• После сохранения (Save placement) внизу вкладки виден Preview (Предпросмотр) блока.

Как блок работает в заказе

• Подарки запрашиваются один раз на заказ и сохраняются в заказе, поэтому страница «Спасибо» и письмо показывают одни и те же подарки.
• На заказах со статусом failed, cancelled и refunded блок не показывается.
• Запрос подарков ждёт ответа сервера до 4 секунд. Если сервер не ответил, страница показывается без блока — оформление заказа не ломается.
• Показ засчитывается один раз на заказ для каждого места: страницы и письма.
• Ссылка подарка ведёт сначала на ваш сайт (параметр thanklyclub_go с ключом заказа), плагин проверяет заказ, записывает клик и перенаправляет покупателя к партнёру. Ссылки открываются в новой вкладке с атрибутом rel="sponsored noopener".
• Под блоком — пометка, что это предложения партнёров и персональные данные им не передаются.

Шорткод [thanklyclub_offers]

Блок встраивается через хук woocommerce_thankyou. На некоторых темах и в блочном шаблоне страницы подтверждения заказа этот хук не вызывается, и блок не появляется. Тогда добавьте шорткод [thanklyclub_offers] в шаблон страницы «Заказ получен» — например, блоком Shortcode в редакторе сайта.

Шорткод выводит блок только на странице заказа с верным ключом заказа в адресе. На других страницах он ничего не показывает.

Письма

В письма блок добавляется через хук woocommerce_email_after_order_table — сразу после таблицы с составом заказа. Для HTML-писем — карточка со стилями внутри письма, для текстовых писем — список подарков со ссылками. В письма администратору блок не попадает.

Выбрать, в каких письмах показывать подарки, можно на вкладке Placement в разделе Emails.

Статистика в плагине

На Dashboard видны показы за 30 дней (Impressions), клики (Clicks), кликабельность (Click-through rate) и заработок (Earnings). Заработок плагин получает с сервера и обновляет раз в 15 минут; в демо-режиме вместо суммы — Connect to see. Ниже — таблица Performance by category (Результаты по категориям) и Preview: what customers see (Что видит покупатель).

Показы и клики плагин хранит в своей таблице в базе WordPress: событие, оффер, категория, место показа, номер заказа и время. Персональных данных в таблице нет. Подробная статистика и начисления — в кабинете ThanklyClub.

Удаление

Деактивируйте плагин в разделе Plugins, затем нажмите Delete. При удалении плагин стирает свои настройки (thanklyclub_settings), результат AI-анализа (thanklyclub_analysis), ваши решения по категориям (thanklyclub_category_rules), служебные записи и таблицу событий wp_thanklyclub_events.

В уже оформленных заказах остаются служебные поля _thanklyclub_offers и _thanklyclub_seen — список показанных подарков. Если вы просто деактивируете плагин, все настройки сохранятся.

Частые вопросы