Each code block has its own highlighting settings, available in the Syntax Highlighting panel of the Inspector Controls sidebar. These override the global defaults set on the Code Block Highlighting settings page.
Language
A dropdown listing 40+ supported languages. Selecting a language applies the correct Prism grammar (or highlight.php language in server-side mode). Choosing Plain Text renders the code with the active theme’s styling but no syntax highlighting.
The wzcbh_languagesOpens in a new window filter can be used to add or remove entries from the dropdown. Adding a language to the filter only affects the UI dropdown; the corresponding Prism.js grammar must also be available in frontend.js for the language to highlight correctly in client-side mode.
Line Numbers
Toggle to show or hide line numbers on this block. When enabled, a Start Line field appears. Set this to any integer to begin numbering from that value — useful when showing a code excerpt that starts partway through a file.
File Name or Title
A text field for an optional filename or label (e.g. config.yml). When Show File Name is enabled in global settings, the value is displayed above the block.
File Name Style in the global settings controls how it is displayed:
- Tab above the code block (default) — an editor-style tab sits flush on top of the block, colored to match the active theme’s own background and foreground. Rendered by PHP, so it looks the same in client-side and server-side modes.
- Toolbar label — the value appears as a label in the hover toolbar, alongside the language label and copy button.
If Show File Name is disabled globally, the field is still saved but not displayed.
Code blocks saved by the older Code Syntax Block plugin stored the filename in a title attribute on the <pre> element. These are read and displayed without needing the post to be re-saved.
Highlight Lines
Enter a comma-separated list of line numbers or ranges (e.g. 1,3-5,8) to visually highlight those lines. This maps to the Prism data-line attribute. Available in client-side mode only; has no effect in server-side mode.
Max Height
Set a maximum visible height in pixels. When the code block content exceeds this height, an Expand button appears in the toolbar; clicking it reveals the full block. Set to 0 (the default) to disable this limit. The height limit is applied as inline CSS and is not affected by the highlighting mode.
Word Wrap
Toggle soft word wrapping for long lines. When disabled (the default), long lines scroll horizontally.
Download Button
A dropdown that overrides the global Download Snippet setting for this block:
- Use global setting (default) — follow whatever the settings page says.
- Show — always show the Download button on this block, even when the global setting is off.
- Hide — never show it on this block, even when the global setting is on.
The downloaded file is named after File name or title when one is set; otherwise it is snippet.{ext}, with the extension derived from the block’s language. The button works identically in client-side and server-side modes, and the line-numbers gutter is excluded from the saved file.
Color Scheme
A dropdown that overrides the global Color Scheme setting for this block. Use global setting (default) follows the settings page; any other choice styles this block, its file name tab and its toolbar with that theme in both client-side and server-side modes. The editor preview shows the chosen theme’s background and text color. The theme’s stylesheet loads only on pages that use it.
Save as Default
After configuring the controls above, click Save as default at the bottom of the Syntax Highlighting panel to copy the current block’s settings (language, line numbers, line numbers start, word wrap, max height, download button and color scheme) into the global defaults. Future code blocks inserted via the editor will inherit these values. The file name and highlighted lines are specific to each snippet, so they are not saved. Saving a color scheme as the default only affects new blocks; the global Color Scheme setting is unchanged.
The button calls the POST /wzcbh/v1/default-settings REST endpoint under the wzcbh/v1 namespace. Only users with the manage_options capability can call it. See the Developer Reference for the full route schema.
Client-Side vs Server-Side Highlighting