=== Advanced Taxonomy Manager ===
Authors: gbti
Contributors: gbti, Hudson Atwell
Donate link: https://github.com/sponsors/gbti-network
Tags: taxonomy, taxonomies, categories, tags, terms
Requires at least: 5.8
Tested up to: 6.8.2
Requires PHP: 7.4
Stable tag: 2.1.1
License: GPL-3.0-or-later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

A free WordPress plugin for advanced management of all your taxonomies — categories, tags, and custom taxonomies.

== Description ==

Advanced Taxonomy Manager provides an enhanced interface for managing every WordPress taxonomy from one place. Organize categories, tags, and any custom taxonomy with an intuitive, drag-and-drop hierarchy editor that goes well beyond the standard WordPress term screens.

Switch between four ways of viewing your terms — a dense Compact List, cascading Columns, spacious Cards, or a Tree diagram — and reorganize them by drag and drop, including reordering and re-nesting with a live "where will this land" hint.

It is completely free and works with all of your public taxonomies.

= Key Features =

* **All Taxonomies** - Manage categories, tags, and any custom taxonomy from a single editor
* **Four Term Views** - Switch between Compact List, Columns (Miller), Cards, and Tree layouts, and set your preferred default
* **Drag to Reorder & Re-nest** - Drag a term to reorder it among its siblings or drag sideways to nest it under another term (or outdent it), with a live placement note showing exactly where it will land
* **Bulk Actions** - Multi-select terms to Move them under a new parent, Merge several terms into one, or Delete in bulk
* **Manual Ordering** - Set a custom term order in the editor and optionally apply that order across the front end of your site
* **Search Everywhere** - Filter and find terms instantly in every view
* **AI-Powered Descriptions** - Optionally generate term descriptions with your own OpenAI API key, and choose which model to use
* **Term Insights** - View a term's public archive and see the posts assigned to it in a paginated popup
* **Import/Export** - Transfer term structures between sites with JSON import/export
* **Native Categories Integration** - The Posts > Categories menu opens directly into the manager, with a link back to the classic WordPress screen any time

== Installation ==

1. Upload the `better-category-manager` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Manage your taxonomies from the new "Taxonomies" menu, or from Posts > Categories

== Frequently Asked Questions ==

= Which taxonomies can I manage? =

All public taxonomies registered on your site, including the built-in Categories and Tags as well as any custom taxonomies added by your theme or other plugins. You can choose which taxonomies to manage in the plugin settings.

= Can I still access the classic category screen? =

Yes. The manager includes a link to the classic "WordPress Native Categories" screen in the top-right corner of the interface.

= Can I import terms from another site? =

Yes, the plugin includes an import/export feature that allows you to transfer term structures between WordPress sites.

= Will this plugin affect my existing terms? =

No, installing the plugin will not modify your existing taxonomy structure. It provides an alternative interface for managing your terms.

= How do I report bugs or request features? =

Please visit our [GitHub repository](https://github.com/gbti-network/better-category-manager) to report issues or request new features.

== External services ==

This plugin offers an optional integration with the OpenAI API for generating term descriptions:

* **What it does**: When enabled and configured with an API key, the plugin can generate descriptive text for your terms using OpenAI's language models.
* **When data is sent**: Data is only sent to OpenAI when you explicitly click the "Generate Description" button in the term editor, or when you click "Validate Key" in the settings to check your API key.
* **What data is sent**: The plugin sends the term name and a customizable prompt to OpenAI's servers. Validating a key sends a request to OpenAI authenticated with that key.
* **Terms of Service**: [OpenAI Terms of Service](https://openai.com/policies/terms-of-use)
* **Privacy Policy**: [OpenAI Privacy Policy](https://openai.com/policies/privacy-policy)

This feature is completely optional and requires you to provide your own OpenAI API key in the plugin settings. No data is sent to OpenAI unless you explicitly initiate the description generation or key validation.

== Screenshots ==

1. Compact List view — a dense, sortable list with drag-to-reorder/re-nest, multi-select, and bulk actions
2. Columns view — drill through your hierarchy Miller-column style
3. Cards view — every top-level group and its child terms at a glance
4. Tree view — an interactive mind-map of your taxonomy
5. Term editor — edit a term inline and optionally generate a description with OpenAI
6. Settings — choose managed taxonomies, the default taxonomy, the default view, and more

== Changelog ==

= 2.1.1 =
* New: switch between four term views — Compact List, Columns (Miller), Cards, and Tree — with a configurable default view
* New: drag a term to reorder it among its siblings, or drag sideways to nest it under another term or outdent it, with a live placement note showing where it will land
* New: drag-to-reparent in the Cards view (move a child chip between groups) and the Tree view (drop a node onto a new parent)
* New: bulk actions — Move selected terms under a new parent, Merge several terms into one, and bulk Delete
* New: manual term ordering, with an optional setting to apply your custom order across the front end of the site
* New: search/filter now works in every view
* Improved: panels size to their content (no excess empty space), the editor goes full-width on small screens, and assorted layout polish
* Translations: regenerated the POT catalog for the new strings

= 2.0.1 =
* New Overview tab in Settings with a feature summary and community links
* Added a branded, colored page header and a centered, max-width settings layout
* Term editor: added a "View" button that opens a term's public archive in a new tab (when the taxonomy is publicly viewable)
* Term editor: added an "Info" button that lists the posts assigned to a term (Title, Edit, View, Post Type) in a paginated popup (25 per page)
* The editor now respects the "Managed Taxonomies" setting and only lists the taxonomies you enable
* Managed taxonomies now open in the editor from their menu links instead of the legacy term screens
* The "WordPress Native" toolbar link and page title now follow the selected taxonomy
* Fixed a brief flash of the page before the loading screen on the editor
* Reviewed and improved translations across all 18 included locales
* Security hardening: per-taxonomy capability checks on AJAX requests, stricter input handling, sanitized term-meta import, and escaped log viewer output

= 2.0.0 =
* Renamed to Advanced Taxonomy Manager
* Added management for all public taxonomies (categories, tags, and custom taxonomies), not just categories
* Added a taxonomy selector and configurable default taxonomy
* Added selectable OpenAI model and an API key validation button
* Added an optional debug log viewer (active in local/debug environments)
* Now completely free and ungated

= 1.0.4 =
* Adding support for 6.8.2

= 1.0.3 =
* Initial release

== Upgrade Notice ==

= 2.1.1 =
* Adds four switchable term views (Compact List, Columns, Cards, Tree), drag-to-reorder/re-nest, bulk Move/Merge/Delete, and optional site-wide manual ordering.

= 2.0.1 =
* Adds View/Info actions in the term editor (with a paginated posts popup), a new Overview tab, taxonomy-aware navigation, refreshed translations, and security hardening.

= 2.0.0 =
* Advanced Category Manager is now Advanced Taxonomy Manager and manages all taxonomies, free of charge. Your existing settings are migrated automatically.

== Additional Information ==

= Documentation =

For detailed documentation, please visit our [GitHub repository](https://github.com/gbti-network/better-category-manager).

= Support =

For support inquiries, please use the [GitHub issue tracker](https://github.com/gbti-network/better-category-manager/issues).

= Privacy =

Advanced Taxonomy Manager respects your privacy and does not collect any personal data.

= Credits =

This plugin is developed and maintained by the [GBTI Network](https://gbti.network/).
