外掛說明
WebberZone Code Block Highlighting is the easiest way to add syntax highlighting to your WordPress site. It extends the native Gutenberg core/code block with Prism.js highlighting — no shortcodes, no block replacement, no risk of breaking existing posts.
Simply activate the plugin and your code blocks will instantly display beautiful, readable syntax highlighting on the frontend. Choose from 35+ programming languages and 21 colour themes, all controlled from the block editor’s Inspector Controls sidebar.
Why use this plugin?
- Safe by design — Works as a filter on top of
core/code. Existing posts are never invalidated. Deactivate the plugin and your blocks are still valid standard WordPress code blocks. - Zero configuration — Activate and start writing. No setup wizard, no shortcodes.
- Smart asset loading — Prism CSS and JS only load on pages that actually contain code blocks. Pages without code stay fast.
- Per-block controls — Set language, theme, line numbers, word wrap, title, highlighted lines, and max height individually for each block.
- Developer-friendly — Filters to add languages, override themes, and force asset loading.
Supported languages
40 languages including: Apache Config, Bash, C, C++, C#, CSS, Dart, Docker, F#, Go, GraphQL, Groovy, Haskell, HTML, Java, JavaScript, JSON, JSX, Kotlin, Lua, Markdown, Nginx, Objective-C, Perl, PHP, PowerShell, Python, R, Ruby, Rust, Sass, Scala, SQL, Swift, TOML, TSX, TypeScript, Vim, XML, YAML. Use the wzcbh_languages filter to add or remove entries from the language picker.
Included themes (21)
A11y Dark, Coldark Cold (Light), Coldark Dark, Dracula, Duotone Dark, Duotone Light, GitHub (Light), Gruvbox Dark, Gruvbox Light, Lucario, Material Dark, Material Light, Night Owl, Nord, One Dark, One Light, Shades of Purple, Solarized Dark, Synthwave ’84, VS Code Dark+, Xonokai (Monokai).
Per-block features
- Language selector — Choose the programming language from the sidebar; applies the correct Prism grammar automatically.
- Line numbers — Toggle line numbers per block, with a configurable start line.
- File title / label — Add an optional filename or label displayed in the code block toolbar.
- Highlight lines — Specify lines or ranges (e.g.
1,3-5) to visually highlight using Prism’s line-highlight plugin. - Max height with expand/collapse — Set a maximum height in pixels; an expand/collapse toolbar button appears automatically.
- Word wrap — Toggle soft word wrapping per block.
Global settings
- Default colour scheme (theme)
- Default language
- Default line numbers toggle and start value
- Default word wrap
- Copy-to-clipboard button
- Show language label in toolbar
- Font size
Developer filters
wzcbh_languages— Filter the language list array (slug => label)wzcbh_color_scheme_css_url— Override the Prism theme CSS URLwzcbh_force_load_assets— Force Prism assets to load on every page
GDPR
WebberZone Code Block Highlighting does not collect personal data, set cookies, or communicate with any external services.
Contribute
The plugin is open source and available on GitHub. Pull requests for bug fixes and new features are welcome. Please use the WordPress.org support forum for support and GitHub Issues for confirmed bug reports.
Translations
Help translate WebberZone Code Block Highlighting into your language on WordPress.org. See the Translator Handbook for guidance.
Other plugins by WebberZone
- Contextual Related Posts — Display fast, intelligent related posts to keep visitors on your site longer
- Top 10 — Track daily and total visits and display popular and trending posts
- WebberZone Snippetz — Manage custom HTML, CSS and JS snippets across your site
- Knowledge Base — Create a knowledge base or FAQ section on your WordPress site
- Better Search — Contextual search results sorted by relevance
- Auto-Close — Automatically close comments, pingbacks, trackbacks and manage revisions
- Popular Authors — Display popular authors in a WordPress widget
- Followed Posts — Show related posts based on what your visitors have already read
- WebberZone Link Warnings — Add accessible warnings for external links and target=”_blank” links
螢幕擷圖
Block editor — language picker, line numbers toggle, title field, and more in the Inspector Controls sidebar. 
Frontend code block with Prism.js syntax highlighting, line numbers, and toolbar. 
Plugin settings page — choose a global colour scheme, default language, and more.
安裝方式
WordPress admin (recommended)
- Go to Plugins > Add New in your WordPress admin.
- Search for WebberZone Code Block Highlighting.
- Click Install Now, then Activate.
Manual installation
- Download the plugin zip file.
- Extract it to your
wp-content/plugins/directory. You should end up with awebberzone-code-block-highlighting/folder. - Go to Plugins in your WordPress admin and activate WebberZone Code Block Highlighting.
After activation, open any post or page in the block editor, add or select a Code block, and the Code Highlighting panel will appear in the Inspector Controls sidebar.
常見問題集
-
Does this plugin replace the core Code block?
-
No. WebberZone Code Block Highlighting uses JavaScript and PHP filters to extend the native
core/codeblock. It never swaps the block for a custom one, so existing posts are never invalidated and the plugin can be deactivated without leaving behind broken blocks. -
Will my code blocks break if I deactivate the plugin?
-
No. Because the plugin extends
core/coderather than replacing it, deactivating simply removes the highlighting. Your code content is stored in standard WordPress block markup and remains valid. -
Which programming languages are supported?
-
40 languages out of the box: Apache Config, Bash, C, C++, C#, CSS, Dart, Docker, F#, Go, GraphQL, Groovy, Haskell, HTML, Java, JavaScript, JSON, JSX, Kotlin, Lua, Markdown, Nginx, Objective-C, Perl, PHP, PowerShell, Python, R, Ruby, Rust, Sass, Scala, SQL, Swift, TOML, TSX, TypeScript, Vim, XML, and YAML.
Use the
wzcbh_languagesfilter to add or remove entries from the language picker. Note: adding a language to the filter only affects the UI dropdown — the corresponding Prism.js grammar must also be available on the frontend (either bundled infrontend.jsor loaded separately). -
How do I add a custom or additional Prism theme?
-
- Add the theme mapping in
build-prism.js. - Copy the generated CSS to
includes/assets/. - Register the slug in
includes/admin/class-settings.php. - Run
npm run build:prism.
You can also use the
wzcbh_color_scheme_css_urlfilter to point to any CSS file without touching the plugin source. - Add the theme mapping in
-
Does Prism.js load on every page?
-
No. Prism CSS and JS are only enqueued on pages that contain at least one code block. All other pages are unaffected. Use the
wzcbh_force_load_assetsfilter to override this behaviour if needed. -
How do I highlight specific lines in a code block?
-
Enter a comma-separated list of lines or ranges in the Highlight Lines field in the Inspector Controls sidebar (e.g.
1,3-5,8). This maps to thedata-lineattribute consumed by the Prism line-highlight plugin. -
Can I show a filename or label on the code block?
-
Yes. Use the Title field in the Inspector Controls sidebar. The label is displayed in the Prism toolbar above the code block.
-
Does the plugin support dark mode or multiple themes?
-
The plugin ships with 21 Prism themes. The active theme is selected globally on the settings page (Settings > Code Block Highlighting). Per-block theme switching is not currently supported.
-
Is this plugin compatible with the WordPress block editor (Gutenberg)?
-
Yes. The plugin is built specifically for the Gutenberg block editor (WordPress 6.6+) and uses the native block filter APIs. It does not support the Classic Editor.
-
How can I report security vulnerabilities?
-
Report security bugs through the Patchstack Vulnerability Disclosure Program. The Patchstack team will validate, triage, and handle any reported vulnerabilities. Report a security vulnerability.
使用者評論
這個外掛目前沒有任何使用者評論。
參與者及開發者
變更記錄
1.0.0
- Initial release.
- Extends
core/codewith Prism.js syntax highlighting — no block replacement, no block validation errors. - 40 supported languages with per-block language selection.
- 21 built-in Prism themes selectable from the settings page.
- Per-block controls: language, line numbers, start line, word wrap, title, highlight lines, and max height.
- Expand/collapse toolbar button for blocks with a max-height set.
- Smart asset loading — Prism CSS and JS only enqueued on pages containing code blocks.
- Copy-to-clipboard and show-language toolbar buttons (configurable globally).
- Global settings page for colour scheme, default language, and more.
- Developer filters:
wzcbh_languages,wzcbh_color_scheme_css_url,wzcbh_force_load_assets. - GDPR-friendly: no data collection, no external requests.