=== Core Plus Links ===
Contributors: corelocalseo
Tags: internal links, seo, suggestions, gutenberg
Requires at least: 6.6
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Privacy-first, deterministic-by-default internal linking for WordPress. Suggests relevant links from your own content in the block editor.

== Description ==

Core Plus Links is an internal linking assistant for WordPress. Open a post or page in the block editor, and the Core Plus Links sidebar suggests related pages from your site so you can insert links without leaving the editor.

It is deterministic by default: suggestions come from a local content index and rule-based ranking (titles, taxonomies, headings, and link-graph signals). The plugin does not call external AI services and does not send your content off-site.

Includes:

* Indexing for posts and pages
* Deterministic suggested links in the Gutenberg sidebar, with editable anchors, one-click insert, and dismiss
* Inbound and outbound link listings for the current post in the editor sidebar
* A context bank for taxonomies and exclusions (specific posts/pages and categories/tags)
* Suggested exclusions for utility pages — proposed for your review, never applied automatically
* Basic reports (orphans, underlinked pages, and related summaries) with sortable columns

== Installation ==

1. In your WordPress admin, go to Plugins -> Add New, search for "Core Plus Links", and click Install Now.
2. Activate Core Plus Links.
3. After activation, Core Plus Links queues a full-site index job. A setup notice appears ("Core Plus Links is building your content index..."). When indexing finishes, you will see "Core Plus Links finished building your content index."
4. Open a post or page in the block editor and use the Core Plus Links sidebar.

On low-traffic sites, background jobs wait on WP-Cron. You can process the queue with WP-CLI: `wp core-plus-links run-queue`.

== Frequently Asked Questions ==

= Does Core Plus Links send my content anywhere? =

No. It runs entirely on your WordPress site. Indexing, ranking, and suggestions use your local database. Nothing is sent to an external AI or analytics service.

= Do I need an API key? =

No. Deterministic suggestions work without an API key, license, or external account.

= What does "deterministic" mean? =

Suggestions are produced by fixed, rule-based scoring over your indexed content, not by a generative model. The same content and settings produce the same ranked results.

= Why do some suggestions say "Weak match"? =

"Weak match" means the candidate only partially overlaps the current post (for example limited title or taxonomy overlap). Review those suggestions carefully before inserting. Stronger overlaps are labeled accordingly.

= Does it work in the classic editor? =

Not yet. v1 supports the Gutenberg block editor only. Classic editor support is planned for a later release.

= Does Core Plus Links work on multisite? =

Yes, activated on individual sites. Network activation is not supported yet.

= How do I finish indexing on a low-traffic site? =

Jobs run on WP-Cron. On quiet sites, process due jobs with:

`wp core-plus-links run-queue`

Optional status check:

`wp core-plus-links queue-status`

== Screenshots ==

1. Core Plus Links sidebar in the block editor with suggested links and match strength.
2. Compact status strip and inbound/outbound link counts for the current post.
3. Admin dashboard with index health and reindex controls.
4. Context bank settings for taxonomies and exclusions.
5. Reports overview for orphan and underlinked pages.
6. Settings for exclusions, retention, and scheduled reindex.

== Changelog ==

= 1.0.0 =
* First public release of Core Plus Links.
* Deterministic indexing for posts and pages; Gutenberg sidebar suggestions with editable anchors, insert, and dismiss.
* Inbound and outbound links for the current post in the editor sidebar.
* Context bank for taxonomies and exclusions; suggested utility-page exclusions for review (never auto-applied).
* Basic reports (orphans, underlinked pages) with sortable columns; background job queue and WP-CLI helpers (`wp core-plus-links run-queue`).

== Development ==

Source code, including the unminified JavaScript used to build the editor and admin bundles, is available at https://github.com/corelocalseo/core-plus-links.

== Upgrade Notice ==

= 1.0.0 =
First public release of Core Plus Links.
