PureBlog 模板 · 设置与功能说明

EMLOG Pro 响应式博客模板 | 固定毛玻璃顶栏 · 1280 容器 · 左图右文卡片列表 · 320px 右侧栏 · 移动端抽屉导航 · 12 类侧边栏组件 · 表情评论 · 可视化模板设置

版本 v1.9.22适用 EMLOG 6.0+11 个设置分组 / 95 个设置项12 类侧边栏组件
作者 nswin.cn购买与授权 https://www.nswin.cn联系 QQ123326923
01

快速上手

上传 → 启用 → 填授权码,三步即可上线

安装与启用

  1. 备份升级前先备份现有模板目录与数据库,出问题可直接回滚。
  2. 上传模板把 PureBlog 目录整体上传到 网站根目录/content/templates/PureBlog/(覆盖同名文件)。
  3. 启用模板后台「外观 → 模板」中启用 PureBlog。
  4. 启用设置插件确保 EMLOG 的「模板设置」插件(tpl_options)已启用,否则后台不会出现「外观 → 模板设置」入口。
  5. 填写授权码进入「外观 → 模板设置 → 授权设置」,粘贴授权码并保存;状态卡片会立即联网校验并绑定当前域名。
  6. 建站日期在「页脚 · 数据条」里填写建站日期,页脚的「运行天数」才会显示。
  7. 清缓存EMLOG 后台「系统 → 缓存管理」清一次缓存,前台即可看到最新样式。
依赖说明:模板设置需要 EMLOG 的「模板设置」插件(tpl_options)处于启用状态;会员等级、认证、点赞收藏等会员元素需要配套的「PureBlog 会员中心」插件(pb_member)。两者缺其一时模板会自动降级,不影响其它功能。
02

功能总览

前台实际能力(逐项对照源码核对)

顶栏与导航

8 项

固定毛玻璃顶栏,桌面端与移动端两套导航形态。

固定毛玻璃顶栏
滚动时始终吸顶,半透明模糊背景 + 描边,内容穿过顶栏下方滚动。
站点 LOGO 两种形态
文字 LOGO(自动取站点名称首字做成渐变徽标)或图片 LOGO,后台一键切换。
主导航 + 二级下拉
读取后台「导航」设置;含子分类或子导航的菜单项自动出现下拉箭头与悬浮面板。
搜索面板
点击顶栏搜索按钮下拉展开,直接提交到 EMLOG 核心搜索(index.php?keyword=),移动端则在抽屉导航内置搜索框。
深浅色切换
顶栏搜索按钮右侧的月亮 / 太阳按钮,一键切换浅色与深色;选择结果同时写入 cookie 与 localStorage。
用户入口按角色分流
未登录显示「登录」(弹出登录框);管理员/编辑/写手显示「后台管理」;普通注册用户显示「会员中心」(需 pb_member 插件)。
移动端抽屉导航
≤1024px 时主导航收起为侧滑抽屉,点击汉堡按钮展开,点击遮罩或按 ESC 关闭,按钮带 aria-expanded 状态。
跳到主要内容
页面第一个可聚焦元素是「跳到主要内容」链接,键盘 / 读屏用户可跳过顶栏直接到正文。

首页与列表页

7 项

首页焦点图 + 左图右文卡片列表,支持分类、标签、归档、搜索等所有 EMLOG 列表型页面。

首页轮播图
后台按「图片地址|标题|链接」逐行填写;仅首页显示,支持左右箭头、圆点指示器、自动播放。
左图右文卡片
封面在左、标题/摘要/元信息在右;窄屏自动堆叠为上下结构。
封面图三级取值链
① 后台设置的封面图 → ② 自动提取正文首图(兼容懒加载写法与相对路径,自动跳过占位图)→ ③ 网络兜底图(按文章 ID 固定,篇篇不同)。
卡片元信息
作者头像(带认证角标)、作者会员等级勋章、发布时间、阅读数、评论数;标签可按开关隐藏。
置顶标志
后台设为置顶的文章在首页标题前显示「置顶」,分类页顶部文章显示「分类置顶」。
空状态页
没有内容时输出图标 + 文案 + 「回到首页」按钮,不留白屏。
分页
沿用 EMLOG 分页结构,上一页 / 下一页带箭头图标;开启翻页特效后点击有横向滑动过渡。

文章详情页 / 独立页面

11 项

顶部大图 + 面包屑 + 作者栏 + 正文 + 标签 + 版权声明的完整阅读版式。

