=== Hreflang Customizer ===
Contributors: jems007
Donate link: https://ko-fi.com/jemssaliya
Tags: hreflang, hreflang tags, seo, multilingual, international seo
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.1.0
Requires PHP: 7.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Easily add hreflang tags to any WordPress site. Works standalone — no translation plugin required.

== Description ==

**Hreflang Customizer** is a free plugin that generates hreflang tags for your WordPress pages automatically. It works on any site — no multilingual plugin is required.

Hreflang tags tell search engines which language and region each page targets. This prevents duplicate-content issues across multilingual or multi-regional sites and helps the right version of your page rank in the right country.

= Key Features =

* ✅ Works **without** any translation plugin — standalone mode out of the box
* ✅ Also integrates with **Weglot** for translated URL mapping
* ✅ Searchable language picker with 180+ languages and regional variants
* ✅ Selected languages shown as removable tag chips with language codes
* ✅ Language list cached via WordPress Transients API (no repeated API calls)
* ✅ Clean, modern admin UI — fully responsive
* ✅ No upsells, no premium tier — 100% free

= How It Works =

**Standalone mode:** Select your target language codes in the settings page. The plugin outputs one `<link rel="alternate" hreflang="...">` tag per selected code in the `<head>` of every page, pointing to the canonical URL of that page.

**Weglot mode:** If Weglot is installed and active, the plugin maps Weglot's translated URLs to your selected hreflang codes automatically.

= Example Output =

`<link rel="alternate" href="https://yoursite.com/about/" hreflang="en-AU" />`
`<link rel="alternate" href="https://yoursite.com/about/" hreflang="en-GB" />`
`<link rel="alternate" href="https://yoursite.com/" hreflang="x-default" />`

= Third-Party Service =

This plugin optionally fetches an extended language list from **https://app.seo-hreflang.com/api/languages** to supplement its built-in language database. The request is made at most once every 12 hours. No personal data, user data, or site content is transmitted — the request contains no body payload. The result is cached locally using the WordPress Transients API.

If the external service is unavailable, the plugin automatically falls back to its built-in list of 180+ languages and continues to work normally.

* Service URL: https://app.seo-hreflang.com/
* Privacy Policy: https://seo-hreflang.com/privacy-policy/

== Installation ==

1. In your WordPress dashboard, go to **Plugins > Add New**
2. Search for **Hreflang Customizer**
3. Click **Install Now**, then **Activate**
4. Go to **Hreflang > Settings** and select your target languages
5. Click **Save Languages** — hreflang tags will appear in your site's `<head>` immediately

Alternatively, download the zip and upload via **Plugins > Add New > Upload Plugin**.

== Frequently Asked Questions ==

= Do I need a translation plugin? =
No. The plugin works standalone. It outputs hreflang tags pointing to your current page URLs. If you also use Weglot, it will automatically map Weglot's translated URLs instead.

= Which translation plugins are supported? =
Currently Weglot is fully supported in addition to standalone mode. Support for WPML, TranslatePress and Polylang is planned for a future release.

= What is x-default? =
`x-default` is a special hreflang value that tells Google which page to show when no other language matches the user's browser language. When selected, it points to your site's home URL.

= Does the plugin make external requests? =
Yes, optionally. It requests a language list from https://app.seo-hreflang.com/api/languages and caches the result for 12 hours. If the server is unreachable, the built-in language list is used. No user or site data is sent.

= What are the minimum requirements? =
WordPress 5.8 or higher and PHP 5.6.20 or higher.

== Screenshots ==

1. Settings page — searchable language card grid with sidebar tag panel.
2. Selected languages shown as tag chips with the hreflang code badge.
3. System status page with environment diagnostics.

== Changelog ==

= 1.1.0 =
* Plugin is now fully free — no premium tier
* Added standalone mode: hreflang tags work without any translation plugin
* Added Weglot integration for translated URL mapping
* Completely redesigned admin UI with searchable language grid
* Language codes now shown as badge chips on selected tags
* Built-in static language fallback (180+ languages) when API is unavailable
* Added "Buy me a coffee" donate link
* Fixed: CSS/JS now loads reliably on all server configurations
* Fixed: all WordPress.org security requirements (sanitize, escape, validate)
* Removed: premium/pro version references
* Removed: Select2 dependency

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.1.0 =
Major free release. Standalone mode, redesigned UI, improved security. Recommended for all users.
