=== Login Screen Image Swapper ===
Tags: login, logo, branding, customization
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 8.2
Stable tag: 1.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Give your WordPress login screen a custom logo and colors, with a live settings preview. A small, focused plugin from The Buddy Foundry.

== Description ==

Make the first screen your team sees feel like your website. Login Screen Image Swapper lets administrators personalize the standard WordPress login screen without editing a theme or writing CSS.

* Choose a logo from the Media Library or enter an image URL.
* Set the logo box dimensions while keeping the image's proportions.
* Set the logo link and accessible link text.
* Choose page and button colors with automatic black/white text contrast.
* Preview settings before saving, then open the actual login screen.
* Optionally hide the language switcher.
* Restore WordPress defaults with one settings action.
* Choose whether settings survive deletion. Media Library files are never deleted.

Settings are under Settings > Login Logo. Only users with manage_options can change them. The plugin uses the WordPress Settings API for permission and nonce checks. New installations leave the WordPress appearance unchanged until you save customizations.

This plugin styles wp-login.php, including its password-reset and registration screens. It does not change authentication, create a front-end login form, or replace login pages supplied by other plugins. Other login styling plugins may conflict.

Made by The Buddy Foundry, a brand of Blue Light Media LLC. Based on the original plugin by Alvin L. for My Brewing Buddy.

== Installation ==

1. In Plugins > Add New Plugin > Upload Plugin, select login-screen-image-swapper-1.1.0.zip.
2. Install and activate Login Screen Image Swapper.
3. Open Settings > Login Logo, choose your image, and save changes.
4. Open the saved login screen in a new tab to verify the result.

For manual installation, upload the login-screen-image-swapper folder to wp-content/plugins, then activate it. Requires WordPress 6.5 or newer and PHP 8.2 or newer.

== Frequently Asked Questions ==

= Does it work with my theme? =

It styles the standard WordPress login page independently of your theme. A theme or plugin that replaces the login page can override these styles. It does not style WooCommerce My Account or custom login forms.

= What image should I use? =

Use an image supported by your WordPress Media Library, such as PNG, JPEG, or WebP. A transparent PNG or WebP works well for a logo. The default box is 320 by 84 pixels; square logos can use a square box. Images keep their proportions and shrink to fit narrow screens. This plugin does not enable SVG uploads.

= Does it collect data or require an account? =

No account, license key, analytics, cookies, or remote service is added by this plugin. Settings stay in your WordPress database. If you enter an externally hosted image URL, visitors' browsers and the settings preview request that image from its host, which receives normal request information. Choose a Media Library image to keep image requests on your site's configured media host. WordPress and your host retain their own normal behavior.

= How do I update a direct download? =

Download a newer ZIP from the publisher and use Plugins > Add New Plugin > Upload Plugin to replace the installed copy. Settings are retained. This edition has no automatic update service; its Update URI protects it against replacement by a similarly named directory plugin. It is not yet a WordPress.org listing.

= Can I use it on client sites or multisite? =

Yes. Settings belong to each site, including new sites on a network. Network activation does not copy branding between sites. WordPress normally limits multisite settings saves to network administrators. Network deletion removes settings site by site, except where the keep-settings preference was saved.

= What happens when I deactivate or delete it? =

Deactivation restores WordPress's normal presentation and keeps settings. Deletion removes settings unless you previously saved “Keep my settings for a future reinstall”. Uploaded images are never removed. Restore defaults also clears the keep-settings preference.

= How do I migrate the original My Brewing Buddy edition? =

Both editions use lsis_settings. Back up that option and the original plugin first. Deactivate the original, then remove its Login-Screen-Image-Swapper folder using your file manager or SFTP WITHOUT using WordPress's Delete action (the old uninstaller deletes the shared settings). Install and activate this edition. Existing logo, colors, link, text and dimensions are preserved, with proportions now maintained. Do not activate both editions together. If both are active, the new edition shows a notice and defers to the original.

== Changelog ==

= 1.1.0 =
* First distributable edition under The Buddy Foundry brand.
* Added settings preview, responsive logo containment, automatic text contrast, reset controls and optional settings retention.
* Hardened URL, color and malformed-option handling; added translation support and per-site uninstall cleanup.
* Preserved the original settings option and documented migration from the My Brewing Buddy edition.

= 1.0.0 =
* Original private My Brewing Buddy edition by Alvin L.

== Upgrade Notice ==

= 1.1.0 =
Back up your settings before replacing the original private edition. Follow its migration instructions above; the original uninstaller deletes the shared settings.
