=== Kybern UI Login ===
Contributors: kybern
Tags: login, branding, custom logo, login page, admin
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Brand the native WordPress login with a Media Library logo, adaptive logo colours, responsive styling, and a live preview.

== Description ==

Kybern UI Login gives administrators a focused way to brand the native WordPress login screen without editing a theme or maintaining PHP snippets.

Choose a logo from the WordPress Media Library and the settings screen analyses its dominant colours and their approximate positions directly in your browser. Those values create a subtle, light gradient background while accessible action colours keep buttons, links, and focus states readable.

Features:

* Select, replace, or remove a dedicated login logo through the Media Library.
* Fall back automatically to the active theme's custom logo.
* Link the logo to the website home page and use the site name as accessible link text.
* Analyse two distinct logo colours and their positions without server image libraries.
* Fine-tune colours and gradient positions manually.
* Preview changes before saving.
* Reset branding to safe defaults.
* Keep lost-password, registration, privacy, language, 2FA, and security-plugin states usable.
* Load CSS only on WordPress login screens and plugin assets only on its settings page.

The plugin uses no remote APIs, tracking, third-party libraries, front-end assets, or custom database tables. It stores one versioned option containing the selected attachment ID and final colour settings. Image pixels never leave the browser and are never saved.

== Installation ==

1. Upload the `kybern-ui-login` folder to `/wp-content/plugins/`, or install the ZIP through **Plugins > Add New > Upload Plugin**.
2. Activate **Kybern UI Login**.
3. Open **Appearance > Kybern UI Login**.
4. Select a Media Library logo or use the active theme custom logo.
5. Review the automatic colour analysis and live preview, then save.
6. Open the normal WordPress login page in a private browser window to confirm the result.

== Frequently Asked Questions ==

= What happens if I do not select a plugin logo? =

The plugin uses the active theme's WordPress custom logo. If no custom logo exists, WordPress keeps its standard login logo.

= Which image formats can I use? =

PNG, JPEG, and WebP images work when WordPress accepts them. SVG images work only when the site already permits SVG uploads.

= Does automatic colour analysis upload my logo anywhere? =

No. Analysis runs in the settings-page browser with an off-screen canvas. Only the final colours and positions are saved.

= Can I adjust the generated design? =

Yes. Both colours and their horizontal and vertical positions can be adjusted before saving. Manual mode prevents future logo selections from running automatically.

= Will this affect the public website? =

No. Login styles load only on WordPress login screens. Settings assets load only under **Appearance > Kybern UI Login**.

= What happens when I deactivate or delete the plugin? =

Deactivation immediately restores the normal WordPress login presentation and keeps your settings. Deleting the plugin removes only its own settings option.

== Screenshots ==

1. Login Branding settings with Media Library controls and automatic colour analysis.
2. Live preview with logo-inspired colours and accessible form controls.
3. Responsive branded WordPress login screen on desktop.
4. Mobile login layout with preserved navigation and language controls.

== Privacy ==

Kybern UI Login does not collect, transmit, or track personal data. Logo analysis happens locally in the administrator's browser and no image-pixel data is stored. When a selected Media Library image is served from remote storage, an administrator-requested analysis may retrieve that image through WordPress so the browser can examine it. The plugin does not send site or user data to analytics services or other third parties.

== Changelog ==

= 1.0.0 =

* Added Media Library logo selection with custom-logo fallback.
* Added browser-based dominant-colour and position analysis.
* Added accessible responsive login styling and a live settings preview.
* Added manual colour controls and a secure reset-to-defaults action.
