WP Toon

Mirror selected WordPress REST endpoints under a new /wp-toon/* prefix and return their payloads in TOON (Text-Oriented Object Notation). TOON keeps the same structure as JSON but removes redundant characters so AI pipelines consume fewer tokens without touching your WordPress content model.

Features

• Drop-in alias for any whitelisted endpoint: keep https://example.com/wp-json/wp/v2/posts for JSON, add https://example.com/wp-toon/wp/v2/posts (or wp-json/toon/v1/...) for TOON.
• Uses the official php-toon encoder under the hood and exposes savings via response headers (X-WP-Toon-*) and optional debug logs.
• Whitelist-based proxy ensures only approved routes are mirrored; defaults cover core post/page endpoints and can be extended via filters.
• No schema changes: the plugin simply replays the original REST request inside WordPress and converts the successful JSON body to TOON before streaming it back as text/plain.

Security Model

• Authentication & permissions: the proxy never bypasses WordPress checks. Requests hit the WP REST API stack exactly once, so the same rules apply:
  • Logged-in users rely on cookies + X-WP-Nonce.
  • Application Passwords keep working (Basic Auth processed before our proxy runs).
  • OAuth/JWT plugins remain in charge if the site already uses them.
• Authorization: rest_do_request() executes the original endpoint, so if the upstream route returns 401/403, the TOON mirror returns that error untouched.
• Attack surface: no new roles, caps, or custom auth handlers. The whitelist (includes/Whitelist.php) restricts which routes are exposable; anything not explicitly approved returns 403.
• Transport: responses are emitted as plain text with the same HTTP headers (cache-control, pagination, etc.) except for Content-Type, which becomes text/plain; charset=utf-8.

Installation

1. Download the latest release ZIP (or clone the repo) and upload the entire folder to wp-content/plugins/wp-toon/.
2. Activate “WP Toon” in Plugins → Installed Plugins.
3. Visit Settings → Permalinks and click “Save” once to flush rewrite rules (or deactivate/activate the plugin) so /wp-toon/* becomes available.

Requirements: PHP 8.1+, WordPress 6.0+.

Usage

JSON  → https://example.com/wp-json/wp/v2/posts?per_page=5
TOON  → https://example.com/wp-toon/wp/v2/posts?per_page=5
Alt.  → https://example.com/wp-json/toon/v1/wp/v2/posts?per_page=5

• Query parameters, methods, and pagination behave exactly the same as the upstream endpoint.
• Successful responses include:
  • X-WP-Toon-JSON-Bytes
  • X-WP-Toon-TOON-Bytes
  • X-WP-Toon-Savings-Percent
• Enable WP_DEBUG (or the wp_toon_enable_logging filter) to log the same metrics to wp-content/debug.log.

Configuration