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中需要根据需求输出。此时根据自己的要求输出数据即可