custom_get_img_color
主題已使用較為先進(jìn)的主色調(diào)提取方法,因此不建議基礎(chǔ)用戶重寫它。對(duì)外提供此過(guò)濾器的意義在于:當(dāng)你認(rèn)為主題主色調(diào)提取方法不滿足您的高級(jí)需求時(shí),你再手動(dòng)改寫它
基礎(chǔ)信息
名稱:custom_get_img_color
類型:過(guò)濾器(filter)
作用:替換“獲取圖片顏色”的方法
過(guò)濾器參數(shù)
考慮到獲取主色調(diào)可能是異步行為,因此被過(guò)濾的是Function類型,通過(guò)回調(diào)來(lái)得到數(shù)據(jù)
# | 類型 | 備注 |
---|---|---|
1 | Function | 原始算法 |
2 | String | 圖片地址 |
其他:參數(shù)可使用?console.log(參數(shù));
?查看具體內(nèi)容
返回:新Function,新Function接收一個(gè)參數(shù)用于回調(diào)數(shù)據(jù):
# | 類型 | 備注 |
---|---|---|
1 | Function | resolve回調(diào)方法 |
使用示例
無(wú)論什么圖片,獲取主色調(diào)時(shí)總是得到淺藍(lán)色
add_filter('custom_get_img_color',function(original_function, url){
return function(resolve){
// 根據(jù)url圖片地址,使用其他算法得到顏色。例子中寫死顏色
var rgb_color = [32,160,255];
// 將顏色回調(diào)進(jìn)行后續(xù)處理
resolve(rgb_color);
}
});
text_to_speech_exclude
基礎(chǔ)信息
名稱:text_to_speech_exclude
類型:過(guò)濾器(filter)
作用:在文章朗讀時(shí),去除文章內(nèi)無(wú)需朗讀的標(biāo)簽
過(guò)濾器參數(shù)
# | 類型 | 備注 |
---|---|---|
1 | Array | 默認(rèn)排除的HTML元素?cái)?shù)組 |
其他:?參數(shù)可使用?console.log(參數(shù));
?查看具體內(nèi)容
使用示例
增加朗讀時(shí)需要排除的類型:1、類名為”tips”的元素。2、包含刪除線的”s”標(biāo)簽元素
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
基礎(chǔ)信息
名稱:text_to_speech_max_chars
類型:過(guò)濾器(filter)
作用:文章朗讀功能分段合成每段文字最大數(shù)量。
注:文章朗讀功能是在線合成,文章字?jǐn)?shù)較長(zhǎng)時(shí),合成會(huì)占用很長(zhǎng)時(shí)間,用戶等待較長(zhǎng)。因此將文章字?jǐn)?shù)拆解短,可減少首次等待時(shí)間。但越短,網(wǎng)絡(luò)請(qǐng)求次數(shù)就會(huì)越多。
- 根據(jù)合成API的要求,每段最大不允許超過(guò)2048。
- 若網(wǎng)絡(luò)環(huán)境較差,設(shè)置更大的數(shù)值可避免出現(xiàn)文章內(nèi)容朗讀時(shí)段落丟失的情況
過(guò)濾器參數(shù)
# | 類型 | 備注 |
---|---|---|
1 | Number | 分段合成文字字?jǐn)?shù) |
其他:?參數(shù)可使用?console.log(vars)查看具體內(nèi)容
使用示例
每段文字使用最大數(shù)量,減少合成次數(shù),盡量少的請(qǐng)求網(wǎng)絡(luò):
add_filter("text_to_speech_max_chars",function(){
return 2048;
})
check_color_can_use_dark
基礎(chǔ)信息
名稱:check_color_can_use_dark
類型:過(guò)濾器(filter)
作用:檢查是否使用暗色模式
過(guò)濾器參數(shù)
# | 類型 | 備注 |
---|---|---|
1 | Boolean | 主題默認(rèn)判定結(jié)果(True為不可使用) |
其他:?參數(shù)可使用?console.log(參數(shù));
看具體內(nèi)容
使用示例
若當(dāng)前是 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
基礎(chǔ)信息
名稱:enable_highlight.js
類型:過(guò)濾器(filter)
作用:允許主題默認(rèn)引入 highlight.js 并自動(dòng)高亮文章代碼
過(guò)濾器參數(shù)
# | 類型 | 備注 |
---|---|---|
1 | Boolean | 默認(rèn) true |
其他:?參數(shù)可使用?console.log(參數(shù));
?查看具體內(nèi)容
使用示例
完全禁用代碼高亮(在使用第三方高亮插件發(fā)生沖突時(shí),請(qǐng)使用下面的方式禁用)
add_filter("enable_highlight.js",function(){
return false;
});
get_avatar_url
基礎(chǔ)信息
名稱:get_avatar_url
類型:過(guò)濾器(filter)
作用:腳本處理Gravatar頭像時(shí)進(jìn)行二次過(guò)濾(和PHP鉤子完全一致)
過(guò)濾器參數(shù)
# | 類型 | 備注 |
---|---|---|
1 | String | 原始圖片頭像Url |
其他:?參數(shù)可使用?var_dump(參數(shù));
?查看具體內(nèi)容