快速上手
上传 → 启用 → 填授权码,三步即可上线安装与启用
- 备份升级前先备份现有模板目录与数据库,出问题可直接回滚。
- 上传模板把 PureBlog 目录整体上传到
网站根目录/content/templates/PureBlog/(覆盖同名文件)。 - 启用模板后台「外观 → 模板」中启用 PureBlog。
- 启用设置插件确保 EMLOG 的「模板设置」插件(tpl_options)已启用,否则后台不会出现「外观 → 模板设置」入口。
- 填写授权码进入「外观 → 模板设置 → 授权设置」,粘贴授权码并保存;状态卡片会立即联网校验并绑定当前域名。
- 建站日期在「页脚 · 数据条」里填写建站日期,页脚的「运行天数」才会显示。
- 清缓存EMLOG 后台「系统 → 缓存管理」清一次缓存,前台即可看到最新样式。
功能总览
前台实际能力(逐项对照源码核对)顶栏与导航
固定毛玻璃顶栏,桌面端与移动端两套导航形态。
- 固定毛玻璃顶栏
- 滚动时始终吸顶,半透明模糊背景 + 描边,内容穿过顶栏下方滚动。
- 站点 LOGO 两种形态
- 文字 LOGO(自动取站点名称首字做成渐变徽标)或图片 LOGO,后台一键切换。
- 主导航 + 二级下拉
- 读取后台「导航」设置;含子分类或子导航的菜单项自动出现下拉箭头与悬浮面板。
- 搜索面板
- 点击顶栏搜索按钮下拉展开,直接提交到 EMLOG 核心搜索(index.php?keyword=),移动端则在抽屉导航内置搜索框。
- 深浅色切换
- 顶栏搜索按钮右侧的月亮 / 太阳按钮,一键切换浅色与深色;选择结果同时写入 cookie 与 localStorage。
- 用户入口按角色分流
- 未登录显示「登录」(弹出登录框);管理员/编辑/写手显示「后台管理」;普通注册用户显示「会员中心」(需 pb_member 插件)。
- 移动端抽屉导航
- ≤1024px 时主导航收起为侧滑抽屉,点击汉堡按钮展开,点击遮罩或按 ESC 关闭,按钮带 aria-expanded 状态。
- 跳到主要内容
- 页面第一个可聚焦元素是「跳到主要内容」链接,键盘 / 读屏用户可跳过顶栏直接到正文。
首页与列表页
首页焦点图 + 左图右文卡片列表,支持分类、标签、归档、搜索等所有 EMLOG 列表型页面。
- 首页轮播图
- 后台按「图片地址|标题|链接」逐行填写;仅首页显示,支持左右箭头、圆点指示器、自动播放。
- 左图右文卡片
- 封面在左、标题/摘要/元信息在右;窄屏自动堆叠为上下结构。
- 封面图三级取值链
- ① 后台设置的封面图 → ② 自动提取正文首图(兼容懒加载写法与相对路径,自动跳过占位图)→ ③ 网络兜底图(按文章 ID 固定,篇篇不同)。
- 卡片元信息
- 作者头像(带认证角标)、作者会员等级勋章、发布时间、阅读数、评论数;标签可按开关隐藏。
- 置顶标志
- 后台设为置顶的文章在首页标题前显示「置顶」,分类页顶部文章显示「分类置顶」。
- 空状态页
- 没有内容时输出图标 + 文案 + 「回到首页」按钮,不留白屏。
- 分页
- 沿用 EMLOG 分页结构,上一页 / 下一页带箭头图标;开启翻页特效后点击有横向滑动过渡。
文章详情页 / 独立页面
顶部大图 + 面包屑 + 作者栏 + 正文 + 标签 + 版权声明的完整阅读版式。
- 顶部大图与面包屑
- 可选顶部大图(面包屑与标题叠加在图上,带遮罩保证文字可读);关闭后面包屑回到标题上方,不留空位。
- 正文首图去重
- 顶部大图取自正文首图时,自动把正文里那张重复的图(含包裹它的链接与空段落)隐藏,避免一张图出现两次。
- 作者信息栏
- 头像(带认证角标与悬停认证名称)、作者名、会员等级勋章、发布时间;右侧显示字数统计与预估阅读时长。
- 字号调节
- 正文右上角的 A− / A / A+ 三个按钮,读者可即时放大缩小正文字号,也可一键恢复默认。
- 全屏阅读
- 「全屏显示」按钮进入浏览器全屏,沉浸式阅读,再点一次退出。
- 点赞 / 收藏 / 关注作者
- 需 pb_member 会员中心插件。未登录点击会提示先登录;浏览自己的文章时不显示「关注作者」按钮。
- 标签与附件
- 正文下方输出文章标签链接组;文章带附件时显示 EMLOG 的附件下载项。
- 版权声明
- 后台按「标签|内容」逐行自定义,支持 {author}、{title}、{site}、{url} 变量;含 {url} 的那一行可点击复制本文链接。
- 上一篇 / 下一篇
- 卡片式上下篇导航,已到第一篇或最后一篇时显示占位文案而不是消失。
- ••• 管理菜单
- 仅作者本人或有后台权限的用户可见,菜单含「修改文章 / 后台修改 / 删除文章」,删除走 EMLOG 的 CSRF token 校验并默认移入草稿箱。
- 结构化数据与 SEO
- 正文使用 schema.org Article 微数据,head 输出 canonical、keywords、description、Open Graph、Twitter Card 与 robots,并带 RSS 订阅链接。
评论区
自带表情面板与楼层、徽章的评论列表,兼容 EMLOG 核心评论接口。
- 表情面板
- 内置「表情 / 手势 / 生活 / 动物」四组共 90+ 表情,可后台追加自定义 emoji 或图片表情(图片表情插入 [img] 标签)。
- 工具条
- 表情按钮 + 加粗按钮 + 实时字数计数(上限 500 字)。
- 快捷提交
- Ctrl + Enter(Mac 为 ⌘ + Enter)直接提交评论。
- 楼层号
- 顶级评论右侧显示 #1、#2 …,子评论不编号。
- 作者 / 会员徽章
- 文章作者显示蓝色「作者」徽章,其他注册用户显示绿色「会员」徽章;会员等级勋章紧随昵称。
- 待审核标记
- 未通过审核的评论显示「待审核」标签,方便自己预览。
- 回复与取消
- 每条评论可点击「回复」,输入框自动带上被回复者昵称与父级 ID,并出现「取消回复」按钮。
- 游客表单
- 昵称 / 邮箱 / 网址三栏(网址栏可后台关闭)+ 图形验证码;站点开启「登录后才能评论」时改为提示先登录。
- 关闭评论提示
- 文章关闭评论时显示带图标的提示条,而不是把整个表单藏掉造成困惑。
- 评论分页
- 评论超过设定条数时输出分页导航,并同样受翻页特效影响。
侧边栏组件(12 类)
全部在后台「外观 → 侧边栏管理」中拖拽排序、改名、开关。
- 站长名片
- 站长头像(带认证角标)、昵称、简介与文章/评论/标签三项统计,底部按登录状态显示「登录 / 注册」或「后台管理 / 会员中心 + 退出登录」。
- 搜索
- 独立搜索框组件,与顶栏搜索同源。
- 最新文章
- 按发布时间倒序,条数取后台「首页显示文章数」设置,右侧显示友好时间(如「3 天前」)。
- 热门文章
- 按阅读量排序,前三名带名次高亮,可选显示缩略图与阅读数。
- 标签云
- 读取全部标签,悬停显示该标签的文章数。
- 分类
- 支持二级分类缩进显示,右侧显示各分类文章数。
- 文章归档
- 按月份归档,右侧显示每月文章数。
- 友情链接
- 读取后台「链接」管理,支持链接图标,自动带 nofollow。
- 最新评论
- 显示评论者头像(带认证角标)与会员勋章,点击直达该评论。
- 日历
- EMLOG 日历组件,异步加载不阻塞页面。
- 微语
- 最新碎语列表,含作者、等级勋章与发布时间。
- 自定义 HTML
- 后台上传的任意 HTML 片段(广告位、统计代码等)。
页脚
数据条 → 简介/备案 → 联系方式 → 友情链接 → 导航链接与版权,五段式可分别开关。
- 站点数据条
- 两种布局(整条等分栅格 / 独立圆角卡片),可选波浪流光动效;文章、评论、标签、友链四项自动统计,「运行天数」按后台填写的建站日期计算。
- 数据项自定义图标
- 五项数据都支持后台上传 1:1 透明 PNG 替换内置线性图标。
- 页脚风格
- 卡片风格(圆角留白)或通栏风格(整幅背景)一键切换。
- 站点简介栏
- 站点名 + 多行简介,留空时自动回退到后台的站点名称与站点描述。
- 备案信息
- ICP 备案号自动链接工信部查询页,公安备案号自动链接公安部查询页,两者可分别开关,图标可自定义。
- 免责声明
- 多行版权/免责文案,可开关,图标可自定义。
- 联系方式栏
- 微信、QQ、邮箱、微博、哔哩哔哩、GitHub 六个内置平台各自独立开关;微信/QQ 上传二维码后鼠标悬停弹出二维码气泡,图标形状可选圆形 / 圆角方形 / 无背景。
- 自定义平台
- 无限追加:格式「名称|图标|链接|二维码|颜色类」,图标可填内置图标键或图片地址,颜色类可选 8 种。
- 友情链接区块
- 两种布局(胶囊并排 / 网格分栏)、新窗口打开、nofollow 三个开关;数据来自后台「链接」管理,无链接时整块自动隐藏。
- 页脚导航链接
- 后台按「链接文字|链接地址」逐行添加。
- 作者署名
- 默认显示 Theme by nswin.cn,文案可自定义(支持 {author}、{url} 变量与 HTML)。
- 返回顶部
- 滚动超过一屏后右下角浮出按钮,点击平滑回顶。
- 页脚附加内容
- 支持 HTML,可放统计代码、站点说明等。
会员体系联动(pb_member 插件)
安装配套的「PureBlog 会员中心」插件后自动生效;未安装时模板全部功能照常,只是不显示这些会员元素。
- 会员等级勋章
- 昵称后显示等级勋章:后台上传过等级图标则显示图标,否则回退为彩色等级名徽章。
- 认证角标
- 已认证会员头像右下角显示认证标志,标志图可在插件后台上传。
- 认证名称气泡
- 鼠标移到已认证会员头像上浮出认证名称气泡,可在「特效设置」里整体关闭。
- 点赞 / 收藏 / 关注作者
- 文章页操作条,状态与计数实时同步,数据接口由插件提供。
- 会员中心入口
- 顶栏、导航菜单、站长名片的用户入口按角色自动分流到会员中心(/?plugin=pb_member)。
动效与交互
三类前台动效各自独立开关,追求极致性能可全部关闭。
- 淡入特效
- 列表卡片、侧边栏组件、正文与评论区滚动进入视口时逐个淡入上浮,首屏内容依次浮现。
- 翻页特效
- 点击上一页/下一页/页码时内容区按方向横向滑动淡出,顶部显示进度条;列表分页与评论分页同时生效。
- 打开文章特效
- 点击列表卡片时卡片轻微放大浮起、其余卡片淡出,再进入文章页;Ctrl / 中键 / 新窗口打开等操作不受影响。
- 无脚本与减弱动效兜底
- 浏览器禁用 JS 时用 1.5 秒超时自动撤掉初始隐藏(内容一定可见),并附
- 登录 / 注册弹窗
- 点击「登录」不再跳页,弹出模态框内 AJAX 提交;支持登录验证码、注册邮箱验证码、记住登录状态与「忘记密码」入口,验证码图片懒加载以避免两个面板互相覆盖。
设置项说明
后台「外观 → 模板设置」,共 11 组 / 95 项PureBlog/options.php 自动解析生成,与后台设置页完全一致;模板升级后本节会随代码同步更新,不必担心文档过时。授权设置
模板授权码与授权服务器参数。未通过正版校验时,前台整站跳转到未授权提示页(内含购买入口与授权码输入框)。
https://api.woes.cn/api.php,应用标识默认 pureblog。四个参数都需要与授权管理端「系统设置」保持一致,否则会返回「应用标识不匹配 / 签名错误」。前台打开时读取本地缓存判定是否正版,缓存超过 10 秒就在请求结束后联网复查一次(文件锁保证高并发下同一时刻只有一个请求联网,访客永远不等授权服务器);连不上服务器时最多 7 天沿用上次成功结果。| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 授权码licenseKey | 文本 | 留空 | 粘贴授权码后保存即会立即联网校验并绑定当前域名。上方状态卡片由模板自动输出:点击「立即重新检测」在卡片内异步刷新,不刷新页面、不跳转、不改地址栏。 |
| 授权 API 地址licenseApi | 文本 | https://api.woes.cn/api.php | 授权管理端 api.php 的完整地址。填到目录也可以(如 https://api.woes.cn),模板会自动补上 /api.php。默认 https://api.woes.cn/api.php;把授权管理端装在别处时改这里即可。 |
| 应用标识licenseApp | 文本 | pureblog | 必须与授权管理端「系统设置 → 应用标识」一致,否则校验会返回「应用标识不匹配」。 |
| 通信密钥licenseSecret | 文本 | PB2026-PureBlog-Woes-Default-Secret | 用于给每次校验请求签名,必须与授权管理端「系统设置 → 通信密钥」完全一致。 在管理端重新生成密钥后,请同步更新这里。 |
品牌与识别
站点 LOGO、站点图标、社交分享封面与深浅色配色方案。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 站点 LOGO 类型logotype | 单选 文字 LOGO(取站点名称首字) 图片 LOGO | 1 | 选择「图片 LOGO」时请在下方上传 LOGO 图片。 |
| LOGO 图片logoimg | 图片 后台上传图片 | 留空 | 建议高度 40px 左右的透明背景 PNG。 |
| 站点图标(favicon)favicon | 图片 | 留空 | 留空则使用站点根目录下的 favicon.ico。 |
| 社交分享封面图og_image | 图片 | 留空 | 微信 / 微博等平台分享时展示的缩略图,建议 1200×630。 |
| 显示暗黑模式切换按钮themeToggle | 开关 开启 | 开启(默认) | 按钮位于顶部导航栏「搜索」按钮之后,读者可自行切换深浅色。 |
| 默认配色模式themeDefault | 单选 跟随系统 始终浅色 始终深色 | auto | 读者手动切换后会记住选择,下次访问优先使用其记忆值。 |
首页设置
首页轮播图与列表卡片的标签显示。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 首页轮播图slideShow | 多行文本 | 留空 | 每行一条,格式:图片地址|标题|链接(例:https://xxx/a.jpg|站点公告|https://xxx/post-1.html),留空则不显示轮播。 |
| 列表显示文章标签showListTags | 开关 开启 | 开启(默认) | 关闭后首页列表只显示标题、摘要与元信息。 |
文章设置
文章详情页的顶部大图、封面图取值链、版权声明与评论表单选项。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 详情页显示顶部大图isShowCover | 开关 开启 | 开启(默认) | 文章详情页 / 独立页顶部展示大图(面包屑叠加在图上)。图片按下方「封面图来源」的顺序自动获取。 |
| 封面图来源 ①:自动提取正文首图coverFromContent | 开关 开启 | 开启(默认) | 文章未单独设置封面图时,自动取正文里的第一张图片作为封面(兼容懒加载写法与相对路径,自动跳过占位图)。 |
| 封面图来源 ②:网络图片兜底coverNet | 开关 开启 | 开启(默认) | 正文里也没有图片时,自动使用网络图片,保证每篇文章都有封面。 |
| 网络图片图源coverNetPreset | 单选 Picsum 稳定随机图(按文章 ID 固定,篇篇不同) 必应每日一图(全站当天同一张,第三方接口) 自定义接口(在下方填写) 不使用网络图片 | picsum | 按需选择。默认图源为 https://picsum.photos/seed/pureblog{id}/1200/675;若服务器或访问环境无法访问该图源,可改为「必应每日一图」或使用自己的随机图接口。 |
| 网络图片 · 自定义接口coverNetCustom | 文本 | 留空 | 仅在「网络图片图源」选择「自定义接口」时生效,需返回图片本身(可 302 跳转)。 可用占位符: {id} 文章 ID、{title} 文章标题(已 URL 编码)。例: https://picsum.photos/seed/{id}/1200/675 |
| 列表卡片也使用网络兜底图coverNetInList | 开关 开启 | 开启(默认) | 关闭后,未设置封面且摘要里没有图片的文章,在首页 / 分类页列表中显示为纯文字卡片。 |
| 顶部大图与正文首图去重coverDedupe | 开关 开启 | 开启(默认) | 顶部大图自动取自正文首图时,自动隐藏正文里那张重复的图(含包裹它的链接),避免同一张图出现两次。 |
| 显示版权声明showCopyright | 开关 开启 | 开启(默认) | 在正文底部展示版权声明与原文链接。 |
| 版权声明 · 逐行内容copyrightRows | 多行文本 | 本文作者|{author} 本文链接|{url} 版权声明|本博客所有文章除特别声明外,均默认采用 CC BY-NC-SA 4.0 许可协议。 | 每行显示一条。格式:标签|内容(标签末尾会自动补「:」),留空的行不显示。可用变量: {author} 作者名、{title} 文章标题、{site} 站点名、{url} 本文链接(自动取当前文章地址)。内容里用到 {url} 的那一行会自动变成可点击复制的本文链接;内容支持 HTML(如加粗)。 |
| 版权声明 · 本文链接可点击复制copyrightCopy | 开关 开启 | 开启(默认) | 开启后鼠标悬停「本文链接」会显示「复制本文链接」提示,点击即复制到剪贴板。 |
| 评论区允许填写网址isAllowCommentUrl | 开关 开启 | 开启(默认) | 关闭后游客评论表单不再显示网址输入框。 |
评论设置
评论表情面板、输入框提示语、楼层号与作者/会员徽章。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 显示评论表情面板commentEmoticon | 开关 开启 | 开启(默认) | 在评论输入框上方显示「表情」按钮,点击弹出表情面板(内置表情 / 手势 / 生活 / 动物四组)。 |
| 自定义表情emoticonCustom | 多行文本 | 留空 | 每行一个。可以直接写 emoji(如 🎉),也可以写「名称|图片地址」使用图片表情(会插入 [img] 标签)。 示例: 🎉 或 滑稽|https://xxx.com/1.png |
| 评论输入框提示语commentPlaceholder | 文本 | 说点什么…(支持 Ctrl + Enter 提交) | 留空则使用默认提示语。 |
| 显示评论楼层号commentFloor | 开关 开启 | 开启(默认) | 在顶级评论右侧显示 #1、#2 楼层号。 |
| 显示作者 / 会员徽章commentBadge | 开关 开启 | 开启(默认) | 文章作者显示蓝色「作者」徽章,其他注册用户显示绿色「会员」徽章。 |
特效设置
淡入、翻页、打开文章三类动效开关,以及头像悬停认证名称气泡。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 淡入特效effectFade | 开关 开启 | 开启(默认) | 列表卡片、侧边栏组件、正文与评论区在滚动进入视口时逐个淡入上浮,首屏内容依次浮现。 读者系统若开启「减弱动态效果」,本特效会自动停用。 |
| 翻页特效effectPage | 开关 开启 | 开启(默认) | 点击上一页 / 下一页 / 页码时,内容区按翻页方向横向滑动淡出,顶部显示一条进度条,随后进入新页面。 同时作用于列表分页与评论分页。 |
| 打开文章特效effectOpen | 开关 开启 | 关闭(默认) | 点击首页 / 分类页列表里的文章卡片(标题、封面、阅读全文)时,卡片轻微放大浮起、其余卡片淡出,再进入文章页。 只对列表卡片生效;Ctrl / 中键 / 新窗口打开等操作不受影响。 |
| 头像悬停显示认证名称certTip | 开关 开启 | 开启(默认) | 鼠标移到已认证会员的头像(文章作者栏、列表卡片、评论区、侧边栏评论)时,浮出气泡显示其认证名称。 需要 pb_member 会员中心插件,且该会员已通过认证。 |
页脚 · 数据条
页脚上方的站点数据条:布局、波浪动效、5 项数据与自定义图标。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 数据条布局staLayout | 单选 整条等分栅格(推荐) 独立卡片排列 | bar | 等分栅格:一整条统计带,各项之间以细线均匀分隔;卡片:每项独立圆角小卡。 |
| 显示站点数据条staShow | 开关 开启 | 开启(默认) | 关闭后页脚上方的数据统计区块整体隐藏。 |
| 显示波浪动效staWave | 开关 开启 | 开启(默认) | 数据条顶部的流光渐变 + 波浪动画,追求性能可关闭。 |
| 数据项:文章总数staLog | 开关 开启 | 开启(默认) | |
| 文章 · 自定义图标staLogIcon | 图片 | 留空 | 留空使用内置图标,建议 1:1 透明背景 PNG。 |
| 数据项:评论总数staCom | 开关 开启 | 开启(默认) | |
| 评论 · 自定义图标staComIcon | 图片 | 留空 | 留空使用内置图标。 |
| 数据项:标签总数staTag | 开关 开启 | 开启(默认) | |
| 标签 · 自定义图标staTagIcon | 图片 | 留空 | 留空使用内置图标。 |
| 数据项:友情链接数staLink | 开关 开启 | 开启(默认) | |
| 友链 · 自定义图标staLinkIcon | 图片 | 留空 | 留空使用内置图标。 |
| 数据项:站点运行天数staDay | 开关 开启 | 开启(默认) | 需要配合下方「建站日期」使用。 |
| 运行天数 · 自定义图标staDayIcon | 图片 | 留空 | 留空使用内置图标。 |
| 建站日期staFoundDate | 日期 | 留空 | 用于计算运行天数,格式 2020-01-01。 |
页脚 · 简介与备案
页脚整体风格、站点简介栏、ICP / 公安备案与免责声明。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 页脚整体风格footerStyle | 单选 卡片风格(圆角留白) 通栏风格(整幅背景) | card | |
| 第一栏标题footerAboutTitle | 文本 | 关于站点 | 页脚第一栏(站点简介)的小标题,留空则显示「关于站点」。 |
| 显示站点简介栏footerShowIntro | 开关 开启 | 开启(默认) | |
| 站点名称footerIntroTitle | 文本 | 留空 | 留空则自动使用后台设置的站点名称。 |
| 站点简介footerIntroDesc | 多行文本 | 留空 | 支持换行,留空则自动使用后台「站点描述」。 |
| 第二栏标题footerLegalTitle | 文本 | 备案与声明 | 页脚第二栏(备案信息)的小标题,留空则显示「备案与声明」。 |
| 显示 ICP 备案号footerShowIcp | 开关 开启 | 开启(默认) | |
| ICP 备案号icp | 文本 | 留空 | 填写后自动链接到工信部备案查询页,例如:京ICP备12345678号-1。 |
| ICP 备案 · 自定义图标icpIcon | 图片 | 留空 | 留空使用内置盾牌图标,建议 1:1 透明背景 PNG。 |
| 显示公安备案号footerShowPolice | 开关 开启 | 关闭(默认) | |
| 公安备案号policeNo | 文本 | 留空 | 例如:京公网安备 11010802000000 号,填写后自动链接到公安部查询页。 |
| 公安备案 · 自定义图标policeIcon | 图片 | 留空 | 留空使用内置盾牌图标。 |
| 显示版权/免责声明footerShowNotice | 开关 开启 | 开启(默认) | |
| 版权/免责声明内容footerNotice | 多行文本 | 留空 | 支持换行,例如:本站部分文章来自互联网收集,仅供学习交流,如有侵权请联系删除。 |
| 免责声明 · 自定义图标noticeIcon | 图片 | 留空 | 留空使用内置版权图标。 |
页脚 · 联系方式
页脚联系方式栏:内置 6 个平台 + 完全自定义平台。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 显示联系方式栏footerShowContact | 开关 开启 | 开启(默认) | 总开关,关闭后整栏都不显示。 |
| 第三栏标题footerContactTitle | 文本 | 联系我们 | 页脚第三栏(联系方式)的小标题,留空则显示「联系我们」。 |
| 图标形状socialStyle | 单选 圆形 圆角方形 无背景(仅图标) | circle | |
| 微信ctWechat | 开关 开启 | 开启(默认) | 上传二维码后鼠标悬停弹出;也可上传自定义图标替换内置图标。 |
| 微信 · 自定义图标wechatIcon | 图片 | 留空 | 留空使用内置图标。建议 1:1 透明背景 PNG,短边 ≥ 48px。 |
| 微信二维码wechatQr | 图片 | 留空 | |
| QQctQq | 开关 开启 | 开启(默认) | 上传二维码后悬停弹出;填写链接则点击直接跳转。 |
| QQ · 自定义图标qqIcon | 图片 | 留空 | 留空使用内置图标。 |
| QQ 二维码qqQr | 图片 | 留空 | |
| QQ 聊天链接qqLink | 文本 | 留空 | 例如:https://wpa.qq.com/msgrd?v=3&uin=10000&site=qq&menu=yes |
| 邮箱ctMail | 开关 开启 | 开启(默认) | |
| 邮箱 · 自定义图标mailIcon | 图片 | 留空 | 留空使用内置图标。 |
| 邮箱地址mailAddr | 文本 | 留空 | 例如:admin@example.com,点击唤起邮件客户端。 |
| 微博ctWeibo | 开关 开启 | 关闭(默认) | |
| 微博 · 自定义图标weiboIcon | 图片 | 留空 | 留空使用内置图标。 |
| 微博主页地址weiboUrl | 文本 | 留空 | |
| 哔哩哔哩ctBili | 开关 开启 | 关闭(默认) | |
| 哔哩哔哩 · 自定义图标biliIcon | 图片 | 留空 | 留空使用内置图标。 |
| 哔哩哔哩主页地址biliUrl | 文本 | 留空 | |
| GitHubctGithub | 开关 开启 | 关闭(默认) | |
| GitHub · 自定义图标githubIcon | 图片 | 留空 | 留空使用内置图标。 |
| GitHub 主页地址githubUrl | 文本 | 留空 | |
| 自定义平台ctCustom | 多行文本 | 留空 | 每行一条,格式:名称|图标|链接|二维码|颜色类(后四项可选,用竖线分隔,不能省略中间的竖线)。 图标:填内置图标键(下方列表)或图片地址(后台上传后粘贴地址,也可写成 img:图片地址)即显示为自定义图标。可用图标键:wechat、qq、mail、weibo、bilibili、github、douyin、zhihu、heart、phone、link、rss、home、user、tag、folder、sparkle、chart、users、alert。 可用颜色类:c-blue、c-green、c-red、c-orange、c-cyan、c-purple、c-pink、c-dark。 示例 1:抖音|douyin|https://www.douyin.com/user/xxx||c-dark 示例 2:抖音|https://xxx.com/douyin.png|https://www.douyin.com/user/xxx||c-dark |
页脚 · 友情链接
页脚友情链接区块(数据取自后台「链接」管理)。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 显示友情链接footerShowFriend | 开关 开启 | 开启(默认) | 开关页脚的友情链接区块。链接内容直接调用后台「链接」管理(与侧边栏「链接」组件同源),在这里维护即可,前台自动同步;后台未添加任何链接时该区块自动隐藏。 |
| 区块标题footerFriendTitle | 文本 | 友情链接 | 留空默认显示「友情链接」。 |
| 展示布局footerFriendLayout | 单选 胶囊并排(自动换行) 网格分栏(等宽对齐) | inline | 链接较多时推荐「网格分栏」,视觉更整齐。 |
| 新窗口打开footerFriendBlank | 开关 开启 | 开启(默认) | 关闭后在当前窗口打开友链。 |
| 友链加 nofollowfooterFriendNofollow | 开关 开启 | 开启(默认) | 给友情链接加上 rel="nofollow",避免站外链接分散权重;交换的友链建议保持开启。 |
页脚 · 版权与附加
页脚导航链接、模板作者署名、返回顶部按钮与页脚附加 HTML。
| 设置项 | 类型 / 可选值 | 默认 | 说明 |
|---|---|---|---|
| 显示页脚导航链接footerShowLinks | 开关 开启 | 开启(默认) | |
| 自定义页脚链接footerLinks | 多行文本 | 留空 | 每行一条,格式:链接文字|链接地址(例:关于我们|https://xxx/about)。 |
| 显示模板作者署名footerShowCredit | 开关 开启 | 开启(默认) | 在页脚底部显示 Theme by nswin.cn,可随时关闭。 |
| 署名文案footerCreditText | 文本 | 留空 | 留空默认显示:Theme by nswin.cn。可用变量 {author}(作者名)、{url}(作者主页),支持 HTML。 |
| 显示返回顶部按钮footerShowBackTop | 开关 开启 | 开启(默认) | |
| 页脚附加内容footerHtml | 多行文本 | 留空 | 支持 HTML,可填写统计代码、站点说明等,显示在版权信息下方。 |
部署与升级
升级要点
网站根目录/content/templates/PureBlog/ 即可,不会影响文章、用户与插件数据。授权信息不会丢:授权码存在数据库与状态文件中,覆盖模板文件不受影响。
升级后建议:清一次 EMLOG 缓存(系统 → 缓存管理),浏览器按 Ctrl + F5 强刷一次。
常见问题
未授权时前台打不开,一直停在未授权页怎么办?
这是授权模块的预期行为:授权未通过(未填授权码 / 无效 / 过期 / 域名未绑定 / 已停用)时前台整站跳转到未授权提示页。在提示页的输入框粘贴授权码即可当场恢复;也可到「外观 → 模板设置 → 授权设置」粘贴后保存。后台 /admin 不受影响,始终可以登录。
授权状态怎么快速排查?
前台 HTML 的 <html> 标签上会输出 data-pb-license(状态)、data-pb-license-domain(识别到的域名)、data-pb-license-api(实际请求的接口地址),查看网页源代码即可一眼确认模板读到的是什么。
「立即重新检测」会不会离开设置页?
不会。检测在设置页的授权状态卡片内异步完成,只更新卡片文字,不刷新页面、不改地址栏。
列表卡片没有封面图?
封面按三级取值链获取:后台封面 → 正文首图 → 网络兜底图。若三级都没有,才会显示内置占位图。服务器无法访问外部图源时,在「文章设置 → 网络图片图源」里换成「必应每日一图」或填写自己的接口。
页脚没有友情链接?
友情链接直接读取后台「链接」管理中维护的数据(与侧边栏「链接」组件同源),后台没有添加任何链接、或链接被勾选为「隐藏」时,该区块自动隐藏。
页脚没有「运行天数」?
需要在「页脚 · 数据条 → 建站日期」里填写日期(格式 2020-01-01),且「数据项:站点运行天数」保持开启。
会员勋章、认证、点赞收藏都不显示?
这些依赖配套的「PureBlog 会员中心」插件(pb_member)。插件未启用时模板自动降级,不影响其它功能。
改了设置不生效 / 后台模板设置页样式异常?
先清一遍 EMLOG 缓存;仍无效则按 Ctrl + F5 强制刷新浏览器(样式表带版本号,正常会自动更新)。