从门 / 高亮.js
一个简单的基于 Highlight.js 的 WordPress 语法高亮插件。
v2.1.0
2023-03-16 12:37 UTC
Requires
- php: >=7.4
README
一个简单的基于 Highlight.js 的 WordPress 语法高亮插件。
安装
使用 Composer 安装
composer require tfrommen/highlightjs
或者
- 下载 ZIP 文件.
- 将内容上传到您的 web 服务器上的
/wp-content/plugins/
目录。 - 通过 WordPress 的 插件 菜单激活该插件。
- 查看所有用
<pre><code>
标签包裹的代码片段的语法高亮(例如,一个core/code
块)。
要求
此插件 需要 PHP 7.4 或更高版本。
使用方法
请参阅 Highlight.js 文档。
过滤器
为了自定义插件的某些方面,它提供了一些过滤器。以下为每个过滤器的简短说明以及如何修改默认行为的代码示例。只需将相应的代码片段放入您的主题的 functions.php
文件或 自定义 插件,或放置在其他适当的位置。
\tfrommen\HighlightJs\FILTER_SHOULD_LOAD
(highlightjs.should_load
)
此过滤器允许您自定义插件加载的条件。默认值是 is_singular( 'post' ) && has_block( 'code' )
的结果,意味着插件仅对包含至少一个 core/code
块的单个帖子进行加载。
如果您想为所有包含任何块的单个帖子加载插件
<?php /** * Filters the condition for the plugin to load. * * @param bool $should_load Whether or not the plugin should load. */ add_filter( \tfrommen\HighlightJs\FILTER_SHOULD_LOAD, function () { return is_singlular( 'post' ); } );
如果您想为所有请求加载插件,可以使用 __return_true
WordPress 函数
<?php /** * Filters the condition for the plugin to load. * * @param bool $should_load Whether or not the plugin should load. */ add_filter( \tfrommen\HighlightJs\FILTER_SHOULD_LOAD, '__return_true' );
许可证
版权所有 (c) 2017 Thorsten Frommen
此代码受 MIT 许可证 保护。