=== Yorumakaze APO — Post Shelves ===
Contributors: tukuyo2027
Tags: posts, organization, writing, navigation, table of contents
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.11
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Organize WordPress posts into shelves and nested structures, with optional tables of contents and previous/next navigation.

== Description ==

Developed by 綯舞風lab. (Yorumakaze Lab). APO is the product abbreviation.


Yorumakaze APO adds an administration screen for organizing standard WordPress posts into custom shelves and nested groups.

Features include:

* Create shelves for different kinds of content.
* Arrange posts in nested structures.
* Add optional table-of-contents navigation to organized posts.
* Add optional previous/next post navigation.
* Create shelf landing pages using the `[yorumakaze_apo_shelf]` shortcode (legacy `[apo_shelf]` content is translated during rendering for backward compatibility).
* Connect the APO app with a one-time authorization code; raw connector credentials remain available only under developer details.

APO stores organization metadata in WordPress and keeps post content in the standard WordPress posts table.

= External connections =

APO does not automatically send data to a third-party service. A site administrator can explicitly connect the APO app from the WordPress administration screen. The connection button creates a one-time authorization code that expires after five minutes and is invalidated after use. The APO app at https://all-posts-organizer.floot.app/ exchanges that code server-to-server for the site's connector credential. Raw connector credentials remain available under developer details for compatible clients and should be kept private.

The public `/apo/v1/public` endpoint contains only published APO post metadata used for public shelf navigation. It does not expose draft content or the connector token.

== Installation ==

1. Upload the `yorumakaze-apo` folder to `/wp-content/plugins/`, or install the plugin ZIP through Plugins > Add Plugin > Upload Plugin.
2. Activate Yorumakaze APO — Post Shelves.
3. Open APO in the WordPress administration menu.
4. Create or edit shelves and organize posts as needed.
5. To connect the APO app, use the APO app connection button on the administration screen. Developer connection details remain available for compatible external clients.

== Frequently Asked Questions ==

= Does APO replace WordPress posts? =

No. Post titles and content remain standard WordPress posts. APO adds metadata for shelves, hierarchy, and ordering.

= Does APO send my content to an external service automatically? =

No. External access only occurs after an administrator explicitly starts an APO app connection or configures a compatible client from the developer connection details.

= What should I do if the connector token is exposed? =

Use the APO administration screen to regenerate it. The previous token will stop working.

= Does uninstalling APO delete my posts? =

No. APO does not delete WordPress posts when the plugin is removed.

== Changelog ==

= 1.0.10 =
* Use unique Yorumakaze APO option, transient and shortcode names per WordPress.org review feedback.
* Automatically copy settings from legacy keys on plugin upgrades without deleting original data.
* Keep the existing apo/v1 REST routes and support legacy shelf shortcode content at render time.


= 1.0.9 =
* Adopted a distinctive Yorumakaze-branded directory name and text domain.
* Increased the WordPress administrator menu position to respect the core menu hierarchy.
* Namespaced PHP declarations and constants with the Yorumakaze prefix.
* Preserved existing WordPress option keys, post metadata, administration URL, shortcode, REST endpoints and APO app connection behavior for compatibility.


= 1.0.8 =
* Refined WordPress administration interface, spacing, and menus.
* Removed duplicate Add Post control from the global header.
* Preserved existing APO application connection and post management behavior.

= 1.0.7 =
* Simplified the administration layout and connection instructions.


= 1.0.2 =
* Replaced the link-only app handoff with a five-minute, single-use authorization-code exchange flow.
* The APO app can now verify the WordPress site and save the connection without exposing the connector token in the browser URL.

= 1.0.1 =
* Added a one-click APO app connection button and moved raw connector credentials into developer details.

= 1.0.0 =
* Initial WordPress.org submission candidate.
* Organize posts into shelves and nested groups.
* Optional table of contents and previous/next navigation.
* Authenticated REST API for compatible APO clients.
* Public shelf metadata endpoint for published APO content.
