=== Precision Hreflang ===
Contributors: precisionplugins
Tags: hreflang, multisite, multilingual, international seo, localization
Requires at least: 6.2
Stable tag: 2.0.2
Tested up to: 7.0
Requires PHP: 7.4
License: GPLv3
License URI: https://www.gnu.org/licenses/gpl-3.0.html

Manage hreflang relationships across a WordPress Multisite network from one central interface. Hreflang tags are generated automatically.

== Description ==
International SEO depends on correctly identifying equivalent content in different languages and regions. Precision Hreflang helps you build and maintain those relationships across your WordPress Multisite network.

Network administrators: Precision Hreflang is managed centrally. After network activation, the plugin is configured from the main site and manages hreflang relationships across the entire multisite network.

For each group of equivalent pages, simply choose the language, country and corresponding page from anywhere in your network. The plugin generates the required hreflang tags automatically.

Because pages are linked by identity rather than fixed URLs, hreflang tags continue to work as pages evolve. Renaming a page, changing a permalink or publishing updated content does not require you to recreate your hreflang relationships.

Precision Hreflang was developed from the experience of managing a production WordPress Multisite with 19 languages.

Existing plugins made it difficult to see the overall picture. We wanted a single view of every hreflang relationship because validating international SEO is much easier when you can see how every page connects to every other page.


== Features ==

* Getting Started guide for users new to hreflang.
* Point-and-click page selection from across your WordPress Multisite network.
* Keeps hreflang relationships up to date by automatically handling permalink changes, deleted pages and unpublished content.
* Validate your international SEO more easily with a single view of every hreflang relationship.
* Designed specifically for WordPress Multisite.

== Installation ==

= Minimum Requirements =

* PHP 7.4 or greater is required (PHP 8.0 or greater is recommended)
* MySQL 5.5.5 or greater, OR MariaDB version 10.1 or greater, is required
* WordPress 5.8 or greater

1. Install through the WordPress plugin directory, or upload the plugin files to the /wp-content/plugins/ directory.
2. Network Activate the plugin.
3. Visit the main site and configure Precision Hreflang.

= WordPress Multisite =

Precision Hreflang is designed for WordPress Multisite.

After network activation, configure the plugin from the main site. The hreflang relationships are managed centrally for the entire network.

= Manual installation =

Manual installation method requires downloading the Precision Hreflang plugin and uploading it to your web server via your favorite sFTP/scp application. The WordPress codex contains [instructions on how to do this here](https://wordpress.org/support/article/managing-plugins/#manual-plugin-installation).

= Updating =

Automatic updates should work smoothly, but we still recommend you back up your site.

== Frequently Asked Questions  ==
= Why does the editor refresh URLs? =
To keep large hreflang sets responsive, the editor refreshes the current URLs for picked pages when you open a group. This only affects what you see in the editor. The hreflang tags generated on your website always use the current page URLs.

= Why doesn't adding content create hreflang tag relationships? =
Hreflang relationships describe equivalent content in different languages or regions. The plugin cannot determine whether a newly created page is a translation of an existing page, so relationships must be created explicitly.

= Can I create tags for products in WooCommerce? =
Yes. Products are WordPress content, so they can be linked in exactly the same way as pages and posts.

= I can't find the menu on my site =

If you're using WordPress Multisite, Precision Hreflang is configured from the main site after network activation. The plugin manages hreflang relationships for the entire network from a single location.

== Screenshots ==
1. Manage hreflang relationships from the main site of your WordPress Multisite network.

2. Link corresponding pages across your multisite network using the page picker.

3. Review every hreflang relationship from a single overview.

4. Edit language and regional relationships for a page group.

== Changelog ==

= 2.0.2 =

* Improved Multisite target picker AJAX endpoint handling.
* Updated WordPress.org translation handling.
* Adjusted admin menu placement to follow WordPress guidelines.


= 2.0.1 =

* First public release.
