README

描述

通过 Mailgun 验证电子邮件地址。

安装

• 首选方式是使用 Composer

  composer require innocode-digital/wp-mailgun-email-validation
  

  默认情况下，它将被安装为 必须使用插件。但是，可以通过在 composer.json 中的 extra.installer-paths 控制它。

• 另一种方式是将此仓库克隆到 wp-content/mu-plugins/ 或 wp-content/plugins/

  cd wp-content/plugins/
  git clone git@github.com:innocode-digital/wp-mailgun-email-validation.git
  cd wp-mailgun-email-validation/
  composer install
  

如果插件作为常规插件安装，则从插件页面激活 Mailgun Email Validation 或使用 WP-CLI: wp plugin activate wp-mailgun-email-validation。

使用方法

添加所需常量（通常到 wp-config.php）

define( 'MAILGUN_API_KEY', '' );

或

define( 'MAILGUN_APIKEY', '' );

您可以使用这些常量中的任何一个。MAILGUN_APIKEY 也由 Mailgun for WordPress 插件使用。

文档

默认情况下，插件会跳过对 admin_email 的验证，但可以启用它

add_filter( 'innocode_mailgun_email_validation_skip_admin_email', function ( $skip, $email ) {
    return $skip;
} );

默认情况下，插件会跳过对用户电子邮件的验证，但可以启用它

add_filter( 'innocode_mailgun_email_validation_skip_user_email', function ( $skip, $email ) {
    return $skip;
} );

默认情况下，插件会检查电子邮件地址是否有 deliverable 或 unknown 状态，并且没有 high 风险，但可以设置自己的标准

add_filter( 'innocode_mailgun_email_validation_validated', function ( $validated, array $email ) {
    return $validated;
} );

还可以使用插件的 validate 和 is_valid 方法

• innocode_mailgun_email_validation()->get_client()->validate( $email ) - 使用 Mailgun Email Validation 验证电子邮件地址。

• innocode_mailgun_email_validation()->is_valid( $email ) - 使用前一个方法，但还应用过滤器和缓存结果，返回布尔值。