=== TagGator ===
Contributors: angrybyte
Tags: tags, tag, automatic, seo, tagger
Requires at least: 5.9
Tested up to: 6.9
Stable tag: 3.1.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Bulk-tag your posts by matching keywords against content. Simple, fast, and free.
== Description ==
TagGator lets you build a keyword list and apply matching tags to all your posts in one click.
**How it works:**
1. Enter your tag words in the Tag List — one per line, or comma-separated. Each word is both the tag name *and* the keyword searched for.
2. Configure matching options (case-sensitive, whole words, minimum occurrences).
3. Click **Preview** to see what would be tagged, or **Bulk Tag All Posts** to apply tags immediately.
4. Use **Remove Unmatched Tags** to clean up stale tags if you update your list.
**Example tag list:**
`JavaScript, PHP, Python`
`WordPress, Gutenberg`
`Node.js, React, Vue`
A post containing "JavaScript" receives the "JavaScript" tag. Tags are only applied when the minimum match count is met, so you stay in control.
**Features:**
* Flat tag list — every word is both tag and keyword, no complex syntax
* Case-sensitive or case-insensitive matching
* Whole-word or substring matching
* Minimum match count in body and/or title
* Enable/disable tagging per post type
* Choose which taxonomy to tag with per post type
* Preview before committing — no surprises
* Remove Unmatched Tags cleans up only plugin-applied tags, never manually added ones
* Tagging history in the post editor sidebar
* No external dependencies, no tracking, no telemetry
**Looking for more?**
[TagGator Pro] adds:
* Auto-tag posts on save — no manual bulk runs needed
* Keyword-to-tag synonym mapping (one tag, many keywords per line)
* Exclude posts by ID, category, or author
* Per-post and per-user exclusion controls
* Priority support
== Installation ==
1. Upload the `taggator` folder to the `/wp-content/plugins/` directory, or install directly from the WordPress plugin directory.
2. Activate the plugin through the **Plugins** menu.
3. Go to **Settings → TagGator** to configure your tag list and matching options.
4. Click **Bulk Tag All Posts** to apply tags to your existing content.
== Frequently Asked Questions ==
= What is the tag list format? =
Each word or phrase in the list is both the tag name and the keyword searched for in post content. Separate entries with commas or newlines — both work.
Example: `JavaScript, PHP\nPython` creates three tags and searches for each of them by name.
= Does TagGator apply tags automatically when I publish a post? =
No. TagGator (free) applies tags only via the **Bulk Tag All Posts** button. For automatic tagging on save, upgrade to TagGator Pro.
= Will Remove Unmatched Tags delete my manually added tags? =
No. TagGator tracks which tags it applies internally. The cleanup operation only removes tags that TagGator itself previously applied and that no longer match your current list.
= Can I tag custom post types? =
Yes. In the Post Type Settings section you can enable tagging for any public post type and choose which taxonomy to use.
== Changelog ==
= 3.1.0 =
* Security fixes.
* tested support up to Wordpress 6.9.
* added custom post type support.