pf_page_suffix

基礎(chǔ)信息

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

過(guò)濾器參數(shù)

其他：

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

使用示例

將404頁(yè)使用搜索頁(yè)的后綴（將連帶修改頁(yè)面顯示的部分內(nèi)容變成搜索頁(yè)）

add_filter('pf_page_suffix',function($suffix){    return $suffix == '_404' ? '_search' : $suffix;});

pf_sidebar_selectors

基礎(chǔ)信息

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

過(guò)濾器參數(shù)

其他：

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

使用示例

僅顯示自定義邊欄（要顯示邊欄內(nèi)容需額外注冊(cè)名為“my_sidebar”的邊欄）

add_filter('pf_sidebar_selectors',function($tobe_filtered){    return [        'my_sidebar' => [            'name' => '我的邊欄',            'html' => '<span>?</span>'        ]    ];});

pf_static_nav_logo

基礎(chǔ)信息

名稱(chēng)：pf_static_nav_logo
類(lèi)型：過(guò)濾器（filter）
作用：固定在頂部的導(dǎo)航條左側(cè)LOGO顯示的HMTL標(biāo)簽內(nèi)容

過(guò)濾器參數(shù)

其他：

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

使用示例

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

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

pf_header_image

基礎(chǔ)信息

名稱(chēng)：pf_header_image
類(lèi)型：過(guò)濾器（filter）
作用：主題頁(yè)面頂部的圖片

過(guò)濾器參數(shù)

其他：

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

使用示例

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

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

pf_the_modal_title

基礎(chǔ)信息

名稱(chēng)：pf_the_modal_title
類(lèi)型：過(guò)濾器（filter）
作用：輸出（首頁(yè)）模塊標(biāo)題HTML

過(guò)濾器參數(shù)

類(lèi)型標(biāo)記可能的值：

其他：

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

使用示例

例：根據(jù)標(biāo)記組裝自定義標(biāo)題

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ǔ)信息

名稱(chēng)：pf_show_post_function
類(lèi)型：過(guò)濾器（filter）
作用：用于修改顯示文章卡片的方法（名）

過(guò)濾器參數(shù)

類(lèi)型標(biāo)記可能的值：

其他：

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

使用示例

文章分類(lèi)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ǔ)信息

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

過(guò)濾器參數(shù)

其他：

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

使用示例

除了點(diǎn)贊最多、評(píng)論最多、閱讀最多以外，增加一個(gè)自定義的Tab：

add_filter('pf_recommend_selectors',function($tobe_filtered){    $tobe_filtered[] = "自定義<b>Tab</b>";    return $tobe_filtered;});

注：真實(shí)使用場(chǎng)景除了增加選擇器按鈕外，還應(yīng)該增加Panel內(nèi)容，詳見(jiàn)pf_recommend_panels動(dòng)作鉤子

pf_frontpage_modal_query_args

基礎(chǔ)信息

名稱(chēng)：pf_frontpage_modal_query_args
類(lèi)型：過(guò)濾器（filter）
作用：首頁(yè)模塊數(shù)據(jù)查詢參數(shù)過(guò)濾

過(guò)濾器參數(shù)

類(lèi)型標(biāo)記可能的值：

其他：

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

使用示例

例：“大家喜歡”模塊在首頁(yè)設(shè)置成12篇文章

add_filter("pf_frontpage_modal_query_args",function($args, $type_id){    // 類(lèi)型標(biāo)記為-2是“點(diǎn)贊最多(大家喜歡)”    if ($type_id == -2) {        //修改查詢數(shù)量（參見(jiàn)WP_Query的參數(shù)說(shuō)明）        $args['posts_per_page'] = 12;    }    return $args;},10,2);

pf_frontpage_modal_query_result_ids

基礎(chǔ)信息

名稱(chēng)：pf_frontpage_modal_query_result_ids
類(lèi)型：過(guò)濾器（filter）
作用：首頁(yè)模塊數(shù)據(jù)查詢結(jié)果過(guò)濾

過(guò)濾器參數(shù)

類(lèi)型標(biāo)記可能的值：

其他：

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

使用示例

打亂首頁(yè)最新文章的id，讓顯示順序也隨機(jī)

add_filter('pf_frontpage_modal_query_result_ids',function($ids, $type_id){    // 類(lèi)型標(biāo)記為-1是“最新文章”    if ($type_id == -1) {        shuffle($ids);    }    return $ids;},10,2);

pf_the_modal_link

基礎(chǔ)信息

名稱(chēng)：pf_the_modal_link
類(lèi)型：過(guò)濾器（filter）
作用：輸出（首頁(yè)）模塊“閱讀更多”鏈接HTML

過(guò)濾器參數(shù)

類(lèi)型標(biāo)記可能的值：

其他：

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

pf_slider_type

基礎(chǔ)信息

名稱(chēng)：pf_slider_type
類(lèi)型：過(guò)濾器（filter）
作用：對(duì)slider輸出的類(lèi)型進(jìn)行過(guò)濾，默認(rèn)有card-flip和landscape兩種

過(guò)濾器參數(shù)

其他：

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

pf_slider_data

基礎(chǔ)信息

名稱(chēng)：pf_slider_data
類(lèi)型：過(guò)濾器（filter）
作用：對(duì)slider輸出的數(shù)據(jù)進(jìn)行過(guò)濾

過(guò)濾器參數(shù)

其他：

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