B2Pro主题常用钩子函数合集

B2主题钩子完整列表

概述

B2主题提供了非常丰富的钩子系统，总共包含140+个钩子，分为Action钩子和Filter钩子两大类。这些钩子覆盖了页面结构、内容类型、用户行为、数据处理和系统功能等各个方面，开发者可以通过这些钩子在不修改主题核心文件的情况下，灵活地扩展和自定义B2主题的功能。

一、页面结构相关钩子 (Action Hooks)

1. 头部和页面框架钩子

2. 首页相关钩子

二、归档页面钩子 (Archive Pages)

1. 通用归档钩子

2. 问答页面钩子

3. 商城页面钩子

三、单页面钩子 (Single Pages)

1. 通用单页面钩子

2. 问答单页面钩子

3. 文档单页面钩子

四、商城相关钩子

1. 商城列表钩子

2. 商城分类钩子

3. 商城购买页面钩子

4. 商城单页面钩子

五、用户行为相关钩子 (User Actions)

1. 用户登录注册钩子

2. 问答相关钩子

3. 圈子相关钩子

4. 评论相关钩子

5. 其他用户行为钩子

六、数据处理相关钩子

1. 积分系统钩子

2. 消息系统钩子

3. 订单系统钩子

4. 其他数据钩子

七、过滤器钩子 (Filter Hooks)

1. 核心功能过滤器

2. 数据处理过滤器

3. 圈子相关过滤器

4. 内容处理过滤器

5. 配置相关过滤器

6. 安全相关过滤器

八、使用示例

Action钩子使用示例

// 在页面头部添加自定义内容
add_action('b2_header', function() {
    echo '自定义头部内容';
}); 

// 用户登录时执行自定义操作 
add_action('b2_user_login', function($user_id) {
    // 记录登录日志
    error_log("用户 {$user_id} 登录了");
}); 

// 在单页面内容之前添加广告 
add_action('b2_single_content_before', function() {
    echo '广告位';
}); 

Filter钩子使用示例

// 修改上传路径
add_filter('b2_upload_path_arg', function($path) {
    return $path . '/custom/';
}); 

// 自定义文本审查 
add_filter('b2_text_censor', function($text) {
   // 替换敏感词 
   return str_replace('敏感词', '***', $text);
}); 

// 修改圈子设置 
add_filter('b2_get_circle_setting_by_id', function($settings, $circle_id) { 
    // 自定义圈子设置 
    $settings['custom_option'] = 'custom_value';
    return $settings; 
}, 10, 2);