Предварительные требования
- WordPress 6.0 или выше
- PHP 7.4 или выше
- Аккаунт в Didit Console
Шаг 1: Получите учётные данные Didit
- Зарегистрируйтесь или войдите на business.didit.me
- Перейдите в API & Webhooks и скопируйте API-ключ
- Перейдите в Рабочие процессы, создайте или выберите сценарий и скопируйте Идентификатор сценария
Вы можете использовать UniLink URL, чтобы посмотреть сценарий верификации без API-ключей.
Используйте режим API Session с API-ключом и ID сценария для ограничения доступа к контенту и требований верификации в WooCommerce.
Завершение UniLink само по себе не открывает защищённый контент и не одобряет заказ.
Шаг 2: Установите плагин
- Скачайте
didit-verify-0.3.4.zipиз релиза 0.3.4 - В админке WordPress перейдите в Плагины → Добавить новый → Загрузить плагин
- Выберите скачанный ZIP-файл и нажмите Установить сейчас
- Нажмите Активировать
Didit Verify также доступен на WordPress.org.
Перед установкой проверьте версию: для описанного здесь поведения подтверждения статуса сервером используйте версию 0.3.4 или новее.
Начиная с 0.3.4, доступ к защищённому контенту отзывается, если одобренная верификация позже отклонена, истекла или вернулась на проверку.
Если в каталоге стоит более старая версия, установите ZIP-файл релиза, указанный выше.
Шаг 3: Настройте плагин
Перейдите в Настройки → Didit Verify.Выберите режим
Для UniLink: выберите в поле «Mode» значение «UniLink», вставьте свой URL и сохраните настройки.
Для API Session: выберите в поле «Mode» значение «API Session», введите ID сценария и API-ключ и сохраните настройки.
API-ключ хранится на вашем сервере в безопасном виде и никогда не передаётся посетителям.
Настройте параметры сессии (только для режима API)
Это необязательные настройки, которые дают вам больше контроля:- Vendor Data: связывает каждую верификацию с конкретным пользователем в вашей панели Didit, чтобы вы могли отслеживать, кто прошёл верификацию. По умолчанию используется WordPress User ID (например,
wp-42). Также можно выбрать User Email, собственный префикс или отключить этот параметр. - Callback URL: страница на вашем сайте, на которую пользователи перенаправляются после верификации. Didit добавляет
verificationSessionIdиstatusкак параметры запроса. - Callback Method: какое устройство обрабатывает перенаправление:
initiator(устройство, которое начало процесс),completer(устройство, которое его завершает) илиboth(оба устройства). - Language: выберите один из 54 языков или включите автоматическое определение по языку браузера.
Настройте параметры отображения
- Display Mode: Modal (всплывающее окно поверх страницы) или Embedded (встроенное в страницу)
- Close Button: показывать или скрывать кнопку X в модальном окне
- Exit Confirmation: показывать диалог «Вы уверены?» при закрытии
- Auto-close: автоматически закрывать модальное окно после завершения верификации
- Debug Logging: записывать события SDK в консоль браузера (для поиска неисправностей)
Настройте кнопку
В разделе Button Appearance можно изменить:- текст кнопки и текст при успехе
- цвет фона и цвет текста
- радиус скругления, отступы и размер шрифта
Шаг 4: Добавьте верификацию на сайт
Для магазинов WooCommerce
- В разделе Настройки → Didit Verify → WooCommerce отметьте Require identity verification at checkout
- Выберите, где будет отображаться блок верификации:
- В начале страницы оформления заказа
- После платёжных данных
- После примечаний к заказу
- Перед «Оформить заказ» (рекомендуется)
- При желании выберите Product Scope: все товары (по умолчанию), только выбранные товары или все товары, кроме выбранных. Отметьте товары флажком Didit verification в разделе Данные товара → Расширенные в редакторе товара. Корзина, в которой есть хотя бы один товар, требующий верификации, потребует её. Область действия применяется как к оформлению заказа, так и к режимам после покупки.
- При желании измените Заголовок раздела, Checkout Message и Post-purchase Message в разделе Настройки → Didit Verify → WooCommerce. Пустые поля используют текст по умолчанию.
- При желании включите Send Billing Data, чтобы автоматически отправлять в Didit имя, адрес электронной почты, телефон и адрес клиента для предварительного заполнения и перекрёстной проверки.
Коды стран автоматически преобразуются из формата WooCommerce alpha-2 в формат Didit alpha-3, который требуется.
Для любой страницы WordPress
Добавьте этот шорткод на любую страницу или запись:Шаг 5: Ограничение доступа к контенту для верифицированных пользователей (необязательно)
Показывайте или скрывайте контент в зависимости от статуса верификации: Для доступа к закрытому контенту пользователь должен быть авторизован, а одобрение должно быть подтверждено в режиме API Session. Обратные вызовы браузера и параметры запроса в перенаправлении доступ не открывают.Проверка статуса верификации
Устранение неполадок
Безопасность
Плагин работает как защищённый серверный прокси. Ваш API-ключ никогда не попадает в браузер. Каждый запрос на создание сессии защищён следующими мерами:- CSRF nonce: запросы должны исходить с вашего сайта WordPress
- Требование авторизации: создавать сессии могут только зарегистрированные пользователи (настраивается)
- Ограничение частоты запросов: 10 сессий в час на пользователя, 3 в час на IP для гостей
- Очистка входных данных: все поля проверяются по белому списку и очищаются на стороне сервера
Для разработчиков
PHP-хуки
Плагин вызывает действия WordPress, к которым могут подключаться другие плагины или темы:JavaScript-событие
DOM-событие отправляется по завершении верификации:Проверка верификации в PHP
didit:complete.