一、插件核心介绍
文煞 VIP 插件是一款专为 Z-Blog 系统打造的专业会员管理解决方案，致力于帮助站长快速搭建完整的 VIP 会员体系，实现会员增值服务与付费转化。插件以 PHP 为开发语言，深度适配 Z-Blog 框架，具备多级会员管理、在线支付集成、数据统计分析等核心功能，通过简洁的操作界面与灵活的配置选项，满足个人站长、企业网站等不同场景的会员运营需求。
作为一款功能闭环的 VIP 管理工具，插件不仅支持支付宝、微信等主流支付方式，还提供了丰富的 API 接口供第三方插件调用，完美兼容各类用户中心插件与支付组件。其核心优势在于 "配置简单、功能全面、拓展性强"，无需复杂开发即可实现从会员等级设置、订单管理到权限控制的全流程运营，是 Z-Blog 生态中极具实用性的付费会员解决方案。
插件适用于内容付费网站、资源下载平台、在线服务站点等各类需要会员分级运营的场景，通过差异化的会员特权设置，帮助站长提升用户粘性与网站收益。目前插件版本为 2.5.1，已完成多次迭代优化，具备稳定的运行性能与完善的功能覆盖。
二、插件安装与环境要求
（一）环境配置要求
服务器环境：支持 PHP 5.6 及以上版本，兼容 PHP 7.x/8.x 主流版本
程序框架：Z-Blog 系统（适配版本号 173430 及以上）
依赖组件：需安装豫唐支付组件（支付功能核心依赖）
配套插件：建议搭配用户中心插件（如云希用户中心、X 用户中心等）使用
服务器权限：需开启数据库读写权限、文件上传权限
（二）安装步骤详解
插件获取与上传：从官方渠道下载插件安装包，解压后得到wensha_vip文件夹，通过 FTP 工具上传至 Z-Blog 网站的zb_users/plugin/目录下。
插件启用：登录 Z-Blog 后台，进入 "插件管理" 页面，找到 "文煞 VIP 用户组插件"，点击 "启用" 按钮。插件将自动执行数据表初始化与默认配置创建。
依赖组件安装：启用成功后，系统会提示安装豫唐支付组件，点击提示链接跳转至应用中心安装，若需使用易支付功能，需从官方指定渠道获取二开版本的豫唐支付组件。
安装验证：返回插件管理页面，若插件状态显示 "已启用"，且后台左侧菜单出现 "VIP 会员管理" 选项，即表示安装成功。
（三）卸载说明
如需卸载插件，可在后台插件管理页面点击 "卸载" 按钮，系统将自动删除插件相关数据表（包括会员等级表、用户 VIP 表、订单表、日志表）及配置信息。建议卸载前备份相关数据，避免重要信息丢失。
（四）下载方法
下载方法：关注公众号“文煞站长笔记网”，回复“015”进行下载！依赖插件豫唐支付组件，文煞二开版【豫唐支付组件】支持彩虹易支付，回复”016“进行下载！
三、核心功能配置教程
（一）基础设置：VIP 等级管理
VIP 等级是插件的核心配置项，支持自定义等级名称、价格、有效期及特权内容，具体操作如下：
进入管理后台：登录 Z-Blog 后台，点击左侧 "VIP 会员管理"，选择 "等级管理" 菜单。
等级配置项说明：
等级名称：填写会员等级名称（如 "月度 VIP"、"年度 VIP"），支持中文与特殊符号。
价格设置：输入会员价格（支持小数点后两位，单位为元），如 "29.00" 表示 29 元。
有效期设置：填写有效期天数（如 30 表示 1 个月，365 表示 1 年），同时设置显示文本（如 "1 个月"、"永久"）。
特权说明：每行输入一项特权，支持换行分隔（如 "高速下载权限"、"VIP 专属标识"）。
排序设置：设置等级显示顺序，数字越小排序越靠前。
状态控制：选择 "启用" 或 "禁用"，禁用后等级将不显示在前台。
推荐设置：勾选 "设为推荐套餐" 后，该等级将在前台突出显示。
新增与编辑：点击 "添加新等级" 可创建自定义等级，已创建的等级可通过编辑按钮修改配置，点击 "删除等级" 可移除不需要的等级（至少保留一个等级）。
默认等级：插件安装后自动创建三个默认等级（月度 VIP、年度 VIP、永久 VIP），可根据需求修改或删除。
（二）支付配置：对接支付渠道
插件集成支付宝与微信支付，需通过豫唐支付组件完成配置，步骤如下：
进入支付配置页面：在 VIP 会员管理菜单中选择 "支付配置"。
配置支付类型：
支付宝支付类型：默认值为 13（当面付），可根据豫唐支付组件的配置调整。
微信支付类型：默认值为 21（扫码支付），需与微信支付接口配置一致。
配置验证：页面将显示豫唐支付组件的状态，若显示 "支付插件可用"，表示配置正常；若显示 "支付插件未安装"，需重新安装豫唐支付组件。
易支付配置：若需使用易支付，需卸载标准版豫唐支付组件，从官方指定渠道（文煞笔记网、文煞站长网）下载支持易支付的二开版本并安装。
（三）用户管理：手动操作会员权限
管理员可手动为用户添加、延长或删除 VIP 权限，适用于赠送会员、售后处理等场景：
进入用户管理页面：选择 "用户管理" 菜单，可查看所有 VIP 用户列表。
筛选功能：通过 "有效 VIP"、"已过期" 筛选不同状态的会员，支持分页查看。
手动添加 VIP：
填写用户 ID：输入目标用户的 Z-Blog 用户 ID（可在用户管理中查询）。
选择 VIP 等级：从下拉菜单中选择对应的会员等级。
增加天数：输入需要添加的有效期天数（如 30 表示 1 个月）。
提交操作：点击 "添加 / 延长 VIP"，系统将自动更新用户的 VIP 状态。
删除 VIP 权限：找到目标用户，点击 "删除" 按钮，确认后将移除该用户的 VIP 权限（不可恢复）。
（四）订单管理：查看支付记录
订单管理功能支持查看所有 VIP 购买订单，包括订单号、用户信息、支付状态等，操作如下：
进入订单列表：选择 "订单管理" 菜单，可查看所有订单数据。
筛选功能：
按状态筛选：支持 "待支付"、"已支付"、"支付失败"、"已取消" 筛选。
按支付方式筛选：支持 "支付宝"、"微信" 筛选。
订单详情：列表将显示订单号、用户名、VIP 等级、金额、支付方式、创建时间、支付时间等信息，管理员可通过订单号追踪具体交易记录。
（五）数据统计：查看运营数据
统计页面提供 VIP 用户、订单、收入等核心数据的实时统计，帮助站长掌握运营情况：
核心数据指标：
VIP 用户总数：已开通 VIP 的用户总数。
有效 VIP 用户：当前处于有效期内的 VIP 用户数及占比。
总订单数：所有创建的 VIP 订单总数。
支付订单数：已完成支付的订单数及支付率。
收入统计：显示总收入、本月收入、今日收入（单位为元）。
系统信息：显示 VIP 等级数量、待支付订单数、操作日志数等系统状态数据。
数据刷新：点击 "刷新统计" 按钮可更新实时数据。
（六）日志管理：查看操作记录
日志功能记录插件的关键操作，便于问题排查与行为追溯：
进入日志页面：选择 "操作日志" 菜单，可查看所有操作记录。
筛选功能：支持按操作类型筛选（如 "插件安装"、"订单创建"、"VIP 更新" 等）。
日志详情：显示操作类型、标题、内容、IP 地址及操作时间，管理员可通过日志定位异常操作。
日志清理：点击 "清空日志" 按钮可删除所有日志记录（不可恢复）。
四、前台使用流程
（一）用户注册与登录
用户需先注册并登录网站账号（需搭配用户中心插件），未登录用户点击 VIP 相关链接时，系统将提示 "请先登录" 并跳转至登录页面。
（二）VIP 购买流程
进入 VIP 首页：通过网站前台的 "开通 VIP" 链接（或访问?wensha_vip=index）进入 VIP 套餐页面。
选择套餐：页面将展示所有启用的 VIP 等级，推荐套餐将突出显示，用户可查看各等级的价格、有效期及特权。
确认订单：点击 "立即开通" 按钮，进入订单确认页面，核对套餐信息、订单号及应付金额。
选择支付方式：选择 "支付宝支付" 或 "微信支付"，点击 "立即支付" 按钮。
完成支付：根据提示扫描二维码或跳转至支付页面完成支付，支付成功后系统将自动激活 VIP 权限。
（三）我的 VIP 管理
用户登录后可通过 "我的 VIP" 链接（或访问?wensha_vip=my）查看个人 VIP 状态：
VIP 状态展示：显示当前 VIP 等级、到期时间及剩余天数。
操作功能：支持开通新 VIP、升级现有等级、续费当前套餐。
购买记录：显示所有 VIP 订单的详细信息，包括订单号、套餐、金额、支付状态等。
五、插件拓展与开发接口
（一）主题模板集成
站长可在网站主题中集成 VIP 相关功能，实现个性化展示，常用代码如下：
添加 VIP 购买链接：
<a href="<?php echo $zbp->host; ?>?wensha_vip=index">开通VIP</a><a href="<?php echo $zbp->host; ?>?wensha_vip=my">我的VIP</a>
显示用户 VIP 身份：
$vip_info = check_vip($author->ID);if ($vip_info['code'] == 200) {
echo '<span class="vip-badge">' . $vip_info['level_name'] . '</span>';}显示 VIP 等级选择器：
function display_vip_levels_selector() {
$levels = wensha_vip_get_levels(true, true);
echo '<div class="vip-levels-selector">';
foreach ($levels as $level) {
echo '<div class="vip-level">';
echo '<h3>' . $level['name'] . '</h3>';
echo '<p class="price">¥' . $level['price'] . '</p>';
echo '<p class="duration">' . $level['duration_text'] . '</p>';
echo '<ul class="features">';
foreach ($level['features'] as $feature) {
echo '<li>' . trim($feature) . '</li>';
}
echo '</ul>';
echo '<a href="?wensha_vip=buy&level=' . $level['id'] . '" class="buy-btn">立即购买</a>';
echo '</div>';
}
echo '</div>';}（二）第三方插件调用接口
插件提供 4 个核心 API 接口，供其他插件调用 VIP 相关数据：
检查用户 VIP 状态：
$vip_status = check_vip($user_id);// 返回格式（VIP用户）array( 'code' => 200, 'level' => 1, 'level_name' => '月度VIP', 'expire_time' => 1735689600, 'remaining_days' => 25, 'message' => 'VIP用户有效');// 返回格式（非VIP用户）array( 'code' => 400, 'level' => 0, 'level_name' => '非VIP用户', 'expire_time' => 0, 'remaining_days' => 0, 'message' => '用户不是VIP或VIP已过期');
获取所有 VIP 等级：
// 获取所有启用的等级（包含特权） $levels = wensha_vip_get_levels(true, true); // 获取所有等级（包括禁用，不包含特权） $all_levels = wensha_vip_get_levels(false, false);
获取推荐等级：
$featured_levels = wensha_vip_get_featured_levels();
手动添加 VIP（管理员接口）：
$result = wensha_vip_manual_add_vip($user_id, $level_id, $add_days);
六、常见问题与注意事项
（一）常见问题排查
支付功能无法使用：
检查豫唐支付组件是否已安装并启用。
确认支付宝 / 微信支付类型配置正确。
易支付用户需使用二开版本的豫唐支付组件。
前台不显示 VIP 等级：
检查等级状态是否为 "启用"。
确认至少配置了一个 VIP 等级。
VIP 权限未激活：
检查用户支付是否成功（查看订单状态为 "已支付"）。
若支付成功但未激活，可手动更新用户 VIP 状态。
数据统计异常：
点击 "刷新统计" 按钮更新数据。
检查数据库连接是否正常。
（二）使用注意事项
数据备份：定期备份 VIP 相关数据表，避免数据丢失。
支付测试：首次使用时建议用小额金额测试支付流程，确认支付回调正常。
权限控制：管理员账号需妥善保管，避免未授权操作。
插件更新：及时更新插件到最新版本，获取新增功能与 bug 修复。
兼容性：确保用户中心插件与豫唐支付组件为最新版本，避免兼容性问题。
七、技术支持与资源获取
（一）官方资源
作者网站：https://www.wsbjw.cn（文煞笔记网）
推荐服务：文煞云https://www.wenshay.cn（提供免费虚拟主机、云服务器 VPS）
支付组件：豫唐支付组件（应用中心搜索安装）
易支付版本：通过文煞笔记网、文煞站长网或微信公众号 "文煞站长笔记网" 获取。
（二）技术支持
如需技术帮助，可访问官方网站查看帮助文档，或通过以下渠道获取支持：
文煞笔记网：https://www.wsbjw.cn
文煞站长网：https://www.wszzw.cn
插件提供完善的功能闭环与灵活的拓展能力，通过本教程的配置与操作，站长可快速搭建专业的 VIP 会员体系，实现网站的商业化运营与用户价值提升。建议结合自身网站定位，合理设置会员等级与特权，打造差异化的会员服务，提升用户付费意愿与忠诚度。
