子比主题「首页用户列表小工具」超详细使用教程

本文适合所有使用子比（zibll）主题的WordPress站长，无论你是新手还是有一定基础，跟着步骤走就能轻松搞定「首页用户列表小工具」的安装、设置与使用。该工具核心功能是在网站首页展示「新朋友」和「尊贵VIP」两类用户，支持分类切换，自带美观样式，能有效提升网站互动感和用户曝光度。

一、工具核心亮点提前看

• 双分类展示：自动区分「最新注册用户（新朋友）」和「VIP用户」，支持鼠标悬浮/点击切换；
• 自适应布局：完美适配PC端、平板、手机等所有设备，无需额外调整样式；
• 原生兼容子比：基于子比主题开发，无兼容性问题，加载速度快；
• 支持数量调整：可自定义展示的用户数量，适配不同网站的用户规模。

二、第一步：部署小工具文件

这一步的核心是把小工具文件放到网站正确的目录下，操作很简单，跟着来就行：

1. 登录你的网站主机后台（或通过FTP工具连接网站根目录）；
2. 找到子比主题根目录（通常是/wp-content/themes/zibll），在根目录下创建/xiaogongju/widgets/文件夹，再在「widgets」文件夹内创建「widgets-user.php」文件文件（最终路径：子比主题根目录/xiaogongju/widgets/widgets-user.php）；
3. 将下面的小工具代码复制到到「widgets-user.php」文件内。

第二步：关联子比主题（修改func.php文件）

部署好文件后，需要让子比主题识别并加载这个小工具，关键是修改主题根目录的「func.php」文件：

1. 在主机后台/FTP中，找到子比主题根目录（路径：网站根目录/wp-content/themes/zibll/）；
2. 找到「func.php」文件（没有就创建一个），右键选择「编辑」；
3. 在「func.php」文件的末尾，添加以下代码：

$widgets_files = array(
   'widgets-user.php',  /*小工具文件名*/
);

foreach ($widgets_files as $file) {
    require get_template_directory() . '/xiaogongju/widgets/' . $file;
}
/*上面代码请勿删除，否则不能正常使用*/

1. 保存「func.php」文件。

四、第三步：在后台启用并设置小工具

文件关联完成后，就可以在WordPress后台启用小工具并自定义设置了：

1. 启用小工具

1. 登录你的WordPress后台（地址：你的域名/wp-admin/）；
2. 进入「外观」→「小工具」页面；
3. 在左侧的小工具列表中，找到名为「首页用户列表」的小工具；
4. 点击小工具，选择要展示的位置（推荐：「首页内容区」或「首页侧边栏」，根据你的网站布局选择），再点击「添加 widget」；
5. 添加完成后，右侧对应区域会显示「首页用户列表」小工具，点击展开设置面板。
6. 设置完成后，点击「保存」按钮，小工具就会在前端生效啦！

五、前端效果与核心功能说明

启用后，前端会显示以下效果，核心功能可以这样用：

1. 分类切换：鼠标悬浮或点击「新朋友」「尊贵VIP」按钮，可切换展示对应的用户列表（默认优先显示「新朋友」）；
2. 用户点击：点击用户头像或用户名，会直接跳转到该用户的个人主页；
3. 滚动查看：若用户数量较多，横向滚动鼠标即可查看全部用户；
4. 视觉标识：小工具右上角会显示「榜上有名」角标，提升视觉焦点。

六、进阶技巧：调整展示用户数量

默认情况下，小工具会各展示13个「新朋友」和「VIP用户」，若想调整数量，可按以下步骤修改：

1. 在主机后台/FTP中，找到「widgets-user.php」文件，右键编辑；
2. 查找以下2段代码（可使用「Ctrl+F」搜索关键词）：
3. 新朋友数量代码：$lzj1=$wpdb->get_results("SELECT user_id FROM $wpdb->usermeta where meta_key='nickname' order by user_id desc limit 13");
4. VIP用户数量代码：$lzj2=$wpdb->get_results("SELECT user_id FROM $wpdb->usermeta where meta_key='vip_level' and meta_value='1' or meta_key='vip_level' and meta_value='2' order by user_id desc limit 13");
5. 将代码中的「limit 13」修改为你需要的数量（如limit 8、limit 10）；
6. 保存文件，刷新网站前端即可生效。

提示：用户数量建议根据你的网站宽度调整，PC端首页内容区建议设置8-12个，侧边栏建议设置4-6个，避免换行影响美观。