剑侠导航 Ultimate · 主题 | Z-BlogPHP 网址导航主题

================================================================================

  剑侠导航 Ultimate · 主题

  主题标识：jx_nav_ultimate  |  版本：2.5.2  |  适配：Z-BlogPHP | 作者：剑侠君

================================================================================

一、主题介绍

--------------------------------------------------------------------------------

  「剑侠导航 Ultimate」是剑侠君原创的 Z-BlogPHP 网址导航主题，融合古代剑侠

  意境与 AI 赛博朋克视觉风格——毛玻璃、霓虹流光、水墨氛围一应俱全。主题面向

  网址导航站、站长资源站、AI 工具分享站及内容聚合站，一套模板同时支持「导航

  站点文章」与「普通文章」两种形态，并内置多引擎聚合搜索、首页分区卡片、自助

  友情链接申请与审核、深度定制评论区、页脚友链与社交、广告位、站点统计、SMTP

  邮件通知等站长刚需功能。

  全站采用标准响应式 Web 设计（RWD），同一套 HTML 随屏幕宽度自适应布局；移动端

  提供汉堡菜单 + 抽屉侧栏，大量选项支持「仅 PC / 仅手机」分端控制。启用主题后，

  Z-Blog 后台顶栏会出现「剑侠导航」入口，进入可视化配置页即可填表保存，一般

  不必修改程序代码。

  【适用人群】

  · 个人或团队运营的网址导航、资源索引、工具合集站点

  · 需要「站点卡片 + 详情页 + 外链跳转」形态的导航类博客

  · 同时发布导航条目与普通图文内容的站长

  · 希望访客自助提交友链、后台一键审核并自动收录的站点

  · 追求剑侠 / 赛博武侠风 UI、昼夜双模式、氛围特效的 Z-Blog 用户

  · 零基础站长：按后台各标签填表即可搭建，无需编程基础

二、主题特色

--------------------------------------------------------------------------------

  【视觉与交互】

  · 剑侠 + 赛博霓虹风格：大面积毛玻璃、渐变暗色底、水墨意境

  · 首页 Hero 大熊 / 雪山动态场景（可关闭），支持自定义背景图与 BGM

  · 昼夜双模式 + 多套配色（纯白 / 仙蓝等），顶栏一键切换，本地记忆

  · 可选樱花飘落特效、右侧悬浮 Dock（回顶 / 主题切换 / 跳底）

  · 剑形 / 胶囊多引擎搜索 UI，引擎 Tab 可后台自由增删排序

  【内容形态】

  · 导航文章（宗门详情）：大卡片、站点图标、进入山门、秘典简介、宗门声望、

    访客趋势图、同道中人（相似站点）等专属版式

  · 普通文章（经典正文）：标题、元信息、正文、标签、上一篇/下一篇、相关阅读等

  · 分类列表自动识别「导航根分类」与普通分类，分别分页与展示

  【运营闭环】

  · 访客前台自助申请友情链接 → 后台审核 → 可自动写入页脚友链 / 发布导航文章

  · 评论系统深度定制：验证码、楼层昵称、快捷语、表情包、敏感词、频率限制、

    待审核队列与邮件通知

  · 7 个广告位、本地 + 第三方站点统计、SMTP 友链/评论通知邮件

  【多端与体验】

  · 全端响应式，768px 以下启用移动端抽屉导航

  · 支持 prefers-reduced-motion，区分鼠标与触控操作

  · 导航外链离开确认弹窗（宗门通道），保护访客误点

  · 与「剑侠用户系统」等插件可联动（签到榜、评论投票、在线统计等）

三、主题功能