顶部大图与面包屑
可选顶部大图(面包屑与标题叠加在图上,带遮罩保证文字可读);关闭后面包屑回到标题上方,不留空位。
正文首图去重
顶部大图取自正文首图时,自动把正文里那张重复的图(含包裹它的链接与空段落)隐藏,避免一张图出现两次。
作者信息栏
头像(带认证角标与悬停认证名称)、作者名、会员等级勋章、发布时间;右侧显示字数统计与预估阅读时长。
字号调节
正文右上角的 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 订阅链接。

评论区

10 项

自带表情面板与楼层、徽章的评论列表,兼容 EMLOG 核心评论接口。

表情面板
内置「表情 / 手势 / 生活 / 动物」四组共 90+ 表情,可后台追加自定义 emoji 或图片表情(图片表情插入 [img] 标签)。
工具条
表情按钮 + 加粗按钮 + 实时字数计数(上限 500 字)。
快捷提交
Ctrl + Enter(Mac 为 ⌘ + Enter)直接提交评论。
楼层号
顶级评论右侧显示 #1、#2 …,子评论不编号。
作者 / 会员徽章
文章作者显示蓝色「作者」徽章,其他注册用户显示绿色「会员」徽章;会员等级勋章紧随昵称。
待审核标记
未通过审核的评论显示「待审核」标签,方便自己预览。
回复与取消
每条评论可点击「回复」,输入框自动带上被回复者昵称与父级 ID,并出现「取消回复」按钮。
游客表单
昵称 / 邮箱 / 网址三栏(网址栏可后台关闭)+ 图形验证码;站点开启「登录后才能评论」时改为提示先登录。
关闭评论提示
文章关闭评论时显示带图标的提示条,而不是把整个表单藏掉造成困惑。
评论分页
评论超过设定条数时输出分页导航,并同样受翻页特效影响。

侧边栏组件(12 类)

12 项

全部在后台「外观 → 侧边栏管理」中拖拽排序、改名、开关。

站长名片
站长头像(带认证角标)、昵称、简介与文章/评论/标签三项统计,底部按登录状态显示「登录 / 注册」或「后台管理 / 会员中心 + 退出登录」。
搜索
独立搜索框组件,与顶栏搜索同源。
最新文章
按发布时间倒序,条数取后台「首页显示文章数」设置,右侧显示友好时间(如「3 天前」)。
热门文章
按阅读量排序,前三名带名次高亮,可选显示缩略图与阅读数。
标签云
读取全部标签,悬停显示该标签的文章数。
分类
支持二级分类缩进显示,右侧显示各分类文章数。
文章归档
按月份归档,右侧显示每月文章数。
友情链接
读取后台「链接」管理,支持链接图标,自动带 nofollow。
最新评论
显示评论者头像(带认证角标)与会员勋章,点击直达该评论。
日历
EMLOG 日历组件,异步加载不阻塞页面。
微语
最新碎语列表,含作者、等级勋章与发布时间。
自定义 HTML
后台上传的任意 HTML 片段(广告位、统计代码等)。

页脚

13 项

数据条 → 简介/备案 → 联系方式 → 友情链接 → 导航链接与版权,五段式可分别开关。

站点数据条
两种布局(整条等分栅格 / 独立圆角卡片),可选波浪流光动效;文章、评论、标签、友链四项自动统计,「运行天数」按后台填写的建站日期计算。
数据项自定义图标
五项数据都支持后台上传 1:1 透明 PNG 替换内置线性图标。
页脚风格
卡片风格(圆角留白)或通栏风格(整幅背景)一键切换。
站点简介栏
站点名 + 多行简介,留空时自动回退到后台的站点名称与站点描述。
备案信息
ICP 备案号自动链接工信部查询页,公安备案号自动链接公安部查询页,两者可分别开关,图标可自定义。
免责声明
多行版权/免责文案,可开关,图标可自定义。
联系方式栏
微信、QQ、邮箱、微博、哔哩哔哩、GitHub 六个内置平台各自独立开关;微信/QQ 上传二维码后鼠标悬停弹出二维码气泡,图标形状可选圆形 / 圆角方形 / 无背景。
自定义平台
无限追加:格式「名称|图标|链接|二维码|颜色类」,图标可填内置图标键或图片地址,颜色类可选 8 种。
友情链接区块
两种布局(胶囊并排 / 网格分栏)、新窗口打开、nofollow 三个开关;数据来自后台「链接」管理,无链接时整块自动隐藏。
页脚导航链接
后台按「链接文字|链接地址」逐行添加。
作者署名
默认显示 Theme by nswin.cn,文案可自定义(支持 {author}、{url} 变量与 HTML)。
返回顶部
滚动超过一屏后右下角浮出按钮,点击平滑回顶。
页脚附加内容
支持 HTML,可放统计代码、站点说明等。

