=== Supan Content – Internal Links, Orphan Pages & Link Graph ===
Contributors: gandatechservices, ashishgurprit
Tags: internal links, seo, orphan pages, content clusters, duplicate content
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 1.1.1
License: GPL-2.0+
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find orphan pages, fix internal linking, and unlock rankings hiding in content you already have — with an AI-powered internal link graph.

== Description ==

Orphan pages don't rank. Poorly-linked content doesn't rank. But most WordPress sites have hundreds of posts that are one internal link away from a traffic boost — and no way to find them.

**Supan Content** analyses your entire WordPress site to build a visual internal link graph, surface orphan pages instantly, suggest high-value linking opportunities using AI-powered semantic matching, and detect topic clusters — all without leaving wp-admin.

Stop publishing new content. Start unlocking the traffic in what you already have.

= Key Features =

* **Internal link graph** — see exactly which pages link to which, with orphan pages flagged at a glance
* **Orphan page detection** — instantly find pages with zero inbound internal links dragging down your authority
* **AI-powered link suggestions** — semantic engine matches your posts by topic and recommends the highest-impact linking opportunities
* **Topic cluster mapping** — group your content by semantic category to build true topical authority
* **Near-duplicate content finder** — configurable similarity threshold to catch keyword cannibalisation before it costs you rankings
* **One-click graph build** — analyses up to 200 published posts and pages automatically
* **Copy-to-paste anchor HTML** — insert suggested links without writing a single line of code

*About the name: "Supan" (スパン) is a Japanese loanword meaning "span" — the arc or spectrum of connections. It reflects what this plugin does: mapping the full span of internal links across your site.*

= External Services =

This plugin sends post content (title, body text, URLs) to the **GTS SEO API** (hosted on Google Cloud Run) to perform link analysis, clustering, and duplicate detection.

* **Service URL:** https://gts-seo-engine-e467edaxoq-ts.a.run.app
* **Terms of Service:** https://spectra.cchk.info/terms
* **Privacy Policy:** https://spectra.cchk.info/privacy

Data sent: published post titles, content body, and canonical URLs. No user data or PII is transmitted.

= Source Code =

The full React/TypeScript source for the compiled JavaScript assets is included directly in this plugin under the `src/` directory. Build tooling configuration is in `vite.config.ts` and `vite.gutenberg.config.ts`.

To regenerate the compiled assets from source:

1. Install Node.js and pnpm
2. Run `pnpm install` in the plugin root
3. Run `pnpm build` to produce `build/supaco-content.js` and `build/supaco-content-gutenberg.js`

== Installation ==

1. Upload the `supan-content` folder to `/wp-content/plugins/`
2. Activate through **Plugins → Installed Plugins**
3. Navigate to **Supan Content** in the left menu
4. Enter your **API Key** from [spectra.cchk.info](https://spectra.cchk.info/supan-content)
5. Click **Build Graph** to scan your site and build your first link graph

== Frequently Asked Questions ==

= How many posts can it analyse at once? =

Up to 200 published posts and pages per analysis run.

= What data is sent to the API? =

Published post titles, content body text, and canonical URLs. No user data and no personally identifiable information.

= Does it work with custom post types? =

Currently standard `post` and `page` types are analysed. Custom post type support is on the roadmap.

= Will it slow down my site? =

No. Analysis runs only when you trigger it in wp-admin. There are no frontend scripts and zero visitor-facing performance impact.

== Screenshots ==

1. Internal Link Graph — total pages, orphan pages, and linked pages shown as stat cards above a sortable table of every post with outgoing/incoming link counts and orphan status.
2. AI Link Suggestions — pick any post and get relevance-scored linking opportunities with shared tags and topic similarity.
3. Topic Clusters — automatic detection of content groups by topic, with every post slug grouped into the cluster it belongs to.
4. Duplicate Content — near-duplicate post pairs surfaced with a configurable similarity threshold and a side-by-side slug comparison.
5. Settings panel — set the API URL and key. Updates take effect immediately.

== Changelog ==

= 1.1.1 =
* Refreshed the plugin title and listing copy for clarity and discoverability. Documentation only — no functional changes.

= 1.1.0 =
* Gutenberg block editor sidebar with AI-powered semantic link suggestions
* Copy-to-paste anchor HTML for one-click link insertion
* Renamed to Supan Content; updated plugin and author URLs

= 1.0.0 =
* Initial public release
* Internal link graph with orphan detection
* AI-powered link suggestions
* Topic cluster detection
* Near-duplicate content finder

== Upgrade Notice ==

= 1.1.1 =
Listing update only — improved title and description for discoverability. No functional changes.

= 1.1.0 =
Adds a Gutenberg sidebar with AI-powered link suggestions directly in the block editor. Recommended for all users.