--------------------------------------------------------------------------------

  ┌──────────────────────────────────────────────────────────────────────────┐

  │  A. 前台功能概览                                                         │

  └──────────────────────────────────────────────────────────────────────────┘

  【顶栏与导航】

  · Logo（支持日间 / 夜间两套）、与 Z-Blog 导航模块对接的多级菜单

  · 移动端汉堡菜单 + 抽屉侧栏，子分类可折叠；sidebar7 可挂扩展模块

  · 顶栏工具区：站内快捷搜索、氛围按钮（BGM / 樱花 / 色板）、用户头像菜单

  · 游客默认头像、第三方登录/注册链接（可配置）

  【首页（第 1 页）】

  · Hero 区：大标题、多引擎聚合搜索、热门搜索关键词（可分 PC / 手机）

  · 可选大熊动态背景、自定义天空背景图、背景音乐

  · 公告条：多条轮播，支持自定义颜色与跳转链接

  · 分类区块卡片：按后台配置拉取导航文章，支持排序（最新 / 浏览 / 评论）

  · 「最新收录」：展示已通过友链审核的站点

  · 「热门推荐」：按指定文章 ID 顺序展示

  · 左侧悬浮「申请收录」按钮（可分 PC / 手机，链至友链申请页）

  【列表与搜索】

  · 分类归档：导航分类与普通分类不同卡片样式与每页条数

  · 非首页备用搜索条（玻璃面板「御剑搜索」）

  · 搜索页：文章卡片网格 + 分页；带关键词时输出 noindex（SEO 友好）

  【导航文章详情（宗门详情）】

  · 面包屑、站点大卡片（图标、标题、进入山门外链、秘典简介、标签）

  · 宗门声望：爱站 / 站长网 / 5118 等 SEO 查询外链（可开关）

  · 江湖访客足迹：近 30 日访问量 ECharts 趋势图

  · 同道中人：同分类相似导航站点推荐（条数可分 PC / 手机）

  · 可选外链免责声明入口、评论区（独立开关）

  · 离开站点时外链确认弹窗（宗门通道保护）

  【普通文章详情（经典正文）】

  · 标题、元信息、正文、可选字号调节（− / +）

  · 标签条、上一篇/下一篇（PC / 手机可分开关与不同排版）

  · 相关阅读（分端条数）、文末点赞/踩（本地浏览器计数）

  · 外链免责声明、评论区（独立开关）

  · 右侧栏 sidebar9 可挂模块

  【页脚】

  · 暗色 Hero 双栏：左侧站点介绍 + 右侧网站导航（JSON 可视化配置）

  · 友情链接条（主内容区底部，可分 PC / 手机）、QQ / 微信图标与二维码

  · 备案 / 公安备案 HTML、建站运行天数、版权 Powered 文案

  · 电脑端页脚搜索框、Z-Blog 性能信息、主题版权尾标（可关）

  · 可选禁止 F12 / 复制 / 右键（管理员豁免）

  【独立页面模板】

  · 「友情链接申请」：表单提交（站点名、URL、分类、关键词、简介等）

  · 可选显示页面正文与评论区；「江湖提示」轮播文案

  · 数据写入主题 data 目录 JSON，无需访客进后台

  【内置侧栏模块（后台 → 模块管理 → 主题模块）】

  · 宗门排行榜：按访问量排序的导航站点

  · 江湖留言榜：最新评论

  · 随机文章 / 最新文章 / 热门文章（仅普通文章）

  · 新宗门入驻：最新导航站点

  · 渡劫排行榜：连续签到榜（需用户插件）

  · 随机标签：含 JSON-LD

  · 御剑搜索：站内搜索表单

  【广告位（7 处，均可分 PC / 手机）】

  1. 首页正文板块顶部

  2. 首页友情链接板块上方

  3. 分类列表标题下方

  4a. 普通文章正文区顶部

  4b. 普通文章评论区下方

  5. 导航文章详情大卡片上方

  7. 手机端导航抽屉内

  【侧栏注册（theme.xml）】

  · sidebar1：导航栏

  · sidebar7：手机端导航抽屉侧栏

  · sidebar8：导航文章右侧栏

  · sidebar9：普通文章右侧栏

  ┌──────────────────────────────────────────────────────────────────────────┐

  │  B. 后台配置标签（网站后台 → 剑侠导航）                                    │

  └──────────────────────────────────────────────────────────────────────────┘

  进入方式：启用主题后，Z-Blog 后台顶栏点击「剑侠导航」

  ── 1. 基本设置 ──

  · 网站 Logo 地址（日间顶栏，支持本地上传压缩）

  · 夜间模式 Logo 地址（深色顶栏专用，留空则沿用日间 Logo）

  · 全站 SEO 关键词

  · 全站 SEO 描述

  ── 2. 首页配置 ──

  · 首页大标题（搜索区上方，留空用站点名称）

  · 启用 / 关闭首页大熊动态背景

  · 首页英雄区自定义背景图（开关 + URL）

  · 自定义背景音乐 URL（顶栏音乐按钮）

  · 樱花飘落特效按钮、主题配色切换按钮（全站顶栏）

  · 左侧悬浮「申请收录」：PC / 手机开关、按钮名称、跳转 URL

  · 顶栏用户区：第三方登录/注册、游客默认头像

  · 首页热门搜索：PC / 手机开关、关键词列表

  · 搜索引擎表格：名称、URL（{q} 占位）、按钮文案、启用、排序

  ── 3. 首页卡片设置 ──

  · 分类区块表格：分类 ID、显示篇数、文章排序、板块排序、自定义标题

  · 「最新收录」：启用、板块排序、条数、标题（来自已通过友链）

  · 「热门推荐」：启用、板块排序、条数、标题、文章 ID 列表

  ── 4. 公告配置 ──

  · 启用首页公告条（Hero 下方、卡片上方）

  · 公告前缀标题、自定义前缀颜色、轮播间隔（秒）

  · 公告列表（一行一条：标题 | 颜色 | 链接）

  ── 5. 模块配置 ──

  · 各主题内置模块的显示条数 / 时间窗 / 颜色模式：

    宗门排行榜、江湖留言榜、随机文章、最新文章、热门文章、

    新宗门入驻、渡劫排行榜、随机标签、御剑搜索（无条数项）

  ── 6. 文章页设置 ──

  · 普通文章：点赞/踩、正文字号调节、标签条、上一篇/下一篇、相关阅读

  · 外链免责声明（普通文章 / 导航文章分别开关与文案）

  · 评论区显示开关（普通文章 / 导航文章）

  · 导航详情：同道中人开关与 PC 条数、宗门声望开关与图标 HTML

  · 主题 SEO 输出模式：与插件兼容 / 主题完整输出 / 关闭

  ── 7. 分类设置 ──

  · 导航分类 / 普通分类列表每页条数（含手机端独立条数）

  · 手机端导航详情「同道中人」条数

  · 导航根分类 ID（命中后该树内分类按导航规则分页）

  ── 8. 页脚设置 ──

  · 启用页脚、禁止 F12/复制/右键（管理员豁免）

  · 页脚背景（颜色 / 图片）、双栏内容（介绍 + 网站导航 JSON 构建器）

  · 页脚搜索框、Powered 版权文案、底部自定义代码（统计等）

  · 建站运行天数、QQ/微信社交图标（分 PC / 手机）

  · 友情链接条：标题、颜色、申请按钮、友链列表表格

  · ICP / 公安备案 HTML、上线日期、性能信息、主题版权尾标

  ── 9. 评论设置 ──

  【子标签：评论设置】

  · 仅登录可评、第三方登录/注册链接、每页条数、最大层级、默认排序

  · 验证码（PC / 手机 / 游客分别控制）

  · 快捷回复、表情包、楼层标签、占位与空列表文案

  · 过滤词：自动替换、命中进审核

  · 评论频率限制：最短间隔、每小时/24 小时上限及提示文案

  【子标签：评论审核】

  · 游客 / 会员强制审核、待审核邮件通知

  · 审核提示文案、待审核评论列表（通过 / 删除 / 批量操作）

  ── 10. 广告配置 ──

  · 上述 7 个广告位各自：启用开关、电脑端内容、手机端内容

  · 支持简写（标题|链接 或 图片|链接）或整段 HTML

  ── 11. 站点统计 ──

  【子标签：本地统计】

  · 今日/昨日注册、当前/昨日在线、今日/昨日发帖与评论

  · 总文章、总会员、总评论、总访问量

  · 今日新注册会员轮播间隔

  【子标签：第三方统计】

  · 第三方统计代码（百度统计、GA 等，保存时过滤危险脚本）

  ── 12. 邮箱配置 ──

  · 启用 SMTP、主机/端口/加密、服务商快捷预设

  · 发件邮箱/显示名、SMTP 账号/密码（授权码）

  · 友链申请通知开关、通知接收邮箱

  · 发送测试邮件、端口检测

  ── 13. 友情链接审核 ──

  · 友链申请页：评论区开关、显示页面正文、通过后自动写页脚/发导航文章

  · 前台「江湖提示」轮播文案

  · 申请页站点分类：系统全部 / 自定义 ID 列表

  · 申请列表：待审核 / 已通过 / 已驳回，支持通过、驳回、删除

