Category Commander helps you organize WordPress categories, tags, and public custom taxonomies with drag-and-drop ordering, category click insights, history restore, diagnostics, shortcodes, REST API support, CSV export\/import, and optional AI-powered suggestions.<\/p>\n\n
Unlike simple category ordering plugins, Category Commander focuses on helping administrators review and improve taxonomy structure. It can detect empty or low-content terms, missing descriptions, long names, similar names, and large terms that may deserve a closer review.<\/p>\n\n
AI features are optional. OpenAI API requests happen only when the site administrator explicitly enables AI features and runs an AI suggestion request from the admin screen. Administrators can also use a manual ChatGPT browser workflow by copying a prompt themselves. AI suggestions are never applied automatically. Administrators must review the result and choose yes before anything changes.<\/p>\n\n
[category_commander_list]<\/code><\/li>\n- Developer helpers:
category_commander_get_terms()<\/code> and category_commander_terms_list()<\/code><\/li>\n- CSV export and import<\/li>\n
- JSON export and import for backward compatibility<\/li>\n
- Optional OpenAI-powered order suggestions<\/li>\n
- Optional AI parent-child structure suggestions<\/li>\n
- Optional AI category name suggestions that review every selected target term<\/li>\n
- Separate AI tasks for simpler, more reliable results<\/li>\n
- AI suggestion target control for parent categories, child categories, or both<\/li>\n
- Editable AI prompts with variables and one-click reset to defaults<\/li>\n
- Manual ChatGPT browser workflow for administrators who do not use the OpenAI API<\/li>\n
- Simple yes\/no approval before applying AI suggestions<\/li>\n<\/ul>\n\n
Privacy and External Services<\/h3>\n\n
This plugin can optionally connect to the OpenAI API when AI features are enabled by the site administrator.<\/p>\n\n
When the administrator explicitly runs an AI suggestion request, the previewed data may be sent to the OpenAI API: site name, tagline, locale, selected taxonomy, selected saved order, term IDs, category\/tag names, parent IDs, post counts, current positions, the administrator prompt, and optional post title context when that setting is enabled.<\/p>\n\n
Category Commander does not send post excerpts, post content, visitor data, comments, orders, users, passwords, or the OpenAI API key as prompt content. Post title context is sent only when the administrator enables that option.<\/p>\n\n
No data is sent to OpenAI automatically. No front-end visitor action sends data to OpenAI. AI suggestions are not applied automatically. The administrator must review the returned suggestion and choose yes before changes are applied.<\/p>\n\n
The OpenAI API key is provided by the site administrator. It is stored in WordPress options with autoload disabled, masked in the admin UI, and can alternatively be provided with the CATEGORY_COMMANDER_OPENAI_API_KEY<\/code> constant in wp-config.php<\/code>.<\/p>\n\nAdministrators can delete the API key stored by Category Commander from AI Settings. Deleting the stored key also disables AI features until a new key is configured. If the key is defined in wp-config.php<\/code>, remove the constant there.<\/p>\n\nCategory Commander also includes a manual ChatGPT browser workflow. In this mode, the plugin creates a copyable prompt and can import the returned JSON result for review. Category Commander does not send the manual prompt anywhere. If the administrator copies that prompt into ChatGPT or another service, the administrator is choosing to share the included site name, tagline, taxonomy data, administrator instructions, and optional post title context with that service.<\/p>\n\n
Category Click Insights is optional and disabled until an administrator enables it. When enabled, it uses front-end JavaScript to count category link impressions and clicks from links inside your own site. Direct category archive visits from search engines, address bar visits, and bookmarks are not counted as category clicks. The data is stored locally as daily aggregate counts by category and display context. It does not store IP addresses, user IDs, or per-visitor browsing histories.<\/p>\n\n
External service used:\n* OpenAI API: https:\/\/api.openai.com\/v1\/responses\n* OpenAI Services Agreement: https:\/\/openai.com\/policies\/services-agreement\/\n* OpenAI Privacy Policy: https:\/\/openai.com\/policies\/privacy-policy\/<\/p>\n\n
How to Use<\/h3>\n\nReorder categories, tags, or taxonomies<\/h4>\n\n\n- Go to Posts -> Category Commander.<\/li>\n
- Open the Settings tab and enable the taxonomies you want to manage.<\/li>\n
- Open the Order tab.<\/li>\n
- Choose a taxonomy and saved order if needed.<\/li>\n
- Drag terms into the order you want.<\/li>\n
- Click Save Order.<\/li>\n<\/ol>\n\n
A restore point is created before the new order is saved.<\/p>\n\n
When a parent category has child categories, you can expand or collapse the child list to focus on parent categories while arranging the order.<\/p>\n\n
Front-end category widgets and blocks<\/h4>\n\n
WordPress category widgets and category blocks normally hide empty child categories. Category Commander includes a Settings option to show empty child categories when a category widget or block uses hierarchical display, so site owners can see the parent-child structure before posts are assigned.<\/p>\n\n
Use saved order presets<\/h4>\n\n
Presets let you keep different saved orders, such as one order for the normal site display and another order for a shortcode or custom theme area.<\/p>\n\n
The default presets are:\n* Default\n* Menu\n* Sidebar\n* Mobile\n* Footer<\/p>\n\n
The Default preset is used by normal WordPress category widgets and category blocks when front-end autosort is enabled. Other presets do not automatically detect a theme's menu, sidebar, mobile, or footer area because themes do not expose those locations in a standard way. Use other presets with the shortcode, the PHP helper functions, or the category_commander_auto_order_preset<\/code> filter in custom code.<\/p>\n\nReview taxonomy health<\/h4>\n\n
Open the Diagnostics tab to see non-AI improvement hints. Diagnostics can help identify empty terms, terms with very few posts, missing descriptions, long term names, similar labels, and large terms that may deserve subcategories.<\/p>\n\n
Diagnostics do not change anything automatically.<\/p>\n\n
Review category click performance<\/h4>\n\n
Open the Insights tab to review local aggregate impressions, clicks, and click-through rate for category links.<\/p>\n\n
Insights is designed for category naming decisions. If a category link is shown often but clicked rarely, the category name or placement may need review.<\/p>\n\n
The feature is disabled by default. You can enable it, choose tracked taxonomies, set data retention, exclude logged-in users, delete all stored insights data, and optionally allow AI suggestions to include 30-day aggregate click metrics as category context.<\/p>\n\n
Restore a previous order<\/h4>\n\n
Open the History tab to review recent changes. Click Restore next to a history item to recover the previous order.<\/p>\n\n
History is saved before manual saves, resets, imports, and applied AI changes.<\/p>\n\n
Import and export<\/h4>\n\n
Open Import \/ Export to download a CSV backup or import CSV order data. CSV import matches existing terms by taxonomy and slug and skips missing terms for safety.<\/p>\n\n
JSON export and import are also available for compatibility with earlier Category Commander versions.<\/p>\n\n
Optional AI suggestions<\/h4>\n\n
AI features are disabled by default.<\/p>\n\n
To use AI suggestions:\n1. Open AI Settings.\n2. Enable AI features.\n3. Add an OpenAI API key or define CATEGORY_COMMANDER_OPENAI_API_KEY<\/code> in wp-config.php<\/code>.\n4. Review or edit the default prompts if needed.\n5. Open AI Suggestions.\n6. Choose one task: order suggestion, parent-child structure and order suggestion, or category name suggestion.\n7. Choose the suggestion target: parent and child categories, parent categories only, or child categories only.\n8. Review the data preview.\n9. Click Generate with OpenAI API.\n10. Review the returned suggestion.\n11. Choose yes to apply the suggestion, or no to leave categories unchanged.<\/p>\n\nAI suggestions are never applied automatically.<\/p>\n\n
Order-only AI suggestions change display order only. Parent-child structure suggestions are optional and should be used only when the administrator wants AI to propose moving categories under parent categories.<\/p>\n\n
To stop using AI features, open AI Settings and use Delete stored OpenAI API key. This removes the key saved in the WordPress database and disables AI features.<\/p>\n\n
For category name suggestions, Category Commander processes selected terms in batches. It normally sends a reasonably sized group together, then automatically splits only the group that fails so large sites can finish without repeating unnecessary requests. The AI tasks are intentionally separated so each response stays small and predictable.<\/p>\n\n
For lower cost and faster category name suggestions, administrators can turn off reason text. When reasons are disabled, the result focuses on the current name and suggested name.<\/p>\n\n
Manual ChatGPT browser workflow<\/h4>\n\n
Administrators who do not use the OpenAI API can still use AI-assisted review manually:\n1. Open AI Suggestions.\n2. Choose the suggestion type and target.\n3. Enter an analysis goal if needed.\n4. Click Create ChatGPT browser prompt.\n5. Copy the prompt and paste it into ChatGPT in a browser.\n6. Ask ChatGPT to create the JSON file requested by the prompt.\n7. Drop or paste the returned JSON result into Category Commander.\n8. Review the result and choose yes to apply it, or no to leave categories unchanged.<\/p>\n\n
This manual workflow uses the same preview and safety checks as OpenAI API suggestions. The plugin validates term IDs and parent-child structure before showing the approval screen.<\/p>\n\n
Find help inside WordPress<\/h4>\n\n
The Category Commander admin screen includes WordPress contextual help. Click the Help tab at the top right of the admin screen for a quick guide to each tab, AI privacy notes, and shortcode examples.<\/p>\n\n
Common WordPress words used by this plugin<\/h4>\n\n
Taxonomy means a WordPress grouping system, such as Categories, Tags, or a custom grouping added by another plugin.<\/p>\n\n
Term means one item inside a taxonomy, such as a single category name or tag name.<\/p>\n\n
Preset means a saved order slot. Default is used by normal WordPress category widgets and blocks. Other presets are for shortcodes, helper functions, or custom theme\/plugin code.<\/p>\n\n
Slug means the URL-friendly name WordPress uses in links.<\/p>\n\n
Front end means the public-facing part of your website that visitors see.<\/p>\n\n
REST API is a developer endpoint that themes, blocks, or apps can use to read ordered term data.<\/p>\n\n
CSV is a spreadsheet-friendly file format for backups and review. JSON is a structured data format mainly kept for compatibility with earlier Category Commander exports.<\/p>\n\n
Shortcode means a small bracketed code you can place in content to display an ordered term list.<\/p>\n\n\n
\n- Upload the plugin folder to the
\/wp-content\/plugins\/<\/code> directory.<\/li>\n- Activate the plugin through the Plugins menu in WordPress.<\/li>\n
- Go to Posts -> Category Commander.<\/li>\n
- Enable the taxonomies you want to manage in Category Commander -> Settings.<\/li>\n<\/ol>\n\n\n
\nDoes the plugin modify WordPress core tables?<\/h3><\/dt>\nNo. Category Commander stores custom order values as term meta.<\/p><\/dd>\n