MM SEO Internal Link Management

=== MM SEO Internal Link Management === Contributors: hardawebpro Tags: tags, internal links, seo, auto link, content Requires at least: 6.0 Tested up to: 6.8 Requires PHP: 7.4 Stable tag: 1.0.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically link configured anchor phrases in post content to post tag archive pages.

== Description ==

MM SEO Internal Link Management (MM SEO ILM) helps you build internal links from post content to your post tags.

• List every existing post tag and set custom anchor phrases (priority first, then fallbacks)
• Leave anchors blank to use the tag name
• Tag permalinks are generated automatically (read-only in settings)
• Limit how many times each tag is linked per post
• Enable the linker on any combination of public post types (Media/Attachment is always excluded)
• Case-insensitive matching that preserves the original casing of linked text
• Skips existing links, headings, excerpts, and non-allowed HTML contexts
• Optional WordPress Abilities API integration on WordPress 6.9+ for read-only settings/status

Settings are available under Settings → MM SEO ILM, including an in-plugin “How this plugin works” guide.

== Installation ==

1. Upload the mm-seo-internal-link-management folder to the /wp-content/plugins/ directory, or install the ZIP via Plugins → Add New.
2. Activate the plugin through the Plugins screen.
3. Go to Settings → MM SEO ILM to configure anchors, post types, and the per-tag link limit.

== Frequently Asked Questions ==

= How should I format anchor text? =

Use commas to separate phrases. Spaces after commas are optional:

• SEO, Search Engine Optimization (recommended)
• SEO,Search Engine Optimization (also valid)

The first phrase is priority; later ones are fallbacks (classic mode) or additional unique-link candidates (when “Allow multiple links…” is on). Leave blank to use the tag name. Matching is case-insensitive.

= Can multiple anchors link to the same tag URL? =

Yes, if you enable Duplicate tag links (allow multiple links when anchor text differs). Then set Max unique anchors to link. Example: anchors Google Search Ads, Google Ads with max 2 may create two links to /tag/google-search-ads/ — one per phrase. With the option off, all phrases share a single per-tag quota.

= Which taxonomies are supported? =

Version 1 supports the built-in post_tag taxonomy only.

= Where does linking run? =

Only on the_content for singular views of enabled post types. Excerpts and captions are not modified. Media (attachment) pages are never processed.

= Will it overwrite my existing links? =

No. Text already inside an anchor (or inside skipped elements such as headings) is left unchanged.

= Do I need to purge cache after saving settings? =

Yes, if you use a full-page cache. Auto-links are generated when WordPress renders the_content. Cached HTML may still show the previous linking state until that cache is cleared.

After you click Save settings, MM SEO ILM:

1. Fires the mm_seo_ilm_settings_updated action (and mm_seo_ilm_after_cache_purge) so custom stacks can clear Nginx/Apache proxy or CDN caches.
2. Best-effort notifies common plugins such as LiteSpeed Cache, WP Rocket, W3 Total Cache, WP Super Cache, WP Fastest Cache, and Cache Enabler.
3. Shows a reminder notice on the MM SEO ILM settings screen.

Redis object cache does not need a full flush for this — page/proxy HTML cache is what matters.

Example for a custom purge:

add_action( 'mm_seo_ilm_settings_updated', 'my_purge_nginx_cache' );

== Changelog ==

= 1.0.0 =

• Initial release as MM SEO Internal Link Management (renamed from MM Auto Link to Tag).

== Upgrade Notice ==

= 1.0.0 = Initial release under the MM SEO Internal Link Management name.