Описание
ZBounce Email Validator проверяет адреса email, отправленные через выбранные формы, с помощью сервиса проверки email ZBounce.
Плагин бесплатный и с открытым исходным кодом. Для внешней проверки нужен платный пакет кредитов ZBounce. Купите кредиты на https://zbounce.net/pricing.html и введите API-ключ, полученный после оплаты, в Настройки > ZBounce Email. Отдельной платной версии плагина или локальной активации лицензии нет.
Для использования API нужны сохранённый ключ и принятое соглашение сервиса. Автоматические проверки форм отдельно отключены, пока их явно не включат. Плагин не использует публичный демо-эндпоинт и не переключается на бесплатный сервис, если ключ не работает.
По умолчанию плагин отклоняет адреса, которые API признал неверными, одноразовыми или без существующего ящика. Адреса на доменах catch-all и неопределённые результаты по ящикам автоматически не отклоняются. Проверка не гарантирует доставку и не защищает от любого спама в формах; используйте её вместе с имеющимися средствами защиты форм.
Интеграции:
* Contact Form 7.
* Классическое оформление заказа WooCommerce и блок оформления заказа.
* Регистрация WordPress.
* Выбранные формы Gravity Forms, WPForms и Ninja Forms.
Результаты кэшируются локально на настраиваемый срок от 1 до 168 часов (по умолчанию 24 часа). Неизвестные результаты по ящикам и ошибки API не кэшируются и не выдаются за подтверждённые ящики. Пропускать ли такие отправки, определяет ваша политика разрешённых результатов; политика по умолчанию их пропускает.
Шорткод [zbounce_email_validator] выводит отдельный тестер только для авторизованных администраторов. Это не публичный виджет, через который кто-то мог бы анонимно расходовать ваши кредиты.
Внешние сервисы
Для удалённой проверки email плагин использует сервис ZBounce (https://zbounce.net/).
После сохранения API-ключа и принятия соглашения сервиса администраторы могут запускать ручные проверки email. Для автоматических проверок форм дополнительно нужно включить «Автоматическую проверку форм». Проверки без кэша отправляют адрес email в формате JSON на https://api.zbounce.net/v1/fast-verify, а API-ключ передаётся в HTTP-заголовке X-API-Key. Приостановленные автоматические проверки не читают решения из кэша и не блокируют формы.
Открытие страницы настроек и кнопка администратора «Проверить соединение и баланс» отправляют API-ключ на https://api.zbounce.net/v1/me. Этот запрос не содержит адреса email и не запускает проверку.
Запросы отправляются с сервера WordPress по HTTPS. Сервис получает сетевой адрес сервера и обычные метаданные HTTP-запроса. Плагин не включает в данные запроса к API другие поля формы, имена, пароли, платёжные данные и IP-адрес посетителя. API-ключи не передаются во фронтенд-JavaScript.
API-ключ хранится в настройках WordPress. Результаты в кэше, включая проверенные адреса email, хранятся в базе данных WordPress сайта. Просроченные записи кэша игнорируются при чтении и удаляются при последующих записях; истечение срока не означает немедленного физического удаления. Инструменты экспорта и удаления персональных данных WordPress охватывают этот локальный кэш проверок. Эти инструменты не запускают новые проверки и не удаляют данные, хранящиеся во внешнем сервисе. Деактивация сохраняет настройки и кэш; удаление плагина удаляет их.
Владельцы сайтов обязаны сообщать посетителям об этой внешней обработке. Перед включением проверок ознакомьтесь с политиками сервиса:
* Условия использования: https://zbounce.net/terms.html
* Политика конфиденциальности: https://zbounce.net/privacy.html
* Лицензионное соглашение сервиса: https://zbounce.net/license.html
Политика проверки
Выберите разрешённые результаты в настройках: действительный, рискованный (домен принимает любые адреса), одноразовый, неверный формат, домен без почты, несуществующий ящик, неизвестно и API недоступен. Отмеченные результаты проходят. Встроенная проверка формата в формах по-прежнему действует. По умолчанию разрешены действительный, рискованный, неизвестно и API недоступен; остальные результаты отклоняются. Неопределённость SMTP отличается от ошибки соединения, ключа или баланса API. Правила сразу применяются к результатам в кэше. Неизвестные и неудачные проверки не кэшируются.
Блок оформления заказа WooCommerce проверяет email плательщика на сервере при отправке заказа, до оплаты. Промежуточные обновления черновика заказа проверку не запускают. Классическое оформление заказа по-прежнему поддерживается.
Скриншоты
Установка
- Загрузите папку zbounce-email-validator в /wp-content/plugins/ или установите её ZIP-архив через Плагины > Добавить новый > Загрузить плагин.
- Активируйте ZBounce Email Validator.
- Купите пакет проверок на https://zbounce.net/pricing.html и скопируйте API-ключ, который будет показан после оплаты.
- Откройте Настройки > ZBounce Email, вставьте ключ, примите соглашение сервиса и сохраните настройки, чтобы пользоваться балансом и ручным тестером. Для отправок форм отдельно включите «Автоматическую проверку форм».
- Нажмите «Проверить соединение и баланс», затем выберите формы для проверки.
- Проверьте форму, прежде чем полагаться на интеграцию в рабочей среде.
Часто задаваемые вопросы
-
Это платный плагин?
-
Нет. Плагин распространяется под GPL. Удалённый сервис проверки ZBounce требует купленного пакета кредитов и API-ключа. Актуальные пакеты перечислены на https://zbounce.net/pricing.html.
-
Отправляет ли плагин данные до настройки?
-
Нет. Для проверки баланса и ручных проверок администратором нужно ввести API-ключ и принять лицензионное соглашение сервиса по адресу https://zbounce.net/license.html. Для автоматических проверок форм дополнительно нужно включить «Автоматическую проверку форм». Автоматического демо-режима нет.
-
Блокирует ли плагин адреса на доменах catch-all?
-
По умолчанию они проходят. Снимите флажок «Рискованный» в разрешённых результатах проверки, чтобы отклонять домены, принимающие любые адреса, или «Неизвестно», чтобы отклонять неподтверждённые ящики. Эти результаты учитываются отдельно от несуществующих ящиков.
-
Результат будет «API недоступен». По умолчанию такая отправка проходит; снимите флажок «API недоступен», чтобы отклонять отправки, пока проверка снова не заработает. Успешный удалённый результат не придумывается и не кэшируется. Проверить баланс можно на странице настроек.
-
Как отключить все удалённые проверки?
-
Снимите флажок «Автоматическая проверка форм» и сохраните настройки, чтобы остановить автоматические проверки форм. Отзовите принятие лицензионного соглашения, чтобы прекратить любое использование API, включая ручной тестер и баланс. Пустой выбор форм Contact Form 7 означает все формы Contact Form 7; для остальных необязательных интеграций нужно выбрать ID форм.
-
Включён ли исходный код?
-
Да. PHP, JavaScript и CSS поставляются в виде читаемого исходного кода. Скомпилированных или минифицированных файлов нет.
Отзывы
Участники и разработчики
«ZBounce Email Validator» — проект с открытым исходным кодом. В развитие плагина внесли свой вклад следующие участники:
Участники
«ZBounce Email Validator» переведён на 1 язык. Благодарим переводчиков за их работу.
Перевести «ZBounce Email Validator» на ваш язык.
Заинтересованы в разработке?
Посмотрите код, проверьте SVN репозиторий, или подпишитесь на журнал разработки по RSS.
Журнал изменений
1.2.6
- Хранимые настройки, таблица кэша, хуки, nonce и шорткод переименованы на префикс zbounce_eval; существующие настройки и кэш переносятся автоматически.
- Шорткод теперь [zbounce_email_validator].
- Переводы поставляются через translate.wordpress.org, а не в составе плагина.
1.2.5
- Удалено отладочное журналирование для разработчиков и его настройки.
- Встроенные переводы регистрируются на init через отложенную загрузку WordPress с запасным вариантом для старых версий.
- Временные переменные ограничены локальной областью видимости.
1.2.4
- Баланс и ручные проверки в админке доступны при принятом соглашении и сохранённом ключе, независимо от автоматической проверки форм.
- Автоматические проверки форм включаются только явно.
1.2.3
- Кнопка обновления соединения и баланса всегда видна рядом с балансом и неактивна, пока настройка не завершена.
1.2.2
- Баланс и тестер email всегда показываются вверху настроек; до включения проверки элементы неактивны и выводятся подсказки по настройке.
1.2.1
- Перед любым использованием API требуется явное принятие лицензионного соглашения сервиса ZBounce.
- В настройки добавлен тестер email для администратора с необязательным обходом кэша и выводом результата политики и источника.
- Баланс ключа показывается в настройках и обновляется после проверки.
1.2.0
- Перед внешними запросами требуется купленный API-ключ ZBounce и согласие администратора.
- Удалены автоматический демо-режим и публичный анонимный доступ к тестеру.
- Описаны внешние запросы, конфиденциальность, локальное хранение и требования платного сервиса.
- Настройки очищаются, прямой доступ к PHP закрыт, персональные данные убраны из отладочных журналов.
- Сбои сервиса отделены от результатов проверки; просроченные записи кэша удаляются при записи.
- Исправлены повторяющиеся результаты тестера в админке, переведены его подписи статусов.
- Временные ошибки SMTP считаются неопределёнными, учитываются более короткие сроки повтора от API, проверяются устаревшие результаты в кэше.
- Добавлены экспорт и удаление персональных данных WordPress для локального кэша.
- Согласованы метаданные плагина, добавлена проверка соединения и баланса.
1.1.1
- Прежнее поведение с резервным API-ключом.
1.1.0
- Добавлены кэширование и дополнительные интеграции с формами.
1.0.0
- Первый выпуск.