Kodosvet Code Block
| 开发者 | kotophalk |
|---|---|
| 更新时间 | 2026年8月26日 06:02 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
Kodosvet Code Block is a zero-bloat Gutenberg block for displaying code with syntax highlighting powered by Highlight.js.
Key Features:
- Native Gutenberg Block — Full support for the visual editor with Server-Side Rendering.
- 14 Color Themes — Atom One, GitHub, Monokai, Dracula, Nord, VS Code, Stack Overflow, Night Owl, Gruvbox, Solarized, Panda, Tomorrow Night, Shades of Purple, Tokyo Night.
- Smart Language Detection — Automatic language identification using multi-layered heuristics for PHP, Bash, JavaScript, SQL, JSON, XML, and more.
- Swift Guard — Prevents Highlight.js from misidentifying code as Swift.
- Dark/Light Toggle — Switch all code blocks on the page between dark and light themes with one click.
- Copy to Clipboard — One-click code copying with visual feedback.
- Line Numbers — Toggleable line number gutter.
- Legacy Migrator — Built-in tool to scan and convert old
core/codeandcore/preformattedblocks. - Zero Bloat — Assets are loaded only when a code block is present on the page.
- No jQuery — Pure Vanilla JS on the frontend.
安装:
- Upload the
kodosvet-code-blockfolder to/wp-content/plugins/. - Activate the plugin through the 'Plugins' menu in WordPress.
- In the Block Editor, search for "Kodosvet" to insert a code block.
- Configure default theme and color palette under Tools → Kodosvet Code Block.
屏幕截图:
常见问题:
Does this plugin require any build tools?
No. Kodosvet Code Block ships as vanilla JavaScript and CSS — no Node.js, webpack, or build step required.
How does the language auto-detection work?
The plugin uses a multi-layer approach:
- Explicit language selection in block settings (highest priority).
- Markdown fence detection (```language).
- First-line language markers.
- Smart heuristics for PHP, Bash, JavaScript, SQL, and other languages.
- Highlight.js auto-detection (with Swift Guard to prevent false positives).
Can I migrate my existing code blocks?
Yes! Go to Tools → Kodosvet Code Block and click Scan Posts. The migrator will find all posts with core/code or core/preformatted blocks and let you preview and migrate them individually or in bulk.
Does migration create revisions?
Yes. The migrator uses wp_update_post(), so WordPress creates a revision for each migrated post. You can roll back through the standard Revisions interface.
What happens when I delete the plugin?
The plugin removes its settings (theme preference and color palette) from the database. Your code block content remains in the posts as Gutenberg block comments.
更新日志:
1.1.0
- Renamed: plugin is now "Kodosvet Code Block" (slug
kodosvet-code-block). Internal identifiers (block namestodum/code-block, option names, CSS classes) are unchanged so existing content keeps working. - Removed: bundled translation files and
load_plugin_textdomain()— translations are handled by translate.wordpress.org. - Changed:
register_setting()sanitize callbacks usesanitize_key()+ strict whitelist comparison.
- Fixed: Migrator preview modal showed "undefined (undefined blocks)" instead of the post title and block count.
- Fixed: Missing translator comments and unescaped output flagged by Plugin Check;
$wpdb->prepare()call inlined. - Changed: Highlight.js script/style handles are now prefixed (
stodum-hljs-*) to avoid clashes with other plugins. - Changed: Block title now has a small gap from the brand label in the toolbar.
- Added:
Author URI,License URI, LICENSE file for the bundled Highlight.js, "Third-Party Libraries" section in readme. - Added: JS translation JSON for the block editor (
wp i18n make-json); POT/ru_RU refreshed. - Tested up to WordPress 7.0.
- Changed: Highlight.js is now bundled locally (vendor/hljs/). CDN dependency removed. Plugin is now fully self-contained and compatible with WordPress.org guidelines.
- Fixed: Block now uses
get_block_wrapper_attributes()for proper wide/full alignment support. - Fixed: Migrator creates revisions via
wp_update_post(). - Fixed: Migrate All AJAX array serialization.
- Fixed: All editor strings now translatable.
- Added:
uninstall.phpfor clean removal. - Removed: Debug console.log output.
- Fixed: Complete rewrite of editor language detection with working Smart Heuristics.
- Added: Smart Language Heuristics for PHP, Bash, JavaScript.
- Fixed: Swift Auto-Detect Guard for Highlight.js 11+.
- Fixed: Data attribute naming mismatch and regex lastIndex bug.
- Fixed: Strict language mapping and
data-stodum-langsignal.
- Added: Global markdown paste interceptor.
- Initial release.