=== PinBoostr Internal Linking Assistant ===
Contributors: pinboostr
Tags: internal links, seo, internal linking, related posts, links
Requires at least: 5.6
Tested up to: 7.1
Requires PHP: 7.2
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Scan your posts and pages, get smart internal link suggestions from your own content, and insert them with one click. A free SEO tool.

== Description ==

**PinBoostr Internal Linking Assistant** helps you build a stronger internal linking structure — one of the most effective and overlooked on-page SEO wins.

The plugin scans your published posts and pages, looks for places where you mention the title of another piece of your own content, and suggests turning that text into an internal link. You review each suggestion and insert it with one click.

Better internal linking helps your readers discover more of your content and helps search engines understand how your pages relate to each other.

= Features =

* **Scan posts** — analyze all your published posts and pages in one click.
* **Relevance-ranked suggestions** — a custom matching engine builds anchors only from your post titles and weighs each phrase by how rare it is across your whole site (IDF). Boilerplate and common-ingredient phrases are ignored, and any phrase that could point to more than one post is dropped, so every suggestion is specific and points to the right destination.
* **One-click insert** — add a suggested link to the right spot in the post without opening the editor.
* **Content scores** — every post gets an internal-linking health score (0–100) based on incoming links, outgoing links, depth, and untapped opportunities.
* **Site stats** — see average score, total internal links, orphan pages (no incoming links), and dead-end pages (no outgoing links) at a glance.
* **Editor sidebar** — see suggestions for the post you are currently editing.
* **Safe by design** — links are only inserted into plain text, never inside existing links or HTML tags. Existing links are left untouched.
* **No lock-in** — no account required, nothing is sent to external servers.

= Privacy =

This plugin runs entirely on your own site. It does not collect, send, or store any data on external servers.

= About =

This free tool is built and maintained by [PinBoostr](https://pinboostr.com), a platform that helps content creators grow traffic with automated Pinterest marketing.

== Installation ==

1. Upload the `pinboostr-internal-linking-assistant` folder to the `/wp-content/plugins/` directory, or install it through the Plugins screen in WordPress.
2. Activate the plugin through the **Plugins** screen.
3. Open **Link Suggestions** in the admin menu and click **Analyze my content**.

== Frequently Asked Questions ==

= How does it decide what to suggest? =

It builds anchor phrases only from your post and page titles, then scores each phrase by how rare it is across your whole site. When a distinctive title phrase appears as plain (un-linked) text inside another post, that is suggested as an internal link to the post the phrase names. Common phrases that appear everywhere (like ingredient lists or storage instructions) and phrases that could match more than one post are ignored, so suggestions stay specific and relevant.

= Will it change my content automatically? =

No. Nothing is changed until you click **Insert** on a specific suggestion. Each insert links the first un-linked occurrence of the phrase in that post.

= Does it touch my existing links? =

No. The plugin never modifies text that is already inside a link or an HTML tag.

= Does it send my content anywhere? =

No. All scanning happens on your own server. Nothing is sent to any external service.

== Screenshots ==

1. The Link Suggestions dashboard, with site stats, average content score, and one-click suggestions.
2. The content score table, ranking posts by internal-linking health.
3. Internal link suggestions in the post editor sidebar.

== Changelog ==

= 1.0.0 =
* Initial release: analyze posts and pages, RAKE-based keyword suggestions, content scoring, site stats, and one-click internal link insertion.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
