### Key Features

• **Universal Joomla Compatibility:** Fully compatible with Joomla 4.x, Joomla 5.x, and the latest Joomla 6.x architectures.
  * **Official Google Integration:** Supports Google's official Web Component (`google-add-preferred-source-btn` via `publisher.js`) as well as the modern JavaScript Module API (`preferredSource.addPreferredSource()` via `publisher.mjs`).
  * **Smart Auto-Hide (LocalStorage):** Automatically and permanently hides the floating button for returning visitors once they have clicked and followed your domain, keeping the browsing experience clean and non-intrusive.
  * **Strict Google Guidelines Compliance:** Formats and passes clean, eligible domain or subdomain levels directly to Google Search preference endpoints, preventing 404 navigation errors.
  * **Dual Design Modes:**
    * *Official Google Rendered Button:* Automatically localized and rendered directly by Google's client library.
    * *Custom Styled Pill Button:* A floating action badge with Google branding, custom hover animations, and direct API triggers.
  * **Light & Dark Themes:** Matches your template styling with light and dark mode support.
  * **Flexible Floating Positions:** Choose between Bottom-Right, Bottom-Left, Top-Right, or Top-Left screen corners.
  * **Mobile Responsive:** Includes an option to toggle visibility on mobile and small viewports.
  * **Ultra-Lightweight & Fast:** Zero jQuery dependencies, clean vanilla JavaScript, and asynchronous script execution for optimal Core Web Vitals.
  * **Modern Architecture:** Built with native Service Providers, strict typing, and Dependency Injection conforming to modern Joomla 5 & 6 coding standards.

### How It Works

1. **Visitor Engagement:** Visitors see a stylish, subtle floating badge on your site prompting them to "Follow on Google".
2. **One-Click Action:** When clicked, the official Google Preferred Source dialog opens, allowing the user to mark your publication/domain as preferred in their Google account.
3. **Enhanced Discovery:** Once added, your content gains higher priority in that user’s Google Search results, Top Stories, and AI-generated overviews.
4. **Clean Session Handling:** The plugin records the action in the visitor's local storage and hides the button on subsequent page views.

---

### Requirements & Compatibility

* **Joomla Version:** Joomla 4.x / Joomla 5.x / Joomla 6.x
* **PHP Version:** PHP 8.1, 8.2, 8.3, or 8.4+
* **Dependencies:** None (Pure Vanilla JS & Native Joomla CMS APIs)