custom_get_img_color

主题已使用较为先进的主色调提取方法，因此不建议基础用户重写它。对外提供此过滤器的意义在于：当你认为主题主色调提取方法不满足您的高级需求时，你再手动改写它

基础信息

名称：custom_get_img_color
类型：过滤器（filter）
作用：替换“获取图片颜色”的方法

过滤器参数

考虑到获取主色调可能是异步行为，因此被过滤的是Function类型，通过回调来得到数据

#	类型	备注
1	Function	原始算法
2	String	图片地址

其他：参数可使用 console.log(参数); 查看具体内容

返回：新Function，新Function接收一个参数用于回调数据：

#	类型	备注
1	Function	resolve回调方法

使用示例

无论什么图片，获取主色调时总是得到浅蓝色

add_filter('custom_get_img_color',function(original_function, url){    return function(resolve){        // 根据url图片地址，使用其他算法得到颜色。例子中写死颜色        var rgb_color = [32,160,255];        // 将颜色回调进行后续处理        resolve(rgb_color);    }});

text_to_speech_exclude

基础信息

名称：text_to_speech_exclude
类型：过滤器（filter）
作用：在文章朗读时，去除文章内无需朗读的标签

过滤器参数

#	类型	备注
1	Array	默认排除的HTML元素数组

其他： 参数可使用 console.log(参数); 查看具体内容

使用示例

增加朗读时需要排除的类型：1、类名为”tips”的元素。2、包含删除线的”s”标签元素

add_filter("text_to_speech_exclude",function(original_selectors){    original_selectors.push( ".tips" );    original_selectors.push( "s" );    return original_selectors;})

text_to_speech_max_chars

基础信息

名称：text_to_speech_max_chars
类型：过滤器（filter）
作用：文章朗读功能分段合成每段文字最大数量。
注：文章朗读功能是在线合成，文章字数较长时，合成会占用很长时间，用户等待较长。因此将文章字数拆解短，可减少首次等待时间。但越短，网络请求次数就会越多。

• 根据合成API的要求，每段最大不允许超过2048。
• 若网络环境较差，设置更大的数值可避免出现文章内容朗读时段落丢失的情况

过滤器参数

#	类型	备注
1	Number	分段合成文字字数

其他： 参数可使用 console.log(vars)查看具体内容

使用示例

每段文字使用最大数量，减少合成次数，尽量少的请求网络：

add_filter("text_to_speech_max_chars",function(){    return 2048;})

check_color_can_use_dark

基础信息

名称：check_color_can_use_dark
类型：过滤器（filter）
作用：检查是否使用暗色模式

过滤器参数

#	类型	备注
1	Boolean	主题默认判定结果（True为不可使用）

其他： 参数可使用 console.log(参数);看具体内容

使用示例

若当前是 sample.php 模板，则不使用暗色模式

add_filter("check_color_can_use_dark",function( default_result ){    return pandastudio_framework.$('#wrapper').attr('data-page-template') == "sample.php" || default_result;});

enable_highlight.js

基础信息

名称：enable_highlight.js
类型：过滤器（filter）
作用：允许主题默认引入 highlight.js 并自动高亮文章代码

过滤器参数

#	类型	备注
1	Boolean	默认 true

其他： 参数可使用 console.log(参数); 查看具体内容

使用示例

完全禁用代码高亮（在使用第三方高亮插件发生冲突时，请使用下面的方式禁用）

add_filter("enable_highlight.js",function(){    return false;});

get_avatar_url

基础信息

名称：get_avatar_url
类型：过滤器（filter）
作用：脚本处理Gravatar头像时进行二次过滤（和PHP钩子完全一致）

过滤器参数

#	类型	备注
1	String	原始图片头像Url

其他： 参数可使用 var_dump(参数); 查看具体内容