Internal Post Linker - Link Internal Posts, Pages, Products without leaving the page

Internal Post Linker helps editors create internal links while writing. Select text in the editor, open the internal link search, choose an existing site result, and the plugin applies the selected result's permalink to the selected text. The plugin supports the WordPress block editor and the Classic Editor/TinyMCE visual editor. Search results include useful context before insertion, including title, post type, publication date, excerpt, privacy status, current-post label, and a preview link. Key Features

• Link selected text to posts, pages, and public custom post types.
• Scan the current article for internal link suggestions.
• Works in the block editor and Classic Editor/TinyMCE visual editor.
• Searches linkable content by title and slug.
• Shows result title, post type, date, excerpt, private status, and current-post label.
• Adds WordPress editor link metadata so newly inserted block editor links display correctly.
• Uses nonce-protected admin-ajax requests for editor search.
• Includes a REST search endpoint for editor integrations.
• Supports older block editor builds that expose toolbar APIs through wp.editor.
• Excludes attachments from link targets.
• Works without a build step.

Using It In The Block Editor

1. Open a post, page, or supported custom post type in the WordPress block editor.
2. Click inside a text block, such as a Paragraph, Heading, List, or other rich text block.
3. Highlight the text you want to link.
4. Click the Internal Post Link toolbar button.
5. In the modal, search for the page, post, or article you want to link.
6. Review the search results.
7. Click the result you want.
8. The selected text is linked immediately.
9. Save, update, or publish the post as usual.

Suggest Internal Links The Suggest internal links feature helps editors find internal linking opportunities before publishing. Instead of manually searching for every possible link, editors can scan the current article and review a list of suggested keywords that match existing internal content. This feature is not AI generated. It uses deterministic matching against existing site content, including:

• Post titles.
• Page titles.
• Product titles when products are available as a public post type.
• Public custom post type titles.
• URL slugs converted into readable phrases.
• Strong one-word, two-word, three-word, and longer title phrases, excluding common filler words.

The scanner ignores text that is already linked, so it focuses on unlinked opportunities in the current article. How To Use Suggestions In The Block Editor

1. Open a post, page, or supported custom post type in the WordPress block editor.
2. Write or edit the article content.
3. Click the Suggest internal links icon near the editor publish controls.
4. Review the suggested keywords and target articles.
5. Use the suggestion search field to filter the list by keyword, target title, content type, or excerpt.
6. Click Apply to link one suggestion.
7. Click Apply all to apply all available non-current-article suggestions in the current filtered list.
8. Save, update, or publish the post as usual.

How To Use Suggestions In Classic Editor

1. Open a post or page in Classic Editor.
2. Make sure you are using the Visual editor tab.
3. Write or edit the article content.
4. In the publish box, click Suggest internal links.
5. Review the suggested keywords and target articles.
6. Use the suggestion search field to filter the list by keyword, target title, content type, or excerpt.
7. Click Apply to link one suggestion.
8. Click Apply all to apply all available non-current-article suggestions in the current filtered list.
9. Save, update, or publish the post as usual.

Suggestion Details Each suggestion can include:

• The suggested target title.
• The matched keyword or phrase.
• The target content type, such as Post, Page, Product, or another public custom post type.
• The number of times the keyword appears in the current article.
• A short excerpt from the suggested target.
• Highlighted keyword matches in the title, metadata, and excerpt.
• A quality rating: Normal, Good, Best, or Ideal.

Suggestion ratings are calculated without AI. Ratings are based on match strength signals such as keyword occurrence count, keyword length, and whether the keyword appears in the suggested target title, slug, or excerpt. Higher-rated suggestions are shown first. Ratings also check the suggested target article body content on the server. If the keyword appears in the target article content, the suggestion receives an additional relevance boost. The target article body is not returned to the browser; only the suggestion metadata and match count are shown. Applying Suggestions Clicking Apply links the first available unlinked occurrence of the suggested keyword in the current article. Clicking Apply all applies all available suggestions in the current filtered list, skipping current-article suggestions. After a successful bulk apply, the suggestion modal closes automatically. Current-article suggestions are highlighted so editors can identify possible self-links. They are not applied by Apply all, because linking an article to itself is usually not useful. Using It In Classic Editor

