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(參數);
?查看具體內容