四、主题使用须知

--------------------------------------------------------------------------------

  【安装与启用】

  1. 将主题文件夹置于 zb_users/theme/jx_nav_ultimate（文件夹名须与 theme.xml

     中 <id> 一致）。

  2. 在 Z-Blog「网站设置 → 主题管理」中启用「剑侠导航 Ultimate」并保存。

  3. 进入「剑侠导航」配置页填写各标签选项，点击「保存设置」。

  4. 建议保存后执行「重建模板 / 缓存」，避免 compiled 缓存残留旧路径。

  【导航文章发布】

  · 在文章编辑页「导航站点」中同时填写「宗门通道（站点网址）」与「图标 URL」

    即走导航详情版式；详情左侧大封面使用「正文封面图」字段。

  · 在「分类设置」中配置「导航根分类 ID」，使导航类分类列表使用导航卡片样式

    与独立分页条数。

  【友情链接申请】

  · 在 Z-Blog 后台「新建独立页面」，模板选择「友情链接申请」。

  · 在「首页配置」或「页脚设置」中填写申请页链接；审核在「友情链接审核」标签。

  【侧栏模块】

  · 在 Z-Blog「模块管理」中将主题模块拖入 sidebar1 / sidebar7 / sidebar8 /

    sidebar9 对应侧栏区域后前台生效。

  【SEO 插件共存】

  · 若已安装 SEO 插件，建议在「文章页设置 → 主题 SEO 输出」选「与插件兼容」

    避免 canonical、OG 等标签重复。

  【目录更名说明】

  · 若曾使用旧 ID「JianxiaNav」，改名为 jx_nav_ultimate 后请重新选择主题并

    重建缓存；主题会尝试合并旧配置，不覆盖新 ID 下已保存项。

  【运行环境】

  · 最低 PHP 5.6；建议使用 PHP 7.4+ 以获得更好性能与安全更新。

  · 导航详情访客图表依赖 ECharts CDN；SMTP 发信需服务器支持相应端口。

  【升级建议】

  · 升级主题前请备份 zb_users/theme/jx_nav_ultimate 及 data 目录下 JSON 数据。

  · 以 theme.xml 与应用中心版本为准核对功能变更。