会员体系联动(pb_member 插件)

5 项

安装配套的「PureBlog 会员中心」插件后自动生效;未安装时模板全部功能照常,只是不显示这些会员元素。

会员等级勋章
昵称后显示等级勋章:后台上传过等级图标则显示图标,否则回退为彩色等级名徽章。
认证角标
已认证会员头像右下角显示认证标志,标志图可在插件后台上传。
认证名称气泡
鼠标移到已认证会员头像上浮出认证名称气泡,可在「特效设置」里整体关闭。
点赞 / 收藏 / 关注作者
文章页操作条,状态与计数实时同步,数据接口由插件提供。
会员中心入口
顶栏、导航菜单、站长名片的用户入口按角色自动分流到会员中心(/?plugin=pb_member)。

动效与交互

5 项

三类前台动效各自独立开关,追求极致性能可全部关闭。

淡入特效
列表卡片、侧边栏组件、正文与评论区滚动进入视口时逐个淡入上浮,首屏内容依次浮现。
翻页特效
点击上一页/下一页/页码时内容区按方向横向滑动淡出,顶部显示进度条;列表分页与评论分页同时生效。
打开文章特效
点击列表卡片时卡片轻微放大浮起、其余卡片淡出,再进入文章页;Ctrl / 中键 / 新窗口打开等操作不受影响。
无脚本与减弱动效兜底
浏览器禁用 JS 时用 1.5 秒超时自动撤掉初始隐藏(内容一定可见),并附
登录 / 注册弹窗
点击「登录」不再跳页,弹出模态框内 AJAX 提交;支持登录验证码、注册邮箱验证码、记住登录状态与「忘记密码」入口,验证码图片懒加载以避免两个面板互相覆盖。
03

设置项说明

后台「外观 → 模板设置」,共 11 组 / 95 项
本节的每一项都由 PureBlog/options.php 自动解析生成,与后台设置页完全一致;模板升级后本节会随代码同步更新,不必担心文档过时。

授权设置

tpl-license | 4 项

模板授权码与授权服务器参数。未通过正版校验时,前台整站跳转到未授权提示页(内含购买入口与授权码输入框)。

授权说明:模板默认授权接口为 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用于给每次校验请求签名,必须与授权管理端「系统设置 → 通信密钥」完全一致。
在管理端重新生成密钥后,请同步更新这里。

品牌与识别

tpl-brand | 6 项

站点 LOGO、站点图标、社交分享封面与深浅色配色方案。

设置项类型 / 可选值默认说明
站点 LOGO 类型logotype单选 文字 LOGO(取站点名称首字) 图片 LOGO1选择「图片 LOGO」时请在下方上传 LOGO 图片。
LOGO 图片logoimg图片 后台上传图片留空建议高度 40px 左右的透明背景 PNG。
站点图标(favicon)favicon图片留空留空则使用站点根目录下的 favicon.ico。
社交分享封面图og_image图片留空微信 / 微博等平台分享时展示的缩略图,建议 1200×630。
显示暗黑模式切换按钮themeToggle开关 开启开启(默认)按钮位于顶部导航栏「搜索」按钮之后,读者可自行切换深浅色。
默认配色模式themeDefault单选 跟随系统 始终浅色 始终深色auto读者手动切换后会记住选择,下次访问优先使用其记忆值。

首页设置

tpl-home | 2 项

首页轮播图与列表卡片的标签显示。

