=== Whaze Term Order for Posts ===
Contributors: whaze
Tags: taxonomy, terms, order, gutenberg, block editor
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.2
Stable tag: 1.2.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Order taxonomy terms individually per post, directly from the Gutenberg editor sidebar.

== Description ==

Whaze Term Order for Posts lets you enable per-post custom ordering of taxonomy terms directly from the Gutenberg editor sidebar. Configure which post types and taxonomies are managed via the admin settings page, or register them programmatically in code.

**Admin settings page:**

Go to **Settings → Term Order for Posts** to enable term ordering for any post type / taxonomy combination — no code required.

**For developers (optional):**

Register a post type / taxonomy combination programmatically:

`add_action( 'init', function () {
    whaze_term_order_for_posts_register( 'post', 'category' );
    whaze_term_order_for_posts_register( 'movie', 'genre' );
} );`

Retrieve ordered terms in templates or REST:

`$terms = whaze_term_order_for_posts_get_terms( get_the_ID(), 'category' );`

**Features:**

* Settings page to configure post type / taxonomy pairs — no code needed.
* Opt-in auto-apply: custom order applied automatically to native blocks, classic theme functions, and any code using `get_the_terms()` — no template changes required.
* Drag-and-drop reordering panel in the block editor sidebar.
* Order saved automatically with the post — no separate AJAX call.
* Falls back to default WordPress term order when no custom order is set.
* Unused order entries are cleaned up automatically when terms are removed.
* REST API field `term_order` for headless use cases.
* Fully translatable (i18n-ready).

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Go to **Settings → Term Order for Posts** to enable term ordering for your post types and taxonomies.

== Frequently Asked Questions ==

= Does this work with custom post types and taxonomies? =

Yes. Select any registered post type and taxonomy in the settings page, or pass them to `whaze_term_order_for_posts_register()`.

= What happens if no order is defined for a post? =

`whaze_term_order_for_posts_get_terms()` falls back to the standard `wp_get_object_terms()` result — the plugin is completely transparent. The auto-apply option also has no effect when no custom order is stored.

= What does the auto-apply option cover? =

It hooks into `get_the_terms()`, which is called by native blocks (`core/post-terms`), classic theme helpers (`the_category()`, `the_tags()`, `get_the_term_list()`, etc.), and any code that goes through that function. Direct calls to `wp_get_post_terms()` or `wp_get_object_terms()` are not affected — use `whaze_term_order_for_posts_get_terms()` for those.

= Is this multisite compatible? =

Yes. The order is stored as post meta and is therefore scoped to each site in the network.

== Changelog ==

= 1.2.0 =
* Add opt-in auto-apply option: enable custom term order automatically for native blocks, classic theme functions, and any code using `get_the_terms()` — no template changes required.

= 1.1.0 =
* Add admin settings page (Settings → Term Order for Posts) to configure post type / taxonomy pairs without writing code.
* Programmatic registrations via `whaze_term_order_for_posts_register()` remain fully supported and are shown as read-only in the settings page.

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.2.0 =
Adds an opt-in auto-apply option. No database changes. Fully backward-compatible.

= 1.1.0 =
Adds an admin settings page. No database changes. Fully backward-compatible.