1. Open a post or page in Classic Editor.
2. Make sure you are using the Visual editor tab.
3. Highlight the text you want to link.
4. Click the Internal Link button in the editor toolbar.
5. Search for the internal content you want to link.
6. Click a result.
7. The selected text is linked immediately.
8. Save, update, or publish the post as usual.

Search Results Each result can show:

• Title.
• Content type, such as Post, Page, or a custom post type label.
• Published date.
• Excerpt.
• Private status, when applicable.
• Current post label, when the matching result is the post currently being edited.
• A preview link where available.

The plugin searches titles and slugs. For best results, search using words from the target content title. Examples:

• Product Name
• Gravity Forms
• Documentation
• REST API

Linking To The Current Post The current post may appear in search results if it matches the search term. It is labeled Current post so editors can identify it before linking. In most editorial workflows, linking a post to itself is not useful. If you see the Current post label, choose a different result unless you intentionally want a self-link. Updating An Existing Link In the block editor:

1. Click or select the already linked text.
2. Open Internal Post Link.
3. Search for the replacement content.
4. Click the new result.

The existing link is replaced with the selected internal link. In Classic Editor:

1. Select the linked text.
2. Click Internal Link.
3. Search and choose the replacement result.

Removing A Link The plugin focuses on finding and applying internal links. To remove a link, use the editor's standard unlink control:

• In the block editor, click the linked text and use the unlink option in the link popover or toolbar.
• In Classic Editor, select the linked text and click the standard unlink toolbar button.

Search Security Search requests are protected with WordPress permissions and nonces. The plugin only returns search results for logged-in users who can edit posts. The plugin does not expose internal search to public site visitors. Supported Content Types The plugin searches public post types that have an editor UI, including:

• Posts.
• Pages.
• Public custom post types.
• Knowledge base articles, documentation articles, or other public editor-backed content types when registered by your site.

Attachments are excluded from search results.

1.0.3

• Refactor: Split content search, keyword matching, stopword data, and internal link suggestion scoring into focused include files while keeping the main plugin loader lightweight.
• Refactor: Moved the main plugin class into includes/class-skyinpo-internal-post-linker.php and reduced the main plugin file to a lightweight bootstrap.
• Fix: Tightened internal link suggestion phrase generation to reject generic filler phrases, auxiliary verbs, common stopword combinations, generic single words, and low-value two-word phrases.
• Fix: Phrase generation now still checks internal one-word, two-word, three-word, and longer title or slug candidates even when the full title starts or ends with a generic stopword.
• Improvement: Expanded suggestion phrase generation to consider one-word, two-word, three-word, and longer title or slug keyword candidates when they pass the link-worthy filter.
• Improvement: Suggestion ratings now include server-side keyword matches from the target article body content.
• Improvement: Suggestion metadata shows how many times the keyword appears in the target article content without returning the full content to the browser.

1.0.2

• Feature: Added internal link suggestions that scan the current article for unlinked phrases matching existing internal content titles, slugs, and strong multi-word phrase candidates.
• Feature: Added deterministic suggestion quality ratings: Normal, Good, Best, and Ideal, based on keyword frequency, keyword length, and matches within the target title, slug, and excerpt.
• Feature: Added keyword highlighting in suggestion titles, matched phrases, and excerpts.
• Feature: Added a suggestion search field for filtering results by keyword, title, content type, or excerpt.
• Feature: Added an Apply all action that applies available non-current-article suggestions with unlinked keyword matches and respects the currently filtered suggestion list.
• Feature: Added internal link suggestion controls to the block editor header toolbar, rich text toolbar, Classic Editor publish box, and TinyMCE toolbar.
• Improvement: Current-article suggestions are included and highlighted to identify self-link opportunities while remaining excluded from bulk application.
• Improvement: Individual suggestions can be reviewed and applied to the first available unlinked keyword occurrence.
• Improvement: Moved the suggestion search field inline with the Apply all and Scan again actions.
• Improvement: Apply all now closes the suggestion modal after successfully applying available links.
• Improvement: Improved block editor compatibility with a fallback suggestion button near the Save and More controls when the standard header toolbar slot is unavailable.
• Improvement: Repositioned editor suggestion controls for easier access near the publish and standard link controls.

1.0.0

• Initial production release.
• Added block editor and Classic Editor internal post linking.
• Added secure internal content search and contextual result previews.
• Added compatibility fixes for older editor APIs and WordPress link metadata.
• Added Plugin Check-friendly search and translation handling.