设置项类型 / 可选值默认说明
首页轮播图slideShow多行文本留空每行一条,格式:图片地址|标题|链接(例:https://xxx/a.jpg|站点公告|https://xxx/post-1.html),留空则不显示轮播。
列表显示文章标签showListTags开关 开启开启(默认)关闭后首页列表只显示标题、摘要与元信息。

文章设置

tpl-article | 11 项

文章详情页的顶部大图、封面图取值链、版权声明与评论表单选项。

设置项类型 / 可选值默认说明
详情页显示顶部大图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开关 开启开启(默认)关闭后游客评论表单不再显示网址输入框。

评论设置

tpl-comment | 5 项

评论表情面板、输入框提示语、楼层号与作者/会员徽章。

设置项类型 / 可选值默认说明
显示评论表情面板commentEmoticon开关 开启开启(默认)在评论输入框上方显示「表情」按钮,点击弹出表情面板(内置表情 / 手势 / 生活 / 动物四组)。
自定义表情emoticonCustom多行文本留空每行一个。可以直接写 emoji(如 🎉),也可以写「名称|图片地址」使用图片表情(会插入 [img] 标签)。
示例:🎉滑稽|https://xxx.com/1.png
评论输入框提示语commentPlaceholder文本说点什么…(支持 Ctrl + Enter 提交)留空则使用默认提示语。
显示评论楼层号commentFloor开关 开启开启(默认)在顶级评论右侧显示 #1、#2 楼层号。
显示作者 / 会员徽章commentBadge开关 开启开启(默认)文章作者显示蓝色「作者」徽章,其他注册用户显示绿色「会员」徽章。

特效设置

tpl-effect | 4 项

淡入、翻页、打开文章三类动效开关,以及头像悬停认证名称气泡。

设置项类型 / 可选值默认说明
淡入特效effectFade开关 开启开启(默认)列表卡片、侧边栏组件、正文与评论区在滚动进入视口时逐个淡入上浮,首屏内容依次浮现。
读者系统若开启「减弱动态效果」,本特效会自动停用。
翻页特效effectPage开关 开启开启(默认)点击上一页 / 下一页 / 页码时,内容区按翻页方向横向滑动淡出,顶部显示一条进度条,随后进入新页面。
同时作用于列表分页与评论分页。
打开文章特效effectOpen开关 开启关闭(默认)点击首页 / 分类页列表里的文章卡片(标题、封面、阅读全文)时,卡片轻微放大浮起、其余卡片淡出,再进入文章页。
只对列表卡片生效;Ctrl / 中键 / 新窗口打开等操作不受影响。
头像悬停显示认证名称certTip开关 开启开启(默认)鼠标移到已认证会员的头像(文章作者栏、列表卡片、评论区、侧边栏评论)时,浮出气泡显示其认证名称。
需要 pb_member 会员中心插件,且该会员已通过认证。

页脚 · 数据条

tpl-sta | 14 项

页脚上方的站点数据条:布局、波浪动效、5 项数据与自定义图标。

设置项类型 / 可选值默认说明
数据条布局staLayout单选 整条等分栅格(推荐) 独立卡片排列bar等分栅格:一整条统计带,各项之间以细线均匀分隔;卡片:每项独立圆角小卡。
显示站点数据条staShow开关 开启开启(默认)关闭后页脚上方的数据统计区块整体隐藏。
显示波浪动效staWave开关 开启开启(默认)数据条顶部的流光渐变 + 波浪动画,追求性能可关闭。
数据项:文章总数staLog开关 开启开启(默认)
文章 · 自定义图标staLogIcon图片留空留空使用内置图标,建议 1:1 透明背景 PNG。
数据项:评论总数staCom开关 开启开启(默认)
评论 · 自定义图标staComIcon图片留空留空使用内置图标。
数据项:标签总数staTag开关 开启开启(默认)
标签 · 自定义图标staTagIcon图片留空留空使用内置图标。
数据项:友情链接数staLink开关 开启开启(默认)
友链 · 自定义图标staLinkIcon图片留空留空使用内置图标。
数据项:站点运行天数staDay开关 开启开启(默认)需要配合下方「建站日期」使用。
运行天数 · 自定义图标staDayIcon图片留空留空使用内置图标。
建站日期staFoundDate日期留空用于计算运行天数,格式 2020-01-01。

页脚 · 简介与备案

tpl-finfo | 15 项

页脚整体风格、站点简介栏、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图片留空留空使用内置版权图标。

页脚 · 联系方式

tpl-fcontact | 23 项

页脚联系方式栏:内置 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

页脚 · 友情链接

tpl-ffriend | 5 项

页脚友情链接区块(数据取自后台「链接」管理)。

设置项类型 / 可选值默认说明
显示友情链接footerShowFriend开关 开启开启(默认)开关页脚的友情链接区块。链接内容直接调用后台「链接」管理(与侧边栏「链接」组件同源),在这里维护即可,前台自动同步;后台未添加任何链接时该区块自动隐藏。
区块标题footerFriendTitle文本友情链接留空默认显示「友情链接」。
展示布局footerFriendLayout单选 胶囊并排(自动换行) 网格分栏(等宽对齐)inline链接较多时推荐「网格分栏」,视觉更整齐。
新窗口打开footerFriendBlank开关 开启开启(默认)关闭后在当前窗口打开友链。
友链加 nofollowfooterFriendNofollow开关 开启开启(默认)给友情链接加上 rel="nofollow",避免站外链接分散权重;交换的友链建议保持开启。

页脚 · 版权与附加

tpl-fcopy | 6 项

页脚导航链接、模板作者署名、返回顶部按钮与页脚附加 HTML。

设置项类型 / 可选值默认说明
显示页脚导航链接footerShowLinks开关 开启开启(默认)
自定义页脚链接footerLinks多行文本留空每行一条,格式:链接文字|链接地址(例:关于我们|https://xxx/about)。
显示模板作者署名footerShowCredit开关 开启开启(默认)在页脚底部显示 Theme by nswin.cn,可随时关闭。
署名文案footerCreditText文本留空留空默认显示:Theme by nswin.cn。可用变量 {author}(作者名)、{url}(作者主页),支持 HTML。
显示返回顶部按钮footerShowBackTop开关 开启开启(默认)
页脚附加内容footerHtml多行文本留空支持 HTML,可填写统计代码、站点说明等,显示在版权信息下方。
04

部署与升级

升级要点

只覆盖模板目录:升级包解压后覆盖 网站根目录/content/templates/PureBlog/ 即可,不会影响文章、用户与插件数据。
授权信息不会丢:授权码存在数据库与状态文件中,覆盖模板文件不受影响。
升级后建议:清一次 EMLOG 缓存(系统 → 缓存管理),浏览器按 Ctrl + F5 强刷一次。
05

常见问题

未授权时前台打不开,一直停在未授权页怎么办?

这是授权模块的预期行为:授权未通过(未填授权码 / 无效 / 过期 / 域名未绑定 / 已停用)时前台整站跳转到未授权提示页。在提示页的输入框粘贴授权码即可当场恢复;也可到「外观 → 模板设置 → 授权设置」粘贴后保存。后台 /admin 不受影响,始终可以登录。

授权状态怎么快速排查?

前台 HTML 的 <html> 标签上会输出 data-pb-license(状态)、data-pb-license-domain(识别到的域名)、data-pb-license-api(实际请求的接口地址),查看网页源代码即可一眼确认模板读到的是什么。

「立即重新检测」会不会离开设置页?

不会。检测在设置页的授权状态卡片内异步完成,只更新卡片文字,不刷新页面、不改地址栏。

列表卡片没有封面图?

封面按三级取值链获取:后台封面 → 正文首图 → 网络兜底图。若三级都没有,才会显示内置占位图。服务器无法访问外部图源时,在「文章设置 → 网络图片图源」里换成「必应每日一图」或填写自己的接口。

页脚没有友情链接?

友情链接直接读取后台「链接」管理中维护的数据(与侧边栏「链接」组件同源),后台没有添加任何链接、或链接被勾选为「隐藏」时,该区块自动隐藏。

页脚没有「运行天数」?

需要在「页脚 · 数据条 → 建站日期」里填写日期(格式 2020-01-01),且「数据项:站点运行天数」保持开启。

会员勋章、认证、点赞收藏都不显示?

这些依赖配套的「PureBlog 会员中心」插件(pb_member)。插件未启用时模板自动降级,不影响其它功能。

改了设置不生效 / 后台模板设置页样式异常?

先清一遍 EMLOG 缓存;仍无效则按 Ctrl + F5 强制刷新浏览器(样式表带版本号,正常会自动更新)。

06

模板文件清单

共 15 个文件
PureBlog/404.php · 2.2 KBPureBlog/echo_log.php · 8.2 KBPureBlog/footer.php · 13.6 KBPureBlog/header.php · 11.3 KBPureBlog/images/logo.svg · 0.7 KBPureBlog/images/thumb-placeholder.svg · 0.6 KBPureBlog/js/main.js · 37.0 KBPureBlog/license.php · 61.9 KBPureBlog/log_list.php · 8.0 KBPureBlog/main.css · 74.8 KBPureBlog/module.php · 87.2 KBPureBlog/options.php · 36.9 KBPureBlog/page.php · 3.1 KBPureBlog/preview.jpg · 166.3 KBPureBlog/side.php · 1.3 KB