pf_page_suffix

基礎信息

名稱：pf_page_suffix
類型：過濾器（filter）
作用：主題頁面、滾動圖的鉤子均與“頁面后綴”有關(guān)。如：404頁面的后綴為_404,文章內(nèi)容頁的后綴為_single(post)等。這些后綴在顯示頁面主列以及顯示頂部滾動圖時，均會造成影響。因此，修改此過濾器需要非常謹慎。修改后，可能出現(xiàn)某個頁面內(nèi)容不是預期效果的問題。

過濾器參數(shù)

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(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

基礎信息

名稱：pf_sidebar_selectors
類型：過濾器（filter）
作用：用于定義邊欄切換按鈕及邊欄內(nèi)容

過濾器參數(shù)

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(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

基礎信息

名稱：pf_static_nav_logo
類型：過濾器（filter）
作用：固定在頂部的導航條左側(cè)LOGO顯示的HMTL標簽內(nèi)容

過濾器參數(shù)

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?add_filter?用法

使用示例

忽略后臺設置的LOGO參數(shù)，強制更換成自定義文本

add_filter('pf_static_nav_logo',function(){    return "自定義HTML內(nèi)容";});

pf_header_image

基礎信息

名稱：pf_header_image
類型：過濾器（filter）
作用：主題頁面頂部的圖片

過濾器參數(shù)

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?add_filter?用法

使用示例

忽略后臺設置的頂部圖片參數(shù)，強制更換成自定義文本

add_filter('pf_header_image',function(){    return "自定義HTML內(nèi)容";});

pf_the_modal_title

基礎信息

名稱：pf_the_modal_title
類型：過濾器（filter）
作用：輸出（首頁）模塊標題HTML

過濾器參數(shù)

類型標記可能的值：

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(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

基礎信息

名稱：pf_show_post_function
類型：過濾器（filter）
作用：用于修改顯示文章卡片的方法（名）

過濾器參數(shù)

類型標記可能的值：

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(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

基礎信息

名稱：pf_recommend_selectors
類型：過濾器（filter）
作用：文章推薦模塊（點贊最多、評論最多、閱讀最多）的Tab選擇器內(nèi)容

過濾器參數(shù)

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(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;});

注：真實使用場景除了增加選擇器按鈕外，還應該增加Panel內(nèi)容，詳見pf_recommend_panels動作鉤子

pf_frontpage_modal_query_args

基礎信息

名稱：pf_frontpage_modal_query_args
類型：過濾器（filter）
作用：首頁模塊數(shù)據(jù)查詢參數(shù)過濾

過濾器參數(shù)

類型標記可能的值：

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?add_filter?用法

使用示例

例：“大家喜歡”模塊在首頁設置成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

基礎信息

名稱：pf_frontpage_modal_query_result_ids
類型：過濾器（filter）
作用：首頁模塊數(shù)據(jù)查詢結(jié)果過濾

過濾器參數(shù)

類型標記可能的值：

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(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

基礎信息

名稱：pf_the_modal_link
類型：過濾器（filter）
作用：輸出（首頁）模塊“閱讀更多”鏈接HTML

過濾器參數(shù)

類型標記可能的值：

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?add_filter?用法

pf_slider_type

基礎信息

名稱：pf_slider_type
類型：過濾器（filter）
作用：對slider輸出的類型進行過濾，默認有card-flip和landscape兩種

過濾器參數(shù)

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?add_filter?用法

pf_slider_data

基礎信息

名稱：pf_slider_data
類型：過濾器（filter）
作用：對slider輸出的數(shù)據(jù)進行過濾

過濾器參數(shù)

其他：

1. 參數(shù)可使用?var_dump(參數(shù));?查看具體內(nèi)容
2. 若接收2個及以上參數(shù)，在添加過濾器時務必跟上過濾器優(yōu)先級（默認10）以及參數(shù)數(shù)量，否則會報錯。詳見WordPress官方?add_filter?用法