pf_page_suffix
基礎(chǔ)信息
名稱：pf_page_suffix
類型：過濾器（filter）
作用：主題頁面、滾動圖的鉤子均與“頁面后綴”有關(guān)。如：404頁面的后綴為_404,文章內(nèi)容頁的后綴為_single(post)等。這些后綴在顯示頁面主列以及顯示頂部滾動圖時，均會造成影響。因此，修改此過濾器需要非常謹慎。修改后，可能出現(xiàn)某個頁面內(nèi)容不是預(yù)期效果的問題。
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | String | 主題自動判定的后綴 |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
使用示例
將404頁使用搜索頁的后綴（將連帶修改頁面顯示的部分內(nèi)容變成搜索頁）
add_filter('pf_page_suffix',function($suffix){return $suffix == '_404' ? '_search' : $suffix;});
pf_sidebar_selectors
基礎(chǔ)信息
名稱：pf_sidebar_selectors
類型：過濾器（filter）
作用：用于定義邊欄切換按鈕及邊欄內(nèi)容
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | Array | 邊欄按鈕 |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
使用示例
僅顯示自定義邊欄（要顯示邊欄內(nèi)容需額外注冊名為“my_sidebar”的邊欄）
add_filter('pf_sidebar_selectors',function($tobe_filtered){return ['my_sidebar' => ['name' => '我的邊欄','html' => '<span>?</span>']];});
pf_static_nav_logo
基礎(chǔ)信息
名稱：pf_static_nav_logo
類型：過濾器（filter）
作用：固定在頂部的導(dǎo)航條左側(cè)LOGO顯示的HMTL標簽內(nèi)容
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | String | img標簽 |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
使用示例
忽略后臺設(shè)置的LOGO參數(shù)，強制更換成自定義文本
add_filter('pf_static_nav_logo',function(){return "自定義HTML內(nèi)容";});
pf_header_image
基礎(chǔ)信息
名稱：pf_header_image
類型：過濾器（filter）
作用：主題頁面頂部的圖片
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | String | img標簽 |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
使用示例
忽略后臺設(shè)置的頂部圖片參數(shù)，強制更換成自定義文本
add_filter('pf_header_image',function(){return "自定義HTML內(nèi)容";});
pf_the_modal_title
基礎(chǔ)信息
名稱：pf_the_modal_title
類型：過濾器（filter）
作用：輸出（首頁）模塊標題HTML
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | String | 組裝后的HTML |
| 2 | String | 原始標題字符串 |
| 3 | Int/Array | 類型標記 |
類型標記可能的值：
| 值 | 備注 |
|---|---|
| 字符串 | Tag名稱 |
| 包含數(shù)字的數(shù)組 | 該數(shù)組中的每個值均是文章分類ID |
| >0的正整數(shù) | 文章分類ID |
| 0 | 默認（未定義） |
| -1 | “最新文章”標題 |
| -2 | “點贊最多(大家喜歡)”標題 |
| -3 | “評論最多(熱門討論)”標題 |
| -4 | “閱讀量最多”標題 |
| -5 | “隨機文章”標題 |
| -6 | “搜索結(jié)果”標題 |
| -7 | “排行榜”標題 |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
使用示例
例：根據(jù)標記組裝自定義標題
add_filter("pf_the_modal_title",function($tobe_filtered_html, $original_text, $remark){if($remark == -1){return "<div class='custom-modal-title'>我的最新文章</div>";} else {return $tobe_filtered_html;}},10,3);
pf_show_post_function
基礎(chǔ)信息
名稱：pf_show_post_function
類型：過濾器（filter）
作用：用于修改顯示文章卡片的方法（名）
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | String | 主題默認顯示方法名 |
| 2 | Array | 準備顯示的文章ID |
| 3 | Int/Array | 類型標記 |
類型標記可能的值：
| 值 | 備注 |
|---|---|
| 字符串 | Tag名稱 |
| 包含數(shù)字的數(shù)組 | 該數(shù)組中的每個值均是文章分類ID |
| >0的正整數(shù) | 文章分類ID |
| 0 | 默認（未定義） |
| -1 | “最新文章”標題 |
| -2 | “點贊最多(大家喜歡)”標題 |
| -3 | “評論最多(熱門討論)”標題 |
| -4 | “閱讀量最多”標題 |
| -5 | “隨機文章”標題 |
| -6 | “搜索結(jié)果”標題 |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
使用示例
文章分類ID是8的，使用自定義顯示方式顯示。其它仍然使用主題原始的卡片展示方式：
//替換輸出方法add_filter('pf_show_post_function',function($tobe_filtered,$ids,$remark){return $remark == 10 ? "my_custom_show_post_func" : $tobe_filtered;},10,3);//自定義輸出方法function my_custom_show_post_func($post_id=0,$type_id=0, $sn='') {$html = "<a href='".get_permalink($post_id)."'>".get_the_title($post_id)."</a>";echo $html;}
pf_recommend_selectors
基礎(chǔ)信息
名稱：pf_recommend_selectors
類型：過濾器（filter）
作用：文章推薦模塊（點贊最多、評論最多、閱讀最多）的Tab選擇器內(nèi)容
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | Array | 選擇器HTML名稱 |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
使用示例
除了點贊最多、評論最多、閱讀最多以外，增加一個自定義的Tab：
add_filter('pf_recommend_selectors',function($tobe_filtered){$tobe_filtered[] = "自定義<b>Tab</b>";return $tobe_filtered;});
注：真實使用場景除了增加選擇器按鈕外，還應(yīng)該增加Panel內(nèi)容，詳見pf_recommend_panels動作鉤子
pf_frontpage_modal_query_args
基礎(chǔ)信息
名稱：pf_frontpage_modal_query_args
類型：過濾器（filter）
作用：首頁模塊數(shù)據(jù)查詢參數(shù)過濾
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | Array | 原始參數(shù) |
| 2 | Int/Array | 類型標記 |
類型標記可能的值：
| 值 | 備注 |
|---|---|
| 字符串 | Tag名稱 |
| 包含數(shù)字的數(shù)組 | 該數(shù)組中的每個值均是文章分類ID |
| >0的正整數(shù) | 文章分類ID |
| 0 | 默認（未定義） |
| -1 | “最新文章” |
| -2 | “點贊最多(大家喜歡)” |
| -3 | “評論最多(熱門討論)” |
| -4 | “閱讀量最多” |
| -5 | “隨機文章” |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
使用示例
例：“大家喜歡”模塊在首頁設(shè)置成12篇文章
add_filter("pf_frontpage_modal_query_args",function($args, $type_id){// 類型標記為-2是“點贊最多(大家喜歡)”if ($type_id == -2) {//修改查詢數(shù)量（參見WP_Query的參數(shù)說明）$args['posts_per_page'] = 12;}return $args;},10,2);
pf_frontpage_modal_query_result_ids
基礎(chǔ)信息
名稱：pf_frontpage_modal_query_result_ids
類型：過濾器（filter）
作用：首頁模塊數(shù)據(jù)查詢結(jié)果過濾
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | Array | 查詢到的文章ID |
| 2 | Int/Array | 類型標記 |
類型標記可能的值：
| 值 | 備注 |
|---|---|
| 字符串 | Tag名稱 |
| 包含數(shù)字的數(shù)組 | 該數(shù)組中的每個值均是文章分類ID |
| >0的正整數(shù) | 文章分類ID |
| 0 | 默認（未定義） |
| -1 | “最新文章” |
| -2 | “點贊最多(大家喜歡)” |
| -3 | “評論最多(熱門討論)” |
| -4 | “閱讀量最多” |
| -5 | “隨機文章” |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
使用示例
打亂首頁最新文章的id，讓顯示順序也隨機
add_filter('pf_frontpage_modal_query_result_ids',function($ids, $type_id){// 類型標記為-1是“最新文章”if ($type_id == -1) {shuffle($ids);}return $ids;},10,2);
pf_the_modal_link
基礎(chǔ)信息
名稱：pf_the_modal_link
類型：過濾器（filter）
作用：輸出（首頁）模塊“閱讀更多”鏈接HTML
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | String | 組裝后的HTML |
| 2 | Int/Array | 類型標記 |
類型標記可能的值：
| 值 | 備注 |
|---|---|
| 字符串 | Tag名稱 |
| 包含數(shù)字的數(shù)組 | 該數(shù)組中的每個值均是文章分類ID |
| >0的正整數(shù) | 文章分類ID |
| 0 | 默認（未定義） |
| -1 | “最新文章”標題 |
| -2 | “點贊最多(大家喜歡)”標題 |
| -3 | “評論最多(熱門討論)”標題 |
| -4 | “閱讀量最多”標題 |
| -5 | “隨機文章”標題 |
| -6 | “搜索結(jié)果”標題 |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
pf_slider_type
基礎(chǔ)信息
名稱：pf_slider_type
類型：過濾器（filter）
作用：對slider輸出的類型進行過濾，默認有card-flip和landscape兩種
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | String | 原始類型 |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法
pf_slider_data
基礎(chǔ)信息
名稱：pf_slider_data
類型：過濾器（filter）
作用：對slider輸出的數(shù)據(jù)進行過濾
過濾器參數(shù)
| # | 類型 | 備注 |
|---|---|---|
| 1 | Array | 默認數(shù)據(jù) |
其他：
- 參數(shù)可使用?
var_dump(參數(shù));?查看具體內(nèi)容 - 若接收2個及以上參數(shù)，在添加過濾器時務(wù)必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?
add_filter?用法