Joe2.0扩展包：Moss 使用文档
最新版本：1.2.3
上次更新：2022-4-27
最近更新：2022-5-6
🌈 简介
该扩展包新增如下功能：
- 使用闭包来提高数据安全性{/tabs-pane} {tabs-pane 版本1.0.x}- 使用支付宝当面付功能来配置文章打赏
- 自定义订单超时失效时间
- 三种打赏模式：二维码图片打赏、当面付打赏、共同使用
- 自定义当面付的打赏物品、金额、图片- 文章轮播图组件
- Gitee云盘下载按钮（从Joe1.0.10开始被合并）
- 页面访问数量统计
- 评论现在使用人机验证{/tabs-pane}
修复的版本问题：
- 后台
文章页 > 展示温馨提示开关失效的问题（Joe1.0.10已合并） - 文章页侧边栏
文章目录定位错误的问题
⌚️新增样式
🖼 轮播图组件
图片轮播组件是 1.0.7 版本推出的 Joe 标签组件，需要至少 2.0 版本的 Joe 主题才能生效。
<joe-swiper>图片链接1｜图片链接2｜图片链接3</joe-swiper>
组件参数
| 名称 | 参数 | 类型 | 默认值 | 作用 |
|---|---|---|---|---|
| 切换速度 | speed | Integer | 500 | 设置轮播图的切换速度，单位：毫秒(ms) |
| 切换间隔 | delay | Integer | 3000 | 设置轮播图切换的间隔时间，单位：毫秒(ms) |
| 图片比例 | scale | Float | 1.0 | 必须是原始图片的高÷宽得到的比例，用于不同尺寸的屏幕正常显示图片 |
| 切换效果 | effect | String | slide | 设置图片与图片之间的切换动画，必须为以下4种类型之一： slide fade cube coverflow |
| 轮播方向 | direction | String | horizontal | 设置轮播图的滚动方向，必须为以下2种类型之一： horizontal vertical |
| 循环播放 | loop | Boolean | false | 设置轮播图是否循环播放，若不想循环不需要填该项（不需要单独设置为"false"） |
| 拖拽滚动 | touch | Boolean | false | 设置轮播图是否可以通过鼠标拖拽进行滚动，若不想循环不需要填该项（不需要单独设置为"false"） |
| 上下页按钮 | button | Boolean | false | 设置是否显示上下页切换按钮，若不想循环不需要填该项（不需要单独设置为"false"） |
| 分页器 | pagination | Boolean | false | 设置是否显示分页器，若不想循环不需要填该项（不需要单独设置为"false"） |
一个简单的栗子：
<joe-swiper scale="0.547"
loop="true"
touch="true"
pagination="true">https://xxx.xxx/1.jpg｜https://xxx.xxx/2.jpg｜https://xxx.xxx/3.jpg</joe-swiper>
图片的超链接必须和组件标签写在同一行内，并且需要使用中文分隔符 ｜ 进行图片分割。
🔘 网盘按钮
已废弃。合并至Joe1.0.10版本中。
<joe-cloud type="gitee" title="" url="" password=""></joe-cloud>
🤔 功能配置
🍭 支付宝当面付
支付宝当面付功能是 1.0 版本推出的多元化打赏模式。
具体的"支付宝当面付打赏"功能展示可以在博客的任何一片文章下方找到。
“支付宝当面付”是支付宝提供的唯一一项不需要营业执照且税率最低的商家收款能力。申请者只需要提供门店照片（可以百度随便找一个）就可以申请“当面付”的签约能力，而且从申请到得到能力签约过程仅需3-5分钟。
参考下面的视频来获取支付宝当面付能力的 支付宝公钥 与 应用私钥，并将其配置在 后台设置 > 外观 > 主题设置 > 支付宝 中。保存后即可使用。
📊 页面统计
已废弃。合并至Joe1.0.10版本中。
页面统计是 1.0.7 版本推出的功能，将在页面底部显示累计访问、访客量、本页访问。
页面统计功能默认开启，使用 “不蒜子” 的脚本进行统计，后续可能会改进为本地存储统计。
🤖 人机验证
人机验证是 1.1.3 版本推出的功能，评论文章、留言板、日志均需要进行人机验证，防止评论机的恶意注入。
采用最朴素的方式（小学计算题）来拦截一些简单的机器人评论。灵感来自 “WordPress的Argon主题”
人机验证功能默认保持开启状态，启用开关将在大量测试结果没问题后推出。目前主要的功能如下：
- 未进行人机验证的将无法评论
- 人机验证计算结果错误的将需要重新验证
- 人机验证结果不会被本地存储协议存储
🍭其他指南
🐚 Gravatar镜像源更换
- (最快)Loli源 https://gravatar.loli.net/avatar/
- zeruns’s Blog的镜像源 https://gravatar.zeruns.tech/avatar/
- Gravatar官方www源 https://www.gravatar.com/avatar/
- Gravatar官方cn源 https://cn.gravatar.com/avatar/
- Gravatar官方en源 https://en.gravatar.com/avatar/
- Gravatar官方secure源 https://secure.gravatar.com/avatar/
- V2EX源 https://cdn.v2ex.com/gravatar/
- 极客族 https://sdn.geekzu.org/avatar/
🍿 MarkDown Mermaid构造错误
使用暴力解决方法。
- 进入
后台管理 > 外观 > 主题编辑。 - 找到文件
source/lib/mermaid@8.4.4/mermaid.min.js - 删除文件中所有内容即可。
📚 安装注意
- 在页面尾部通过 Gitee 下载扩展包
joe2.0-moss-master.zip压缩包； - 解压后将所有内容上传至您的服务器主题文件夹内并覆盖，一般位于
/root/.halo/templates/themes/joe2.0/； - 进入后台按照文档内容完成配置即可；
⭐️ 下载地址
📃 使用反馈
- Joe2.0样式指南：轻点以跳转
*受不可控因素Joe-moss暂停更新与维护，任何人可以以任何形式对本套源码进行修改、更新与维护，感谢您的支持。
评论区