五、版权声明

--------------------------------------------------------------------------------

  本主题「剑侠导航 Ultimate」（jx_nav_ultimate）由剑侠君原创开发，版权归作者

  剑侠君所有。

  · 仅限通过剑侠源码官网（https://www.jianxiaym.com/）获取的正版授权使用。

  · 禁止未经授权的二次分发、倒卖源码、去除版权信息或恶意篡改后对外发布。

  · 主题模板内保留的版权注释请勿擅自删除，违者作者保留追究相关权益的权利。

  · 本主题按「现状」提供，作者不对因使用、修改主题而产生的任何直接或间接

    损失承担法律责任；站点内容、外链、友链及用户提交数据由站长自行负责。

  · 主题内「禁止 F12 / 复制」等前端脚本仅作轻度防护，无法替代正规内容授权

    与法律合规措施。

六、主题作者

--------------------------------------------------------------------------------

  作者名称：剑侠君

  剑侠源码官网：https://www.jianxiaym.com/

  联系邮箱：[email protected]

  主题名称：剑侠导航 Ultimate

  主题 ID：jx_nav_ultimate

  当前版本：2.5.2

  发布日期：2026-05-12

  剑侠源码网（jianxiaym.com）专注于 Z-Blog 原创主题与插件开发、AI 整合资源

  分享，为站长提供纯净、高效、极具个性的网站建设解决方案。

  ── 获取与支持 ──

  · 官方下载与更新：https://www.jianxiaym.com/

  · 主题问题、定制需求请通过官网联系剑侠君

================================================================================

  本文档随主题发布，便于交付、上架说明与站长查阅。

  若 theme.xml 或应用中心有版本更新，以包内 theme.xml 实际内容为准。

================================================================================