FluentAuth 3.1.1 has 36 actions and 130 filters, read directly from its source code on Nov 17, 2026. The list updates automatically when a new version is released.
How to use these hooks
Actions let you run your own code at a specific moment. Filters let you change a value before the plugin uses it. Put your code in a child theme's functions.php or a code-snippets plugin, never in the plugin's own files, because updates overwrite them.
// Run your own code when FluentAuth fires an action
add_action( 'fluent_auth/email_verified', function( $user ) {
// Your code runs here.
}, 10, 1 );
// Change a value FluentAuth is about to use
add_filter( 'illegal_user_logins', function( $value ) {
// Change $value here.
return $value;
}, 10, 1 );Parts of a name in {braces} are filled in at runtime (for example a post type or field ID). Choose Example on any hook for a ready-to-edit snippet.
All hooks
-
fluent_auth/email_verified
action/** * This action is documented in MagicLoginHandler::makeLogin() */ do_action( 'fluent_auth/email_verified', $user ); -
illegal_user_logins
filter/** * This filter is documented in wp-includes/user.php */ apply_filters( 'illegal_user_logins', array() ); -
login_redirect
filterapply_filters( 'login_redirect', $redirectUrl, false, $user ); -
apply_filters( 'fluent_auth/already_logged_in_message', sprintf(__('You are already logged in. <a href="%s">Go to Home Page</a>', 'fluent-security'), site_url()) ); -
do_action( 'fluent_auth/device_factor_enrolled', $user->ID, 'passkey' ); -
do_action( 'fluent_auth/passkey_registration_failed', $user, $e->getMessage() ); -
apply_filters( 'fluent_auth/smartcode_fallback', $matches[0], $user ); -
fls_load_login_helper
actiondo_action( 'fls_load_login_helper' ); -
apply_filters( 'fluent_auth/auto_login_after_signup', true, $user ); -
do_action( 'fluent_auth/before_creating_user', $formData ); -
apply_filters( 'fluent_auth/integrity_max_extension_findings', 300 ); -
apply_filters( 'fluent_auth/login_redirect_url', $filteredRedirectUrl, $user, $_REQUEST ); -
apply_filters( 'fluent_auth/magic_login_can_use', $this->canUseMagic($user), $user ); -
fluent_auth/passkey_enabled
filterapply_filters( 'fluent_auth/passkey_enabled', true, $user ); -
do_action( 'fluent_auth/passkey_verification_failed', $user, $e->getMessage() ); -
fluent_auth/passkey_verified
actiondo_action( 'fluent_auth/passkey_verified', $user, $credential ); -
apply_filters( 'fluent_auth/signup_default_role', get_option('default_role'), $formData ); -
fluent_auth/signup_enabled
filterapply_filters( 'fluent_auth/signup_enabled', $signupEnabled ); -
fluent_auth/signup_form_data
filterapply_filters( 'fluent_auth/signup_form_data', $_REQUEST ); -
apply_filters( 'fluent_auth/social_redirect_to', $redirect_to ); -
fluent_auth/totp_enabled
filterapply_filters( 'fluent_auth/totp_enabled', true, $user ); -
apply_filters( 'fluent_auth/two_fa_bypass_active', true, $user ); -
fluent_auth/user_ip
filterapply_filters( 'fluent_auth/user_ip', '127.0.0.1' ); -
apply_filters( 'fluent_auth/verify_signup_email', true, $formData ); -
apply_filters( 'fluentcrm_auth/email_smartcodes', $userSmartCodes ); -
wp_login
actiondo_action( 'wp_login', $user->user_login, $user ); -
allow_password_reset
filterapply_filters( 'allow_password_reset', true, $user_data->ID ); -
fls_send_2fa_code
actiondo_action( 'fls_send_2fa_code', $data, $user, $autoLoginUrl ); -
apply_filters( 'fluent_auth/2fa_challenge_required', false, $user ); -
apply_filters( 'fluent_auth/2fa_challenge_resumable', $canResume ); -
apply_filters( 'fluent_auth/2fa_code_request_floor_limit', 10, $user ); -
apply_filters( 'fluent_auth/2fa_code_request_floor_timing', 15, $user ); -
apply_filters( 'fluent_auth/2fa_code_request_limit', $limit, $user ); -
apply_filters( 'fluent_auth/2fa_code_request_timing', $minutes, $user ); -
apply_filters( 'fluent_auth/2fa_conflict_plugins', $rivals ); -
fluent_auth/2fa_methods
filterapply_filters( 'fluent_auth/2fa_methods', [ new PasskeyTwoFaMethod(), new TotpTwoFaMethod(), new EnrollmentTwoFaMethod(), new EmailTwoFaMethod() ] ); -
apply_filters( 'fluent_auth/account_attempt_limit', $limit * 3, $user ); -
do_action( 'fluent_auth/after_creating_user', $user_id, $data ); -
do_action( 'fluent_auth/after_logging_in_user', $userId ); -
apply_filters( 'fluent_auth/after_registration_form_close', '', $registrationFields, $attributes ); -
do_action( 'fluent_auth/after_signup_validation', $formData ); -
fluent_auth/alerts_api_url
filterapply_filters( 'fluent_auth/alerts_api_url', self::DEFAULT_URL ); -
apply_filters( 'fluent_auth/allow_headless_login_without_challenge', true, $user, $method ); -
fluent_auth/app_permission
filterapply_filters( 'fluent_auth/app_permission', 'manage_options' ); -
apply_filters( 'fluent_auth/ask_to_set_up_totp', true, $user ); -
apply_filters( 'fluent_auth/auth_forms_enabled', $enabled ); -
apply_filters( 'fluent_auth/auth_shortcode_defaults', [ 'auto-redirect' => false, 'redirect_to' => '', 'hide' => false, 'show-signup' => false, 'show-reset-password' => false, ] ); -
apply_filters( 'fluent_auth/backup_file_patterns', [ '/\.(sql|sql\.gz|zip|tar|tar\.gz|tgz|rar|7z|bak|old|orig|save|swp)$/i', '/^wp-config\.php\.[a-z0-9~]+$/i', '/^wp-config\.(bak|old|orig|save|txt)$/i' ] ); -
apply_filters( 'fluent_auth/baseline_extensions', ['php', 'js', 'htaccess', 'phtml'] ); -
apply_filters( 'fluent_auth/baseline_max_changes', 200 ); -
apply_filters( 'fluent_auth/baseline_max_files', 20000 ); -
apply_filters( 'fluent_auth/baseline_scan_budget', 20 ); -
do_action( 'fluent_auth/before_logging_in_user', $userId ); -
do_action( 'fluent_auth/before_signup_validation', $formData ); -
apply_filters( 'fluent_auth/can_render_2fa_inline', !empty($_REQUEST['_is_fls_form']) ); -
fluent_auth/can_user_login
filterapply_filters( 'fluent_auth/can_user_login', true, $user, $provider ); -
apply_filters( 'fluent_auth/child_site_token_ttl', 5 * MINUTE_IN_SECONDS ); -
apply_filters( 'fluent_auth/cloudflare_ip_ranges', $ranges ); -
apply_filters( 'fluent_auth/default_token_validity', 10, $user ); -
apply_filters( 'fluent_auth/device_factor_completes_login', true, $user, $satisfiedFactors ); -
apply_filters( 'fluent_auth/device_factor_required', true, $user ); -
apply_filters( 'fluent_auth/dormant_admin_days', 365 ); -
apply_filters( 'fluent_auth/extra_login_page_wrap_css_class', '' ); -
fluent_auth/factor_migrated
actiondo_action( 'fluent_auth/factor_migrated', $userId ); -
apply_filters( 'fluent_auth/guessable_usernames', ['admin', 'administrator', 'root', 'webmaster', 'test'] ); -
apply_filters( 'fluent_auth/headless_harmless_capabilities', [ 'read', 'level_0' ] ); -
apply_filters( 'fluent_auth/headless_pass_excludes_api', $isApiRequest, $user ); -
apply_filters( 'fluent_auth/headless_probed_capabilities', [ 'manage_options', 'edit_posts', 'upload_files', 'edit_users', 'activate_plugins', 'delete_users', 'edit_theme_options', 'unfiltered_html', 'moderate_comments', 'manage_woocommerce' ] ); -
apply_filters( 'fluent_auth/integrity_extension_ignore_patterns', [ '(^|/)\.DS_Store$', '(^|/)Thumbs\.db$', '(^|/)\.git(/|$)', '(^|/)\.svn(/|$)', '(^|/)node_modules/', '\.log$', '\.tmp$' ] ); -
apply_filters( 'fluent_auth/integrity_plugin_targets', $targets ); -
apply_filters( 'fluent_auth/integrity_scan_budget', 20 ); -
apply_filters( 'fluent_auth/integrity_theme_targets', $targets ); -
fluent_auth/is_local_site
filterapply_filters( 'fluent_auth/is_local_site', $isLocal, $host, $environment ); -
apply_filters( 'fluent_auth/lockout_help_delay', 50 ); -
apply_filters( 'fluent_auth/login_assets_config', $config ); -
do_action( 'fluent_auth/login_attempts_checked', $user ); -
fluent_auth/login_form_args
filterapply_filters( 'fluent_auth/login_form_args', [ 'echo' => false, 'redirect' => $redirect, 'force_redirect_to' => $requestedRedirectTo, 'remember' => true, 'value_remember' => true, 'action_url' => site_url('/') ] ); -
apply_filters( 'fluent_auth/login_hash_retention_days', max(30, (int)$oldDays) ); -
apply_filters( 'fluent_auth/login_media_labels', [ 'web' => __('Login form', 'fluent-security'), 'magic_login' => __('Magic link', 'fluent-security'), 'email_2fa' => __('Email code', 'fluent-security'), 'totp' => __('Authenticator app', 'fluent-security'), 'two_factor_email' => __('Email code', 'fluent-security'), 'two_factor_totp' => __('Authenticator app', 'fluent-security'), 'two_factor_passkey' => __('Passkey', 'fluent-security'), 'passke... ); -
apply_filters( 'fluent_auth/login_security_enabled', true ); -
apply_filters( 'fluent_auth/low_level_user_roles', $formattedRoles, $roles ); -
apply_filters( 'fluent_auth/magic_login_error_message', __('Your account cannot use sign-in links. Please use the normal login form.', 'fluent-security'), $user ); -
apply_filters( 'fluent_auth/magic_login_floor_limit', 10 ); -
apply_filters( 'fluent_auth/magic_login_floor_timing', 30 ); -
fluent_auth/onboarding_steps
filterapply_filters( 'fluent_auth/onboarding_steps', [ 'connection' => [ 'title' => __('Connection', 'fluent-security'), 'headline' => __('Is this the address you are visiting from?', 'fluent-security'), 'why' => __('Failed logins are counted per visitor address, so the site has to be seeing the real one.', 'fluent-security'), 'preview' => 'connection', 'checks' => [], 'available' => function () { $detection = ProxyDetection::detect(); if ($detec... ); -
fluent_auth/optin_url
filterapply_filters( 'fluent_auth/optin_url', self::ENDPOINT ); -
apply_filters( 'fluent_auth/passkey_allow_without_fallback', false, $user ); -
do_action( 'fluent_auth/passkey_login_completed', $user, $credential ); -
do_action( 'fluent_auth/passkey_login_refused', $reason, $user ); -
apply_filters( 'fluent_auth/passkey_primary_login', true ); -
do_action( 'fluent_auth/passkey_registered', $userId, $id ); -
fluent_auth/passkey_removed
actiondo_action( 'fluent_auth/passkey_removed', $userId, (int)$id ); -
fluent_auth/passkeys_cleared
actiondo_action( 'fluent_auth/passkeys_cleared', $userId ); -
apply_filters( 'fluent_auth/pre_report_extension_inventory', null ); -
apply_filters( 'fluent_auth/recommended_settings', [ 'disable_xmlrpc' => 'yes', 'disable_users_rest' => 'yes', 'secure_signup_form' => 'yes', 'login_try_limit' => 5, 'login_try_timing' => 30, 'auto_delete_logs_day' => 30, 'notification_user_roles' => ['administrator'], 'notification_email' => '{admin_email}', 'notify_on_blocked' => 'no', 'magic_login' => 'no', 'magic_restricted_roles' => [], 'magic_link_primary' => 'no', 'email2fa' => 'yes', 'e... ); -
do_action( 'fluent_auth/recovery_code_used', $userId, self::countRemaining($userId) ); -
do_action( 'fluent_auth/recovery_codes_generated', $userId, count($codes) ); -
apply_filters( 'fluent_auth/registration_form_fields', [ 'first_name' => [ 'required' => true, 'type' => 'text', 'label' => __('First Name', 'fluent-security'), 'id' => 'fls_first_name', 'placeholder' => __('First Name', 'fluent-security') ], 'last_name' => [ 'type' => 'text', 'label' => __('Last Name', 'fluent-security'), 'id' => 'fls_last_name', 'placeholder' => __('Last Name', 'fluent-security') ], 'username' => [ 'required' => true, 'type' => '... ); -
apply_filters( 'fluent_auth/remote_auth_response_data', [ 'remote_user_id' => $user->ID, 'user_login' => $user->user_login, 'user_email' => $user->user_email, 'user_nicename' => $user->user_nicename, 'user_url' => $user->user_url, 'nickname' => $user->nickname, 'locale' => $user->locale, 'display_name' => $user->display_name, 'user_registered' => $user->user_registered, 'roles' => array_values($user->roles), 'first_name' => $user->first_name, 'last_... ); -
apply_filters( 'fluent_auth/report_extension_inventory', [ 'extensions' => $named, 'extensions_untracked' => $untracked ] ); -
apply_filters( 'fluent_auth/reset_password_form', [ 'user_login' => [ 'required' => true, 'type' => 'text', 'label' => __('Email Address', 'fluent-security'), 'id' => 'fls_email', 'placeholder' => __('Your Email Address', 'fluent-security') ] ] ); -
apply_filters( 'fluent_auth/reset_password_link', sprintf(__('Reset your password for %s', 'fluent-security'), get_bloginfo('name')) ); -
apply_filters( 'fluent_auth/reset_password_mail_subject', sprintf(__('Reset your password for %s', 'fluent-security'), get_bloginfo('name')) ); -
apply_filters( 'fluent_auth/reset_password_message', $message, $user_data, $resetLink ); -
apply_filters( 'fluent_auth/respect_front_login_url', true ); -
apply_filters( 'fluent_auth/scan_backup_suffixes', self::BACKUP_SUFFIXES ); -
apply_filters( 'fluent_auth/scan_expected_dir_max_files', 2000 ); -
apply_filters( 'fluent_auth/scan_expected_root_dirs', self::EXPECTED_DIRS ); -
apply_filters( 'fluent_auth/scan_generated_file_patterns', self::GENERATED_PATTERNS ); -
apply_filters( 'fluent_auth/scan_htaccess_exec_directives', [ 'addhandler', 'sethandler', 'addtype', 'action', 'script', 'execcgi', 'php_value', 'php_flag', 'php_admin_value', 'php_admin_flag', 'auto_prepend_file', 'auto_append_file', 'cgi-script', 'fcgid', 'wsgi' ] ); -
apply_filters( 'fluent_auth/scan_root_file_is_noise', false, $name ); -
apply_filters( 'fluent_auth/scan_runnable_extensions', self::RUNNABLE ); -
apply_filters( 'fluent_auth/scan_system_noise_names', self::SYSTEM_NOISE_NAMES ); -
apply_filters( 'fluent_auth/secret_key_material', $material ); -
fluent_auth/security_checks
filterapply_filters( 'fluent_auth/security_checks', $checks ); -
apply_filters( 'fluent_auth/show_lockout_help', user_can($user, 'manage_options'), $user ); -
fluent_auth/show_optin
filterapply_filters( 'fluent_auth/show_optin', true ); -
apply_filters( 'fluent_auth/signup_complete_response', $response, $user ); -
apply_filters( 'fluent_auth/signup_loading_icon', $loadingIcon ); -
apply_filters( 'fluent_auth/signup_policy_url', $policyUrl ); -
apply_filters( 'fluent_auth/signup_verification_email_body', $message, $verifcationCode, $formData ); -
apply_filters( 'fluent_auth/signup_verification_mail_subject', sprintf(__('Your registration verification code for %s', 'fluent-security'), get_bloginfo('name')) ); -
apply_filters( "fluent_auth/smartcode_group_callback_{$dataKey}", $matches[0], $valueKey, $defaultValue, $user ); -
apply_filters( 'fluent_auth/smartcode_meta_is_private', false, $key ); -
apply_filters( 'fluent_auth/smartcode_user_properties', [ 'ID', 'user_login', 'user_email', 'user_nicename', 'user_url', 'user_registered', 'display_name', 'nickname', 'first_name', 'last_name', 'description', 'locale' ] ); -
do_action( "fluent_auth/social/rendering_button_{$buttonKey}", $button ); -
fluent_auth/totp_activated
actiondo_action( 'fluent_auth/totp_activated', $userId ); -
fluent_auth/totp_disabled
actiondo_action( 'fluent_auth/totp_disabled', $userId ); -
fluent_auth/trusted_proxies
filterapply_filters( 'fluent_auth/trusted_proxies', $proxies ); -
do_action( 'fluent_auth/two_fa_bypass_used', $user ); -
apply_filters( 'fluent_auth/two_fa_bypass_value', $value ); -
apply_filters( 'fluent_auth/unattended_login_request', $unattended ); -
apply_filters( 'fluent_auth/uploads_probe_sslverify', true ); -
apply_filters( 'fluent_auth/uploads_probe_ttl', $ttl, $result ); -
do_action( 'fluent_auth/user_login_success', $user ); -
fluent_auth/user_role
filterapply_filters( 'fluent_auth/user_role', get_option('default_role') ); -
apply_filters( 'fluent_auth/validate_password_length', true ); -
apply_filters( 'fluent_auth/validated_redirect', $validated, $location, $fallback ); -
apply_filters( 'fluent_auth/webauthn_allowed_origins', [$origin] ); -
apply_filters( 'fluent_auth/webauthn_creation_options', $options, $user ); -
apply_filters( 'fluent_auth/webauthn_request_options', [ 'challenge' => Base64Url::encode($challenge), 'rpId' => RelyingParty::getId(), 'allowCredentials' => $allow, 'timeout' => 120000, 'userVerification' => Ceremony::getUserVerificationRequirement() ], $credentials ); -
fluent_auth/webauthn_rp_id
filterapply_filters( 'fluent_auth/webauthn_rp_id', $host ); -
fluent_auth/webauthn_rp_name
filterapply_filters( 'fluent_auth/webauthn_rp_name', get_bloginfo('name') ); -
do_action( 'fluent_auth/webauthn_sign_count_reused', $credential, $presented, $stored ); -
do_action( 'fluent_auth/webauthn_unexpected_attestation', $format ); -
apply_filters( 'fluent_auth/webauthn_user_verification', 'required' ); -
apply_filters( 'fluent_auth/will_disable_magic_form', false ); -
fluent_auth/wp_config_path
filterapply_filters( 'fluent_auth/wp_config_path', $path ); -
apply_filters( 'fluent_auth/wp_config_write_blocked', $blocked ); -
do_action( 'fluent_auth/wp_system_email_head' ); -
fluent_security/app_vars
filterapply_filters( 'fluent_security/app_vars', [ 'slug' => 'fluent-security', 'nonce' => wp_create_nonce('fluent-security'), 'rest' => [ 'base_url' => esc_url_raw(rest_url()), 'url' => rest_url('fluent-auth'), 'nonce' => wp_create_nonce('wp_rest'), 'namespace' => 'fluent-auth', 'version' => '1' ], 'auth_statuses' => Helper::getLogStatuses(), 'auth_log_views' => self::getLogViews(), 'auth_settings' => Helper::getAuthSettings(), 'recommended_... ); -
login_form_bottom
filterapply_filters( 'login_form_bottom', '', $args ); -
login_form_defaults
filterapply_filters( 'login_form_defaults', $defaults ); -
login_form_middle
filterapply_filters( 'login_form_middle', '', $args ); -
login_form_top
filterapply_filters( 'login_form_top', '', $args ); -
lostpassword_errors
filterapply_filters( 'lostpassword_errors', $errors, $user_data ); -
lostpassword_post
actiondo_action( 'lostpassword_post', $errors, $user_data ); -
lostpassword_user_data
filterapply_filters( 'lostpassword_user_data', $user_data, $errors ); -
register_new_user
actiondo_action( 'register_new_user', $user_id ); -
register_post
actiondo_action( 'register_post', $sanitized_user_login, $user_email, $errors ); -
registration_errors
filterapply_filters( 'registration_errors', $errors, $sanitized_user_login, $user_email ); -
retrieve_password
actiondo_action( 'retrieve_password', $user_login ); -
apply_filters( 'retrieve_password_notification_email', $defaults, $resetKey, $user_login, $user_data ); -
user_registration_email
filterapply_filters( 'user_registration_email', $user_email ); -
wp_login_failed
actiondo_action( 'wp_login_failed', $user->user_login, new \WP_Error( 'fls_invalid_2fa_code', __('That code is not correct.', 'fluent-security') ) );
Generated from FluentAuth's GPL-licensed source code. Hooks inside bundled third-party libraries are not listed.
Can't find the right hook?
We can build the customisation for you. Describe what you need: