LinkBoostr Documentation

Welcome to LinkBoostr! This comprehensive guide will help you master internal linking for your WordPress site using our smart AI-powered suggestions.

LinkBoostr analyzes your content using TF-IDF algorithms to find contextually relevant internal link opportunities, helping you improve SEO and user experience effortlessly.

Installation

Automatic Installation (Recommended)

1. Log in to your WordPress admin panel
2. Navigate to Plugins → Add New
3. Search for LinkBoostr
4. Click Install Now next to LinkBoostr
5. Click Activate after installation completes

Manual Installation

1. Download the plugin from WordPress.org
2. Go to Plugins → Add New → Upload Plugin
3. Choose the downloaded ZIP file
4. Click Install Now
5. Click Activate Plugin

Quick Start Guide

Step 1: Let LinkBoostr Index Your Content

After activation, LinkBoostr automatically indexes your posts using WordPress cron. This happens in the background with zero performance impact.

To check indexing status: Settings → LinkBoostr Settings

Step 2: Open the Block Editor (Gutenberg)

1. Open any post or page in the Block Editor
2. Look for "Link Suggestions" in the right sidebar
3. If you don't see it, click the settings icon (⚙️) in the top-right

Step 3: Get Link Suggestions

LinkBoostr analyzes your content and shows up to 5 relevant internal link suggestions with:

• Target post title and URL
• Suggested anchor text
• Relevance score
• One-click insertion

Step 4: Insert Links

Click any suggestion card to instantly insert the link at your cursor position. That's it!

Link Suggestions

How It Works

LinkBoostr uses TF-IDF (Term Frequency-Inverse Document Frequency) to analyze your content:

1. Extract Keywords - Identifies important terms in your content
2. Calculate Scores - Weights keywords by importance across your site
3. Find Matches - Uses cosine similarity to find related posts
4. Suggest Links - Provides relevant anchor text based on content overlap

Using in Gutenberg

The Link Suggestions panel appears in the right sidebar of the Block Editor:

• Shows 5 most relevant posts
• Color-coded relevance scores (green = high, yellow = medium)
• Alternative anchor text options
• Click to insert instantly

Using in Classic Editor

A meta box appears below the editor with the same suggestions. Click any anchor text to insert the link.

Suggestion Quality

Suggestions are ranked by relevance score (0-100%):

Orphan Page Detector

What Are Orphan Pages?

Orphan pages are posts or pages with zero internal links pointing to them. They're hard for users to discover and search engines to crawl effectively.

Finding Orphan Pages

1. Go to Tools → LinkBoostr Orphans
2. View all posts with zero inbound links
3. See suggestions for which posts should link to them
4. Click "View Post" to add links manually

How to Fix Orphan Pages

1. Review the suggested "linking opportunities"
2. Open suggested posts in the editor
3. Add relevant internal links to the orphan page
4. The orphan will disappear from the list once linked

Broken Link Checker

Automatic Detection

LinkBoostr automatically scans your internal links and detects:

• Links to deleted posts
• Links to draft/private posts
• Malformed internal URLs
• 404 errors

Viewing Broken Links

1. Go to Tools → LinkBoostr Broken Links
2. See all broken internal links across your site
3. View which post contains the broken link
4. Click "Edit Post" to fix

Fixing Broken Links

1. Click "Edit Post" next to the broken link
2. Find and remove or replace the broken link
3. Save the post
4. LinkBoostr will re-scan automatically

Link Density Warnings

What Is Link Density?

Link density is the ratio of linked text to total text on a page. Optimal link density improves SEO and user experience.

Recommended Ranges

• Optimal: 1-3% link density
• Acceptable: 0.5-5% link density
• Too High: Above 5% (appears spammy)
• Too Low: Below 0.5% (missing opportunities)

Real-Time Warnings

When editing posts, LinkBoostr shows warnings if your link density is:

• 🔴 Too High - Remove some links
• 🟡 Too Low - Consider adding more internal links
• 🟢 Optimal - Good job!

