pf_header
基礎信息
名稱:pf_header
類型:動作(action)
作用:頁面頂部內容鉤子
使用示例
去除主題自帶的頂部圖片,并添加自定義HTML內容
remove_action("pf_header","pf_header_image");
add_action("pf_header",function(){
echo "自定義HTML內容";
});
pf_main_column{$suffix}
基礎信息
名稱:pf_main_column{$suffix}
類型:動作(action)
作用:頁面內容鉤子,用于顯示頁面主要部分(main)的內容
$suffix根據當前頁面而變化,命名規則如下:
動作名 | 所在頁面 |
---|---|
pf_main_column_home | 主題首頁 |
pf_main_column_taxonomy(category) | 文章分類頁 |
pf_main_column_taxonomy(post_tag) | 文章Tag頁 |
pf_main_column_taxonomy(gallery-category) | 相冊分類頁 |
pf_main_column_taxonomy(gallery-tag) | 相冊Tag頁 |
pf_main_column_taxonomy(faq-category) | 常見問題分類頁(未使用) |
pf_main_column_taxonomy(favlinks-category) | 友情鏈接分類頁(未使用) |
pf_main_column_single(post) | 文章內容頁 |
pf_main_column_single(gallery) | 相冊內容頁 |
pf_main_column_single(faq) | 常見問題內容頁(未使用) |
pf_main_column_single(favlinks) | 友情鏈接內容頁(未使用) |
pf_main_column_page(default) | 頁面(默認頁面模板) |
pf_main_column_page(blank) | 頁面(空白無邊欄頁面模板) |
pf_main_column_page(timeline) | 頁面(全部文章列表模板) |
pf_main_column_404 | 404頁 |
pf_main_column | 除上述外的所有其他情況 |
- 所有的動作名可在:R\assets\templates 中查看文件夾名。每個文件夾名稱就是動作。
- 文件夾內的php文件,就是該動作名自動加載的鉤子。文件名前面的數字是優先級。
- 所有的鉤子均以文件名作為方法名保存在全局變量 $pf_page_contents 中
例如: R\assets\templates 路徑中有 pf_top_nav 文件夾,該文件夾中有名為 30.pf_top_nav_music_player.php 文件夾,則表示:
1、主題默認在 pf_top_nav 動作添加了鉤子
2、pf_top_nav 鉤子執行了 30.pf_top_nav_music_player.php 文件的內容,且優先級是30
3、這個方法在 $pf_page_contents[‘pf_top_nav_music_player’] 中存在(因此,若不需要這個鉤子,也可以使用remove_action移除它)
注:$suffix后綴會因pf_page_suffix
過濾器而改變
使用示例
例1:在404頁面顯示“404圖片”
add_action('pf_main_column_404',function(){
echo "<img src='url_of_404.jpg' />";
});
pf_static_nav
基礎信息
名稱:pf_static_nav
類型:動作(action)
作用:固定在頂部的導航條中內容鉤子
使用示例
移除默認菜單內容,并增加自定義文字
remove_action('pf_static_nav','pf_static_nav_menu');
add_action('pf_static_nav',function(){
echo "自定義內容";
});
pf_slider_nav
基礎信息
名稱:pf_slider_nav
類型:動作(action)
作用:滾動圖上方的菜單內容
使用示例
移除默認菜單內容,并增加自定義文字
remove_action('pf_slider_nav','pf_slider_nav_menu');
add_action('pf_slider_nav',function(){
echo "自定義內容";
});
pf_before_widgets
基礎信息
名稱:pf_before_widgets
類型:動作(action)
作用:可切換邊欄上方的固定內容
使用示例
移除邊欄上方的博主展示,并增加自定義文字
remove_action('pf_before_widgets','pf_the_blogger');
add_action('pf_before_widgets',function(){
echo "<p>自定義內容</p>";
});
pf_after_widgets
基礎信息
名稱:pf_after_widgets
類型:動作(action)
作用:可切換邊欄底部的固定內容
使用示例
增加自定義文字
add_action('pf_after_widgets',function(){
echo "自定義文本";
});
pf_recommend_panels
基礎信息
名稱:pf_recommend_panels
類型:動作(action)
作用:文章推薦模塊(點贊最多、評論最多、閱讀最多)的顯示切換內容
主題默認的優先級:
優先級 | 內容 |
---|---|
10 | 點贊最多(大家喜歡) |
20 | 評論最多(熱門討論) |
30 | 閱讀量最多(閱讀最多) |
使用示例
增加一個自定義內容
add_action("pf_recommend_panels",function(){
echo '<div class="row post-card-row">';
echo '<b>我的自定義內容</b>';
echo '</div>';
},40);
注:真實使用場景除了增加Panel內容外,還應該增加選擇器按鈕,詳見pf_recommend_selectors
過濾器鉤子。
pf_after_the_slider
基礎信息
名稱:pf_after_the_slider
類型:動作(action)
作用:在執行完slider滾動圖輸出后,關閉slider標簽前執行這個鉤子。用于輸出其他自定義內容。
參數
# | 類型 | 備注 |
---|---|---|
1 | String | 滾動圖類型(主題默認有landscape和card-flip) |
2 | Array | 滾動圖數據 |
使用示例
若添加了自定義post_type,在新的taxonomy中需要根據需求輸出。此時根據自己的要求輸出數據即可