=== Custom Login ===
Contributors: austyfrosty, frostymedia
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=7431290
Tags: admin, branding, customization, custom login, logo
Requires at least: 6.4
Tested up to: 6.8.3
Requires PHP: 7.4
Stable tag: 5.1.2.2
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Custom Login allows you to easily customize your admin login page, works great for client sites!

== Description ==

NOTE: in Custom Login 4.4, PHP 8.1 or greater was required, but in version 5.x, PHP requirements were
dropped back to 7.4 or greater. Enjoy the update.

Custom Login 3.0 was 200% faster than version 2.0, and version 4.0 and 5.0 is now even better!

For more information visit the official [Custom Login](https://frosty.media/plugins/custom-login/) page.

> <strong>Support</strong><br>
> [Austin](https://austin.passy.co) and the [Frosty Media](https://frosty.media/) team will always try our best to support the Custom Login plugin on the WordPress.org forum, but please note that we can not guarantee a response in a timely manner. If you have an issue we would appreciate you using GitHub or purchasing priority support on our site.
>
> Any extensions purchased on [Frosty Media](https://frosty.media/) (not hosted on WordPress.org) will not be supported on the WordPress.org forum. You can always browse our *small* but growing [documentation](https://frosty.media/docs) for further assistance. You need a valid license key to make support submissions *on our site*. We thank you in advance.

> <strong>Bug Reports</strong><br>
> Bug reports for Custom Login are [welcomed on GitHub](https://github.com/thefrosty/custom-login).

= Video =

https://www.youtube.com/watch?v=hZkc-t36xYQ

= Extensions =

There are currently seven premium extensions available, with more coming (suggestions welcome - and *will be offered for free to said user*).

**Extensions available now**

* [Stealth Login](https://frosty.media/plugins/custom-login-stealth-login/?utm_source=wordpressorg&utm_medium=custom-login&utm_campaign=readme.txt "Custom Login Stealth Login") - obscure your login URL.
* [Page Template](https://frosty.media/plugins/custom-login-page-template/?utm_source=wordpressorg&utm_medium=custom-login&utm_campaign=readme.txt "Custom Login Page Template") - add a login form to any WordPress page.
* [Login Redirects](https://frosty.media/plugins/custom-login-redirects/?utm_source=wordpressorg&utm_medium=custom-login&utm_campaign=readme.txt "Custom Login Redirects") - Manage login redirects.
* [No Password](https://frosty.media/plugins/custom-login-no-password-login/?utm_source=wordpressorg&utm_medium=custom-login&utm_campaign=readme.txt "Custom Login No Password logins") - allow users to login without a password.
* [Style Pack #1](https://frosty.media/plugins/custom-login-style-pack-1?utm_source=wordpressorg&utm_medium=custom-login&utm_campaign=readme.txt "Custom Login Style Pack #1") - four pre-designed login styles.
* [Style Pack #2](https://frosty.media/plugins/custom-login-style-pack-2?utm_source=wordpressorg&utm_medium=custom-login&utm_campaign=readme.txt "Custom Login Style Pack #2") - four pre-designed fun login styles.
* [Style Pack #3](https://frosty.media/plugins/custom-login-style-pack-3?utm_source=wordpressorg&utm_medium=custom-login&utm_campaign=readme.txt "Custom Login Style Pack #3") - four pre-designed holiday login styles.

**Extensions in development/extension ideas**

* Email Logins for usernames.
* 2-step Authentication.
* "Super User" only access for client sites.
* **Added in core as of version 3.0** Remove default WordPress login CSS.
* Submit button styles!
* **Added as of version 3.2** Custom Login pre-made settings templates *AKA* [Style Packs](https://frosty.media/plugin/tag/style-pack/).

= More info =

Activate the plugin and customize your WordPress login screen. It's as easy as modifying a few settings, there is no need to understand CSS at all. Custom Login even has a HTML, CSS &amp; jQuery textarea for more advanced customizations.

1. **Read more about [Custom Login 5.0](https://frosty.media/2025/custom-login-5-0-released/)**
2. Read more about [Custom Login 4.1](https://frosty.media/2023/custom-login-4-1-x-released/)
3. Read more about [Custom Login 4.0](https://frosty.media/2022/custom-login-4-0-x-released/)
4. Read more about [Custom Login 3.1](https://frosty.media/2015/custom-login-v3-1-released/)

**For those looking to show off your login screen, check out the [Flickr group](https://flickr.com/groups/custom-login/)! Share you designs with the community!**

= links =

* Additional Plugins: [https://frosty.media/plugins](https://frosty.media/plugins/ "Premium WordPress Plugins by Frosty")
* Austins Blog: [https:/austin.passy.co/](https://austin.passy.co/ "Austin's blog")
* Austin on Twitter: [@TheFrosty](https:/x.com/TheFrosty "Austin on X (Twitter)")
* Frosty Media on Twitter: [@Frosty_Media](https:/x.com/Frosty_Media "Frosty Media on X (Twitter)")
* Development welcomed on **[GitHub](https://github.com/thefrosty/custom-login)**

== Installation ==

Follow the steps below to install the plugin.

1. Upload the `custom-login` directory to the /wp-content/plugins/ directory.
2. Activate the plugin through the 'plugins' menu in WordPress.
3. Go to Settings/custom-login to edit your settings.
4. Design away.
5. Activate the settings by checking "Enable" in the "General Settings" tab.

== Frequently Asked Questions ==

= What are extensions? =
They are additional plugins that add/extend functionality to the Custom Login plugin. You can find all Custom Login extensions on [Frosty.Media](https://frosty.media).

= Where can I upload and share my cool login screen? =
Check out the [Flickr group](https://flickr.com/groups/custom-login/)! Upload and add it to our pool!

= I think I want to uninstall =
Just deactivate it. Sad panda is sad.

= Where do I report security bugs found in this plugin? =
Please report security bugs found in the source code of the Custom Login plugin through the
[Patchstack Vulnerability Disclosure Program](https://patchstack.com/database/vdp/custom-login). The Patchstack team will assist you with
verification, CVE assignment, and notify the developers of this plugin.

== Screenshots ==

Custom Login showcase on the [Flickr group](https://flickr.com/groups/custom-login/).

1. Custom Login v3 Design Settings part 1.

2. Custom Login v3 Design Settings part 2.

3. Custom Login v3 General Settings.

4. Custom Login Extensions Installer (an active license key is required).

== Changelog ==

= Version 5.1.2.2 (2025/11/29) =

* Upstream dependency updates from thefrosty/wp-utilities.
* Don't load vendor/autoload.php if already autoloaded externally.

= Version 5.1.2.1 (2025/11/23) =

* Fix edge case Fatal error found in legacy plugins using Hash from thefrosty/wp-utilities update.

= Version 5.1.2 (2025/11/22) =

* Bump thefrosty/wp-utilities.

= Version 5.1.1 (2025/11/14) =

* Resolve `gettext` mixed type fatal error.

= Version 5.1.0 (2025/11/14) =

* Bump js-yaml and standard by @dependabot[bot]
* Feature: Add Login style <img> with `srcset` for responsive image backgrounds.

= Version 5.0.2 (2025/10/11) =

* Remove roave/security-advisories (due to political support on their README I don't agree with).

= Version 5.0.1 (2025/07/16) =

* Fix: export-ignore for Composer installs.
* Bump PHPUnit to 11.
* Change Requires PHP back to 8.3 (modified in downgrade action for WordPress repo)

= Version 5.0.0 (2025/07/15) =

* Tested up to 6.8.2
* Bumped dependencies for PHP >= 8.3.
* Dropped plugin PHP support back to >= 7.4 (WordPress repo) with Rector.
* Add better Composer installation support, requires PHP >= 8.3 (for installations via Packagist).

= Version 4.5.2 (2025/06/10) =

* Bump WP Utilities to 3.4.3
* Resolve dashboard visibility no hiding on setting toggle.
* Update default remote request timeout from 15 to 2 seconds.

= Version 4.5.1 (2025/05/20) =

* Only load Import/Export on Custom Login Settings page.

= Version 4.5.0 (2025/05/14) =

* Add roave/security-advisories
* Update codecov-action to v5
* Setting: Expose Extensions Submenu
* 🔄 Regenerate translation files
* Readme Updates
* Update references from Twitter to X.
* Hide "active" Custom Login Extensions from the plugins.php page
* Bug: Fix Codemirror syntax issue

= Version 4.4.0 (2025/04/14) =

* Requires PHP >= 8.1.
* Bump Tested up to too "6.8.0".
* Resolve "Translation loading for the custom-login domain was triggered too early" added in WP 6.7.0.

= Version 4.3.0 (2024/10/30) =

* Bump Tested up to too "6.7.0"
* Updated login logo HTML attribute for CSS targeting in WP 6.7.

= Version 4.2.0 (2024/04/25) =

* Bump Tested up to too "6.5.2"
* Resolve possible "Uncaught TypeError" when initializing wp.codeEditor on empty element.

= Version 4.1.1 (2023/12/13) =

* Resolve Security Vulnerability (CVE-2023-49858).

= Version 4.1.0 (2023/11/09) =

* Drop support for PHP <= 7.4.
* Resolve PHP deprecation notices in PHP 8.2.
* Official supported WordPress is >= 6.2.
* Tested with WordPress 6.4.
* Remove deprecated function `CUSTOMLOGIN()`.
* Fix: resolve use of path instead of URL for animate.css.

= Version 4.0.12 (2023/12/13) =

* Resolve Security Vulnerability (CVE-2023-49858).

= Version 4.0.11 (2023/09/20) =

* Fix: Removed Opis Closure package (causing PHP deprecation notices in 8.1+).

[Full CHANGELOG](https://github.com/thefrosty/custom-login/blob/develop/README.md#changelog)
[All Releases](https://github.com/thefrosty/custom-login/releases)

== Upgrade Notice ==

= 5.0.1 =
Requires WordPress version >= 6.4 and PHP version >= 7.4.

= 4.4.0 =
Requires WordPress version >= 6.6 and PHP version >= 8.1.

= 4.1.0 =
Requires WordPress version >= 6.2 and PHP version >= 8.0.

= 4.0.1 =
Requires WordPress version >= 5.8 and PHP version >= 7.4.

= 3.2.14 =
Getting ready for version 4.0.0 which will bump minimum required WordPress version to 5.8 and PHP version to 7.4.
