Nahnu Code & API Block

Registre de canvis

1.0.2

• Added a WordPress Shortcode language option to the code block, for displaying example [nahnu_code_block ...] shortcode syntax (or any other plugin’s shortcode syntax) as a properly highlighted, copy-pasteable code sample.
• Fixed: an example shortcode shown inside a code block could get picked up and actually executed by WordPress’s own do_shortcode(), which runs over the entire rendered page after every block (including this one) has already produced its output — square brackets pass through esc_html() untouched, so a literal [nahnu_code_block ...] example was never actually inert. The code block’s displayed brackets are now encoded as HTML entities at the character level, which a browser still renders as ordinary [/] and which the Copy button (reading the browser’s own decoded text) still copies as real, directly usable brackets — but which WordPress’s shortcode parser can no longer misread as a real invocation. This fixes example shortcodes silently vanishing (or, worse, swallowing surrounding page content) when shown this way; no double-bracket escaping needed.
• Added an optional «Show a live rendered preview» toggle for the WordPress Shortcode language: runs the code sample for real and shows its actual output in a separate, clearly labeled panel below the (still inert) code sample — useful for demonstrating what a shortcode produces. This runs in isolation on just that one code sample, never on the surrounding page, so it can’t affect anything outside its own preview panel.
• Added nahnu_code_block_render() (and nahnu_code_block_the(), its echoing counterpart) so a theme or plugin developer can render any of this plugin’s blocks directly from PHP — in a template file, a widget, or a page-builder module — without needing the block to live in a post’s content or pass through the block editor.
• Added a [nahnu_code_block block="..."] shortcode wrapping the same rendering path, for widgets, classic-editor content, and page builders that only accept shortcodes.
• Fixed: any block whose main attribute is a JSON array or list (Parameters, Response Body, Status Codes, Error Codes, Events, Servers, Request/Response, Endpoint’s related operations) — as well as the code-block block’s code attribute — now reads that value from the shortcode’s enclosed content instead of a quoted attribute. A quoted attribute can never safely hold a JSON array (WordPress’s own shortcode parser treats any ] character inside the tag, even deep inside a quoted attribute’s value, as the end of that shortcode — corrupting it the moment the array isn’t empty), and can’t hold real code containing a quote character either.
• Fixed a much bigger issue affecting every [nahnu_code_block] attribute on every block, not just the ones above: the shortcode handler was normalizing attributes through shortcode_atts() against a list that only ever contained block and the seven color-override names, which meant every other attribute a block actually needed — code, method, path, language, all of it — was being silently discarded before the block ever rendered, on every single shortcode call. On top of that, WordPress always lowercases shortcode attribute names before a callback sees them, which broke every camelCase attribute (operationId, authRequired, relatedOperations, showLineNumbers, and others) independently of the first bug. Both are fixed: every attribute now reaches its block correctly, under its real declared name, regardless of the case it was written in.
• Added a Settings → Nahnu Code Block admin page: a color picker for each core theme color, in both light and dark mode, with no code required. Applies site-wide, to every block however it was placed (block editor, PHP rendering, or the shortcode).
• Added per-instance color overrides — accentColor, accentTextColor, bgColor, chromeBgColor, textColor, borderColor, mutedColor shortcode attributes, or a third argument to nahnu_code_block_render()/nahnu_code_block_the() — so a single shortcode or PHP-rendered block can carry its own branding without changing the site-wide palette.
• Fixed: a block rendered this new way after wp_head() has already printed (the common case for a template file, since it usually runs after get_header()) now still gets its stylesheet, instead of silently rendering unstyled.
• Documented the new PHP rendering API, shortcode, settings page, and per-instance branding in INTEGRATION.md and HOOKS.md.
• Mobile responsiveness pass across all 12 blocks: the Parameters, Error Codes, Status Codes, Events, and Response Body blocks’ tables now scroll horizontally within their own container instead of squeezing columns unreadably or breaking the page’s layout on narrow screens. The Try It console’s method/URL row, the Request/Response language sub-tabs, the Authentication header line, and the Response Body toolbar now wrap onto multiple lines on narrow screens instead of overflowing. The code block’s copy/theme-toggle toolbar and the deep-link anchor icons — both previously shown only on :hover — are now always visible on touch devices, since touchscreens don’t reliably trigger hover states.

1.0.1

• Added six new blocks: Response Body (status-code accordion with real response JSON), Error Codes (API-level error taxonomy, distinct from HTTP status codes), Events (webhook/event names), API Navigation (auto-generated jump-list of Endpoint blocks on the page), and Servers (base URLs, maps onto OpenAPI’s servers array).
• Parameters block: added Format and Default value badges, support for nested object parameters (e.g. an address parameter with its own line1/city fields), parameter location (query/path/header/cookie/body, matching OpenAPI’s in field), a per-parameter Deprecated flag, and an Allowed-values (enum) field.
• Added deep-linkable anchors: a copy-link icon on Parameters rows, Endpoint blocks, Error Codes, and Events, each generating a stable, page-unique URL you can share directly to that specific item.
• Added nahnu_code_block_build_block_markup() — lets another plugin (e.g. a docs platform importing an OpenAPI spec) generate any of this plugin’s blocks programmatically, with correct WordPress block markup and sensible attribute defaults. Documented in the new INTEGRATION.md.
• Added the nahnu_code_block_pre_attributes filter, for third-party plugins that scan the page and inject their own UI into <pre> elements (with a real example for WP Super Docs, which was colliding with this plugin’s own copy button and language label).
• Security: filter-derived theme CSS is now stripped of characters that could break out of the <style> element it’s printed inside, following a WordPress.org review finding.
• Fixed the Copy button not correctly scoping to the clicked item when a block has multiple independent code panels open at once (surfaced by the new Response Body block’s accordion).
• Fixed two buttons (Auth and Request/Response) left referencing a CSS class removed during an earlier redesign, which meant they rendered with no styling at all.
• Fixed table titles on the Parameters and Status Codes blocks losing their styling after the same redesign.
• Corrected the Plugin URI in the plugin header, which pointed at a URL that didn’t resolve.

1.0.0

• First public WP.org version.