Documentation / Hooks and Filters
Hooks and Filters
Overview
WP Custom Login provides PHP actions, PHP filters, and JavaScript filters that allow developers to extend or modify the plugin’s behavior. These hooks follow standard WordPress and @wordpress/hooks conventions.
PHP Actions
custom_login__before_with_form_column
Fires before the form column is rendered on the login page. Use this to add custom HTML content before the main login form area.
add_action( 'custom_login__before_with_form_column', function () {
echo '<div class="my-custom-banner">Welcome</div>';
} );
custom_login__inside_column
Fires inside a layout column on the login page.
custom_login__after_with_form_column
Fires after the form column is rendered. Use this to add custom HTML content after the main login form area.
PHP Filters
custom_login__adjuster_classes
Modify the list of adjuster classes that generate CSS and markup changes for the login page.
add_filter( 'custom_login__adjuster_classes', function ( array $classes ): array {
// Add a custom adjuster class
$classes[] = My_Custom_Adjuster::class;
return $classes;
} );
custom_login__markup_adjustments
Modify the DOMDocument representation of the login page HTML before it is sent to the browser. Receives a DOMDocument and a DOMXPath object.
add_filter(
'custom_login__markup_adjustments',
function ( DOMDocument $doc, DOMXPath $xpath ): DOMDocument {
// Add a custom attribute to the login form
$forms = $xpath->query( '//form[@id="loginform"]' );
if ( $forms && $forms->length > 0 ) {
$forms->item( 0 )->setAttribute( 'data-custom', 'value' );
}
return $doc;
},
10,
2
);
custom_login__settings_loaded
Filter the settings data after it is loaded from the database. Useful for programmatically overriding settings.
custom_login__settings_fields_config
Filter the settings field definitions. Use this to add custom settings fields or modify validation rules.
JavaScript Filters
These filters use the @wordpress/hooks package and are available in the admin settings page context.
custom_login__settings_page_tabs
Filter the tab configuration for the settings page. Use this to add custom tabs.
custom_login__settings_page_design_panels
Filter the list of panels displayed in the Design tab.
custom_login__settings_page_design_templates
Filter the templates panel content in the Design tab.
custom_login__settings_page_functionality_panels
Filter the list of panels displayed in the Functionality tab.
FAQ
Find Answers to Common Questions
Browse these frequently asked questions to get quick answers about our plugin, features, and support.
Will This Plugin Work on My WordPress Website?
This plugin does not depend on any third-party libraries, plugins, or themes. It will work seamlessly on any WordPress website.
Does the Plugin Support My Language?
This plugin is translation-ready, enabling you to easily translate its content into your preferred language using any translation tool or plugin. By default, the plugin is provided in English.
What Are the Technical Requirements for This Plugin?
This plugin requires WordPress version 6.6 or later and PHP version 7.4 or later. It doesn’t require additional libraries or special hosting configurations.
The plugin has been tested up to WordPress 6.9 and PHP 8.3.
What Is Your Refund Policy?
We offer a risk-free, 30-day money-back guarantee. If you’re not satisfied with the plugin for any reason, you can request a full refund within 30 days of your purchase – no questions asked.
Is This Plugin Actively Maintained?
Yes! This plugin is actively maintained and regularly tested for compatibility with the latest versions of WordPress and PHP. For detailed information about updates, please refer to the changelog.
What Happens If I Don’t Renew My License?
You can continue to use the plugin even if your license expires; however, you will no longer receive plugin updates, new features, or access to support. Your license renews automatically each year unless canceled via the Customer Portal.
What Is the Difference Between the Free and PRO Versions?
The free version gives you full control over the login page’s visual design — custom logo, background color and image, form container styling, label and input field customization, primary and secondary button design, checkbox styling, notice and error message colors, under-form link styling, social media icons, custom footer, privacy policy link, language switcher controls, per-language text, and a custom CSS editor. You also get functionality options like disabling autofocus, the error shake animation, and browser autocomplete. Everything is configured from a visual settings page with a live preview.
The PRO version adds 20+ pre-designed templates you can apply in one click, advanced background options (multi-column split-screen layouts, image and video sliders, animated gradients, CSS image filters and color overlays), post-login redirect rules with per-role and per-user targeting, the ability to replace wp-login.php with a custom login URL, and priority support with automatic updates. See the pricing page for details.