Email Verification: Developer Hooks, Filters and Shortcodes Reference

Customer Email Verification for WooCommerce exposes actions, filters and shortcodes so you can adjust the verification flow, the emails, and the blocking behavior in code without editing plugin files. Every hook listed here was read from the plugin source for Pro version 3.2.7, so the names are exact.

All settings referenced below live under WPFactory > Email Verification (also reachable at WooCommerce > Settings > Email Verification). Every hook and filter uses the alg_wc_ev_* prefix (a small number of older settings actions use alg_wc_email_verification_*).

The core verification filter #

This is the single most useful filter. Email Verification decides whether a user counts as verified by running alg_wc_ev_is_user_verified. Return true or false to override the decision for any user.

// Treat every user with the "wholesale" role as verified.
add_filter( 'alg_wc_ev_is_user_verified', function ( $is_verified, $user_id ) {
    $user = get_user_by( 'ID', $user_id );
    if ( $user && in_array( 'wholesale', (array) $user->roles, true ) ) {
        return true;
    }
    return $is_verified;
}, 10, 2 );

The settings gate filter #

alg_wc_ev_settings is how the plugin decides whether a Pro-only field is disabled. In the free version it returns the array array( 'disabled' => 'disabled' ) (or array( 'readonly' => 'readonly' )), which locks the field. In Pro it returns the value unchanged, unlocking it. It is used across the settings screens and is not intended for store customization.

Email filters #

These fire while the plugin builds and sends its activation, confirmation and admin emails. Whatever you return replaces the value the plugin would otherwise use.

// Send the activation email to a CRM inbox as well as the customer.
add_filter( 'alg_wc_ev_activation_email_recipient', function ( $recipient, $args ) {
    return $recipient . ',cr*@*****le.com';
}, 10, 2 );

Placeholder filters #

Use these to add your own placeholders to the emails and messages. See the Email Verification placeholders reference for the full built-in list.

• alg_wc_ev_common_placeholders – the %site_title% / %site_url% pair. Argument: $placeholders.
• alg_wc_ev_user_placeholders_args – the per-user placeholders such as %user_email% and %resend_verification_url%.
• alg_wc_ev_verification_param – the URL query argument used to carry the verification code. Default alg_wc_ev_verify_email.
• alg_wc_ev_required_user_meta – the list of user meta keys required before an account can verify.

// Register a custom placeholder for the emails.
add_filter( 'alg_wc_ev_common_placeholders', function ( $placeholders ) {
    $placeholders['%support_phone%'] = '+1 555 0100';
    return $placeholders;
} );

Redirect and blocking filters #

Advanced and processing filters #

• alg_wc_ev_verification_info_customization – the My Account verification info block markup.
• alg_wc_ev_bkg_process_email_params – the email parameters sent when a background job finishes.
• alg_wc_ev_delete_unverified_users_loop_args – the query arguments used when deleting unverified users.
• alg_wc_ev_html_replacement_params, alg_wc_ev_html_tags_converter_replacement_ids – the “Replace HTML tags” advanced feature.

Actions #

// Add a user to a mailing group the moment their email is verified.
add_action( 'alg_wc_ev_user_account_activated', function ( $user_id, $args ) {
    update_user_meta( $user_id, '_newsletter_optin_ready', 'yes' );
}, 10, 2 );

Shortcodes #

Email Verification registers the following shortcodes. They work in both the free and Pro versions. Two of them, [alg_wc_ev_custom_msg] and [alg_wc_ev_email_content_placeholder], have an on/off toggle on the Shortcodes sub-tab (both enabled by default).

Deprecated: [alg_wc_ev_verification_status] was replaced by [alg_wc_ev_custom_msg] in version 2.8.2. It still resolves (it forwards to the new shortcode and emits a deprecation notice), but new pages should use [alg_wc_ev_custom_msg].

Need help? #

If you are extending Customer Email Verification for WooCommerce and a hook does not behave as expected, contact our team on the Email Verification support forum with the hook name and a short code sample, and we will point you to the right extension point.