首页>文档>B2相关问题>B2主题二开>B2首页自定义模块与短代码开发

B2首页自定义模块与短代码开发

一、首页模块管理

B2 首页由”模块管理”驱动,后台-主题设置-模块管理-首页 中可以添加幻灯、文章、专题、商品、搜索、自定义 HTML 等模块,模块可自由排序、设置可见性与小工具跟随滚动。

二、添加自定义 HTML 模块

1. 后台-模块管理-首页,点击”添加新模块”。

2. 调用内容选择”自定义”,粘贴 HTML 代码(例如六格首页菜单栏、推荐作者模块等)。

3. 保存后回到首页刷新即可看到效果。

三、短代码开发

如果希望模块或文章正文中调用动态数据(如最新文章、热门资源),可以注册短代码:

Text
<?php
add_shortcode( 'jitheme_hot', function( $atts ) {
    $atts = shortcode_atts( array( 'num' => 5 ), $atts );
    $q = new WP_Query( array(
        'posts_per_page' => (int) $atts['num'],
        'orderby'        => 'comment_count',
    ) );
    $html = '<ul class="jitheme-hot">';
    while ( $q->have_posts() ) {
        $q->the_post();
        $html .= '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
    }
    wp_reset_postdata();
    return $html . '</ul>';
} );

文章或自定义 HTML 模块中直接写 [jitheme_hot num="6"] 即可调用。

四、首页区块示例:六格菜单栏

纯 HTML/CSS 的首页区块可以作为自定义模块使用,效果类似门户网站的分类导航,适合引导用户进入核心栏目。

五、注意事项

1. 自定义模块为纯 HTML 时无法后台控制数据,需要动态数据请使用短代码或 PHP 函数。

2. 短代码内使用 WP_Query 后记得 wp_reset_postdata(),避免影响后续循环。

3. 模块可见性可以设置按用户等级显示,适合会员引导场景。

签到成功