在线募捐插件 使用说明

版本：1.0.07 · 适用于 Zsens Admin / 龙氏CMS 社区主题

一、插件简介

在线募捐插件为站点提供完整的募捐众筹功能，支持用户在线发起募捐项目、上传凭证图片、他人在线捐赠，以及管理员后台审核、手动建项、查看捐赠记录等。插件复用社区前台布局（页头/页脚），无需额外模板适配。

二、前台功能（用户端）

前台访问入口：/fundraising

1. 募捐列表页

• 展示所有已通过审核的募捐项目卡片，含封面图、标题、目标金额、已筹金额、进度条、捐赠人数。
• 顶部可显示站点公告（在插件配置中设置）。
• 点击「发起募捐」进入创建页面；点击项目卡片进入详情页。

2. 发起募捐

访问：/fundraising/create（需登录）

填写字段：

募捐详情结构化填写说明：

• 每项包含「事项标题」和「内容」两个部分。
• 默认 4 项：募捐事由与背景、资金用途说明、受助人/项目情况、承诺与反馈计划。
• 内容框的引导文字会根据标题自动匹配（如标题含「资金/用途」则提示填写费用明细）。
• 每项工具栏支持：

 - 插入图片：上传诊断证明、费用单据等凭证图片（支持 jpg/png/gif/webp）。

 - 加粗：选中文字后加粗。

 - 链接：插入超链接。

• 点击「新增一项」可添加任意分项；至少保留 1 项。

提交后：

• 若站点开启了「发起需审核」，项目进入「待审核」状态，管理员审核通过后展示。
• 若未开启审核，项目直接发布。

3. 项目详情与捐赠

访问：/fundraising/detail/{id}

• 展示封面、标题、目标/已筹金额、进度条、剩余时间、捐赠明细列表。
• 捐赠：输入金额、可选匿名、填写寄语，提交后生成支付订单。
• 支付成功后已筹金额与捐赠人数实时更新。

4. 我的募捐

访问：/fundraising/my（需登录）

• 查看自己发起的所有募捐项目及状态。

三、后台功能（管理员端）

后台入口：管理后台 → 募捐管理

1. 募捐项目管理

• 列表展示所有项目（含待审核、进行中、已结束、已拒绝）。
• 操作：查看详情、审核通过/拒绝、结束募捐、删除。

2. 手动新增募捐项目

点击列表页右上角「新增募捐」按钮，管理员可直接创建募捐项目：

• 填写标题、封面图、目标金额、截止时间、发布状态、详情。
• 发布状态可选：直接发布（进行中）、待审核、已结束。
• 管理员创建的项目无需审核，可直接发布上线。
• 详情支持 HTML 排版，可使用 <h3>、<p>、<img> 等标签。

3. 审核用户发起的项目

• 待审核项目可「通过」或「拒绝」，拒绝需填写原因。
• 通过后项目自动在前台展示。

4. 捐赠记录

• 查看全站所有捐赠记录，含捐赠人、金额、项目、时间、支付状态。
• 可删除异常记录。

四、插件配置

后台 → 插件管理 → 在线募捐 → 配置

五、主题站点名配置

前台页头/页脚显示的站点名由当前启用主题（LongsTheme）的「站点名称」配置项控制：

后台 → 主题设置 → 外观风格 → 站点名称

留空时默认显示「龙氏CMS」。

六、版本更新记录