Focus Keyword Detector Plugin By KentDevTools (Documentation)

Installation Guide — Focus Keyword Detector Plugin By KentDevTools

Standard Installation

• Upload and Activate: Upload the plugin files to your /wp-content/plugins/ directory or through the WordPress admin dashboard.
• Activation: Activate the plugin through the ‘Plugins’ menu in WordPress.
• Initial Setup: Navigate to Keyword Detector → Settings to configure the plugin for your site.
• Run Bulk Analysis: For existing content, go to Keyword Detector → Bulk Analysis to generate keywords for all your current posts.

Integration with Auto Internal Linker – KentDevTools

If you are using the Auto Internal Linker plugin, follow these specific steps to ensure the two tools work together correctly:

1. Install Focus Keyword Detector first: You must install and configure this plugin before setting up the Auto Internal Linker – KentDevTools.
2. Run Bulk Analysis: Use the Bulk Analysis tool to populate the _fkd_focus_keywords post meta key, which the linker requires to function.
3. Install and activate Auto Internal Linker – KentDevTools: After the keywords are populated, install the Auto Internal Linker plugin.
4. Rebuild Index: In the Auto Internal Linker settings, click Rebuild Keyword Index to sync the data.

Post Meta Information

Data Access: This key is used by other plugins and the REST API to read the focus keywords assigned to each post.

Meta Key: The plugin saves all confirmed keywords under the post meta key _fkd_focus_keywords.

---

How It Works — Focus Keyword Detector Plugin By KentDevTools

Using the Plugin in the Editor

• Classic Editor: The plugin adds a “Focus Keywords” meta box below the main content area where you can manage keywords.
• Gutenberg (Block Editor): A “Focus Keywords” panel is available in the right-hand sidebar of the editor.
• Real-time Detection: Click the “Detect Keywords” button to scan your current content and see a list of suggested terms.
• Confirming Keywords: Click on any suggested keyword tag to add it to your “Confirmed Keywords” list for that specific post.
• Keyword Density: The plugin displays a density percentage for each confirmed keyword, showing how often it appears relative to the total word count.

Detection Methodology

• Frequency Analysis: The system counts the most repeated single words and two-word combinations (bigrams).
• NLP Heuristics: The tool identifies noun phrases, capitalized terms, and “how to” patterns to provide more relevant suggestions.
• Title & Excerpt Scan: Keywords are automatically extracted from the post’s title and excerpt.
• SEO Plugin Sync: If you use Yoast SEO, RankMath, or AIOSEO, the plugin automatically detects and imports focus keywords set within those tools.

Advanced Usage and Integration

Data Storage: Confirmed keywords are stored as a JSON array (e.g., ["seo tips", "focus keyword"]), allowing them to be read by the REST API or other custom PHP scripts.

Keyword Highlighting: A content preview is provided where your confirmed keywords are highlighted in different colors to show their distribution throughout the text.

Auto Internal Linker Integration: This plugin is designed to work with the Auto Internal Linker by saving keyword data into the _fkd_focus_keywords post meta key.

---

Settings Reference

Where to Find Settings

Go to Keyword Detector → Settings in your WordPress admin menu. The settings page contains three sections: Analysis Settings, Keyword Density Settings, and Bulk Analysis Settings. These settings are global and apply to all posts and users on the site, though individual posts can still have custom keywords added manually in the meta box.

Analysis Settings

• Post Types to Analyze: Select which post types (such as posts, pages, or custom post types) will display the Focus Keywords meta box and detection panel. Default: Posts, Pages.
• Max Keyword Suggestions: Sets the number of keyword suggestions shown after clicking “Detect Keywords”. Higher values provide more options but may decrease relevance. Recommended: 10–20. Default: 15.
• Minimum Keyword Length: Words shorter than this character count are ignored to filter out common words like “a” or “the”. Default: 4 chars.
• Custom Stop Words: A list of specific words to ignore during analysis, such as your brand name or niche-specific terms that aren’t useful as keywords. These are added on top of the built-in list of over 200 English stop words. Default: empty.

Keyword Density Settings

• Show Density in Meta Box: When active, a density bar chart appears in the meta box to show the frequency and status of each confirmed keyword. Default: On.
• Highlight Keywords in Editor: When active, a content preview highlights your confirmed keywords in different colors to show their distribution throughout the text. Default: On.

Bulk Analysis Settings

• Bulk Analyze Post Types: Sets the default post types pre-selected in the Bulk Analysis tool. Default: Posts.
• Note: The Bulk Analysis tool automatically saves the top 5 highest-scoring keywords for posts that do not already have confirmed keywords.

Resetting to Defaults

There is no single reset button. To restore original values, you can:

Warning: Deleting the plugin removes all settings and all confirmed keywords saved across your posts (_fkd_focus_keywords post meta) permanently.

Manually change each field back to the default values listed above.

Deactivate and delete the plugin, then reinstall it.

---

FAQ — Focus Keyword Detector

General Questions

• Does this plugin slow down my site? No, the plugin only runs its analysis within the WordPress admin dashboard when you are editing a post or running a bulk analysis. It has no impact on the front-end loading speed for your visitors.
• Which SEO plugins are supported? The detector is fully compatible with Yoast SEO, RankMath, and All in One SEO (AIOSEO). It can automatically detect and pull confirmed focus keywords from these plugins.
• Does it work with the Block Editor (Gutenberg)? Yes, the plugin includes a dedicated sidebar panel for the Block Editor, as well as a meta box for the Classic Editor.

Keyword Detection

• How are keywords detected? The plugin uses a combination of frequency analysis (counting repeated words and bigrams), NLP heuristics (identifying noun phrases and “how to” patterns), and extraction from post titles and excerpts.
• Can I exclude certain words? Yes, you can add “Custom Stop Words” in the plugin settings. These are words that the analyzer will completely ignore. Note that the plugin already filters out over 200 common English words by default.
• Why aren’t my latest changes showing in the analysis? It is recommended to save your post as a draft before clicking “Detect Keywords” or checking density. Unsaved content in the editor may not be fully analyzed.

Bulk Analysis

• What does Bulk Analysis do? This tool allows you to process multiple posts at once. It automatically identifies and saves the top 5 highest-scoring keywords for every post that doesn’t already have confirmed keywords.
• Bulk Analysis stopped partway through? This is usually caused by a PHP execution timeout on your server. To fix this, you can increase your server’s max_execution_time or run the analysis in smaller batches by selecting fewer post types at a time.

Technical Details

• Where are the keywords saved? Confirmed keywords are saved in a JSON array within a post meta key titled _fkd_focus_keywords. This makes the data accessible to other plugins or custom scripts.
• How do I reset everything? There is no reset button. To clear all data, you must deactivate and delete the plugin from the WordPress menu. Be warned that this permanently removes all settings and all saved keywords across your entire site.