Dashboard Widget

Quick Stats Overview

The LinkBoostr dashboard widget shows:

• Total posts indexed
• Number of orphan pages
• Broken internal links count
• Indexing status
• Quick action buttons

Quick Actions

• Fix Orphans - Jump to orphan detector
• Fix Broken Links - View all broken links
• Reindex - Manually trigger reindexing
• View Settings - Access plugin settings

General Settings

Access settings at: Settings → LinkBoostr Settings

Max Suggestions

Set the maximum number of link suggestions to display (1-10). Default: 5

Recommendation: Keep at 5 for best balance between choice and simplicity.

Cache Duration

Suggestions are cached to improve performance. Default: 1 hour

Cache is automatically cleared when you publish or update posts.

Performance Settings

• Background Indexing: Always enabled, uses WP-Cron
• Batch Size: Indexes 10 posts per batch
• Frequency: Runs every 5 minutes

Indexing

How Indexing Works

LinkBoostr builds an index of your content in the background:

1. Extracts text from post content
2. Calculates TF-IDF scores for keywords
3. Stores in a custom database table
4. Updates automatically when posts are published/updated

Manual Reindexing

To manually reindex all posts:

1. Go to Settings → LinkBoostr Settings
2. Click "Reindex All Posts"
3. Wait for the background process to complete
4. Check the status in the dashboard widget

Indexing Status

Check indexing progress:

• Dashboard Widget: Shows total indexed posts
• Settings Page: Detailed indexing status
• Console: Enable WP_DEBUG to see indexing logs

Post Types

Excluding Post Types

To exclude certain post types from indexing:

1. Go to Settings → LinkBoostr Settings
2. Find "Excluded Post Types" section
3. Check the boxes for post types to exclude
4. Save settings
5. Reindex if needed

Supported Post Types

LinkBoostr works with:

• Posts (default)
• Pages (default)
• Custom post types (public ones)

Frequently Asked Questions

Why aren't I seeing suggestions?

Possible reasons:

• Indexing is still in progress (check dashboard widget)
• You don't have enough published posts (minimum 3-5 recommended)
• Your content is too unique (no semantic matches found)
• Post type is excluded in settings

Will this slow down my site?

No. LinkBoostr is optimized for performance:

• Indexing happens in background via WP-Cron
• Suggestions are cached for 1 hour
• Database queries are optimized
• Average request time: <500ms

Can I use this with page builders?

LinkBoostr works best with Gutenberg and Classic Editor. Basic compatibility with Elementor and other builders is included, but may require manual link insertion.

Does it work on multisite?

Yes! LinkBoostr is fully multisite compatible with per-site indexing and settings.

How do I uninstall?

1. Deactivate the plugin
2. Delete the plugin
3. The custom database table will be removed automatically
4. All settings and cached data will be deleted

Troubleshooting

Suggestions Not Appearing

Solution 1: Clear cache and reindex

1. Settings → LinkBoostr Settings
2. Click "Reindex All Posts"
3. Wait 5-10 minutes
4. Refresh your editor

Solution 2: Check browser console for errors

1. Press F12 to open Developer Tools
2. Go to Console tab
3. Look for JavaScript errors
4. Report to support if found

Indexing Stuck

If indexing appears stuck:

1. Verify WP-Cron is working: wp cron event list
2. Check for PHP errors in debug log
3. Increase PHP memory limit (min 128MB recommended)
4. Disable other plugins temporarily to test for conflicts

Enable Debug Mode

To enable debugging, add to wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);

Database Issues

To recreate the database table:

1. Deactivate LinkBoostr
2. Reactivate LinkBoostr
3. Table will be recreated automatically
4. Trigger manual reindex

Get Support

Need Help?

We're here to help! Choose your preferred support channel:

WordPress.org Support Forum

Free community support for all users:

GitHub Issues

Report bugs or request features:

Documentation

Explore more resources:

• FAQ on WordPress.org
• View Source Code
• Visit Digitalastic