yuntrail_theme 主题 手机扫码预览二维码
手机扫码预览
预览演示

yuntrail_theme 主题

v2.8.1 现代化 稳定迭代

面向旅游线路 / 跟团游 / 定制游业务的 WordPress 块主题

价格、天数、人气、费用包含 / 不含、预订须知、出行攻略都是路线自带字段——不需要用「文章 + 自定义 HTML」硬拼线路页。

官网唯一售价 ¥268

售价包含以下

  • 协助安装WordPress
  • 协助备案
提交工单

主题定位

yuntrail_theme 是面向旅游线路 / 跟团游 / 定制游业务的 WordPress 块主题(Block Theme / FSE)。 它把「线路」当作一等公民来建模:价格、行程天数、费用包含与不含、预订须知、出行攻略都是路线自带的字段, 首页与详情页围绕「看线路 → 问价格 → 下单预订」这条动线组织,而不是通用博客套壳。

适合

  • 旅行社 / 地接社 / 定制游工作室的线路展示站
  • 需要按目的地分组(如「云南线」「国内游 / 亲子游」)组织线路的站点
  • 希望用 WordPress 后台运营、不依赖页面构建器插件的团队

不适合

  • 纯电商商品站(主题没有购物车 / 订单 / 支付,预订动作以「跳转预订页 / 咨询」为主)
  • 纯博客 / 资讯站(可以做,但首页与详情页为线路场景设计)

二、技术底座

层 选型 说明
主题类型 WordPress 块主题(FSE) 模板为 templates/*.html,站点头部 / 页脚为 parts/*.html,支持站点编辑器
样式 Tailwind CSS v4 + daisyUI 5 源码用语义 token(src/css/tokens.css),不写原子类;明暗主题由 data-theme 驱动
图标 lucide PHP 侧服务端直出 SVG(kgz_lucide_icon_svg()),后台图标选择器可选 26 个常用图标
轮播 Swiper 14 全站单例(assets/js/swiper-init.js,约 91KB),轮播块 render 时按需入队
自定义字段 Secure Custom Fields(SCF) 主题设置与内容字段全部图形化配置,后台隐藏了 SCF 的字段编辑器
构建 零依赖 node 脚本 scripts/css.mjs(postcss + cssnano)、scripts/js.mjs(esbuild),不引入 webpack / jQuery
字体 系统字体栈 不请求第三方 Web 字体,首屏无字体闪烁、无境外资源依赖

三、内容模型

1. 路线(CPT:kgz_route)

字段 用途
价格(数值)+ 价格后缀 详情页「官方售价 ¥4037 起」、卡片价格行、结构化数据 Offer.price
行程天数 卡片徽章与详情页标题旁「5天4晚」
人气信息 卡片价格行灰字「近期46人出游」
推荐标签(最多 2 个,可选色板) 卡片与详情页标题旁的胶囊
一句话简介 / 卖点描述 详情页首屏主色行 / 加粗段落
费用包含 / 费用不含 详情页「费用说明」tab 两栏(✓ / ✕)
热门角标 卡片火焰角标 + 进入首页「爆款主推」
预订须知 路线级退改政策,留空回退站点默认
关联攻略分类 详情页「出行攻略」tab 的文章来源
特色图 / 正文 / 页面属性排序 卡片封面、行程详情 tab、首页与列表排序

2. 路线分组(层级分类法:kgz_route_cat)

  • 支持父子层级,用于「国内游 → 云南 / 亲子游」这类结构
  • 分组自带横幅字段(背景图 / 标题 / 副标题 / 标签行),分组页顶部通栏展示
  • 分组页 chips 筛选条自动生成:父组分页列出子分组、子分组页列出兄弟分组、扁平结构自动锚定到 /route/ 全站列表

3. 文章(post)与页面(page)

  • 文章:游记 / 攻略内容,新增「地点」字段,列表卡片统一为游记式(左方图 + 标题 + 摘要 + 头像·昵称·地点·日期·浏览·点赞·评论)
  • 文章分类:URL 无 /category/ 前缀(/yunnan-lines/),用于攻略 / 游记归档,也可作为路线的「出行攻略」数据源
  • 页面:三种模板——默认(标题 + 正文卡 + 侧栏)、满宽正文页(无侧栏)、空白布局页(页头页脚之间只放你插入的内容)

4. URL 体系

/route/                         全站线路列表
/route/{父分组}/{子分组}/         分组归档(层级路径)
/route/{分组路径}/{ID}.html      线路详情(末段固定用 ID,改标题不改 URL)
/{分类路径}/                     文章分类归档(无 /category/ 前缀)
/product/...                    旧前缀,301 到 /route/...(改名兼容)

四、功能全景

首页六模块(顺序即营销动线)

  1. 轮播图:多帧大图 + 标题 / 副标题 / 按钮,可配自动播放
  2. 爆款主推:勾选「热门」的线路卡横滑,一屏 1-2 张,只剩一张自动退化静态行
  3. 品牌宣传:左媒体(图 / 视频)右文案 + CTA
  4. 分组推荐:按一级分组配置多个模块,模块内 tab = 子分组,每组一横排横滑卡 + 查看更多
  5. 游记(文章列表):游记式条目,含点赞交互
  6. 特性优势:4 图标优势网格(为什么选择我们)

线路详情页

  • 首屏:特色图 + 标题 + 天数徽章 + 推荐标签 + 一句话简介 + 卖点 + 官方售价 + 人气 + 预订 / 咨询按钮行(立即预订、在线咨询、微信二维码、QQ、自定义)
  • 内容 tabs:行程详情 / 费用说明(包含 ✓ + 不含 ✕ 两栏)/ 预订须知(路线级 → 站点默认兜底)/ 出行攻略
  • 底部:推荐路线 + 特性优势通栏

列表与归档

  • 线路归档 / 分组页:横幅 + 面包屑 + 分组 chips(带条数)+ 卡片网格 + 分页
  • 文章分类:同样的结构与筛选条,卡片统一游记式
  • 搜索:文章区 + 线路区两个分区,各自独立分页

全站能力

  • 浏览量 / 点赞 / 评论 / 分享数统计(REST 计数,页面缓存友好)
  • 分享:微博 / QQ / 微信扫码 / 复制链接;分享模态
  • 浮动面板(回顶 / 微信 / 电话 / 分享)、移动端底部 dock、暗色模式切换
  • 面包屑 + 结构化数据(Organization / WebSite / Product / BlogPosting / BreadcrumbList)
  • 友情链接、页脚多列 + 备案信息、HTML 注释剥离(生产环境)

五、十大卖点

1. 旅游业务模型开箱即用

价格、天数、人气、费用包含 / 不含、预订须知、出行攻略都是路线自带字段——不需要用「文章 + 自定义 HTML」硬拼线路页。 解决的痛点:通用主题做旅游站,线路参数只能写进正文,前台无法排序、无法结构化、无法筛选。

2. 首页是一套可运营的营销序列

六个模块按转化动线排列,爆款与分组推荐都由后台数据驱动(勾热门、调排序即可换内容),不靠改代码或换模板。 解决的痛点:营销位不可控,每次换主推都要改页面。

3. 详情页是转化闭环

首屏就把「多少钱、几天、包含什么、怎么订」讲清楚;预订 / 咨询按钮行可自由增删排序,微信咨询直接弹二维码。 解决的痛点:咨询入口藏得深,游客看完价格还要找客服。

4. 路线 → 分组 → 攻略的内容闭环

线路分组支持层级;每条线路可关联攻略分类,详情页「出行攻略」tab 自动列出相关攻略文章。 解决的痛点:攻略与线路两张皮,SEO 内容无法反哺线路页停留时长。

5. SEO 内建,不用装一堆插件

  • 语义化模板 + 单 h1 + 面包屑(含 BreadcrumbList 结构化数据)
  • Organization / WebSite / Product(含 Offer 价格)/ BlogPosting 全站结构化数据,节点用 @id 互引不重复
  • 分类 / 分组级 SEO 字段(标题、描述、关键词、OG 图、noindex)
  • 文章 / 页面 / 路线级 SEO 覆盖
  • 扁平分类 URL、线路 URL 用 ID 固定、旧 /product/ 自动 301
  • 可自定义 head / footer 代码(仅 manage_options 管理员可改)

解决的痛点:主题与 SEO 插件输出两套 schema 互相打架;改 URL 结构掉收录。

6. 性能是设计出来的

  • 轮播 JS 全站单例(约 91KB),不再是每个轮播块各打包一份
  • 轮播 CSS 独立按需加载(约 12KB,仅轮播页加载)
  • 块样式按块出现与否加载,资源版本用 filemtime 自动失效
  • 无 jQuery、无 Web 字体、无第三方 CDN 依赖 解决的痛点:首页三个轮播 = 三份 Swiper(约 280KB)的老问题。

7. 页面缓存友好

浏览量 / 点赞 / 分享计数走 REST beacon,不在渲染期直增;点赞按压态由前端 localStorage 恢复(缓存 HTML 永远中性态);缓存页 nonce 过期时后端自动降级为同源校验,计数不会因缓存失效。 解决的痛点:开整页缓存后计数器不动、访客看到别人的点赞状态。

8. 安全基线(2.8.1 安全审计后)

  • 输出全量转义、富文本字段 wp_kses_post 白名单
  • 计数写接口 nonce + 同源校验,禁止匿名可写
  • SEO head / footer 代码字段 UI + 保存层双层 manage_options
  • 迁移脚本 CLI 守卫(Web 访问 403)
  • 二维码端点仅允许本站域名 + IP 限流 解决的痛点:主题层的存储型 XSS、CSRF、未授权写入。

9. 后台全图形化,运营能自己改

主题设置七个页签(基础 / 首页 / 路线 / 分享 / 底部 / 浮动面板 / SEO)全部 SCF 图形面板;颜色改一个主色即全站联动(明暗两套自动派生)。 解决的痛点:改文案改颜色都要找开发。

10. 可维护、可交接

30 个动态块、统一的 kgz_ 命名与目录结构、中文注释记录「为什么这样写」、AGENTS.md 开发者文档、prettier + 构建脚本、docs/ 与迁移脚本齐备。 解决的痛点:主题交接给下一位开发者就失传。

六、性能与兼容一览

项目 说明
WordPress 6.6+(block API v3、Requires Plugins 声明)
PHP 8.0+,在 8.1-8.3 语义下开发(无废弃函数 / 无动态属性告警)
浏览器 现代常青浏览器;overflow: clip 不支持的旧内核有 hidden 兜底
轮播资源 Swiper JS 单例约 91KB + 轮播 CSS 约 12KB(仅轮播页)
首屏资源 main.css / main.js + 块样式(按需);无 jQuery、无 Web 字体
无障碍 语义 landmark、aria 状态、键盘可达、prefers-reduced-motion 降级
暗色模式 <html data-theme> 切换,首屏绘制前注入防闪烁,纯 CSS 变量

七、目录结构

yuntrail_theme/
├─ blocks/            30 个动态块(block.json + render.php,部分带 helpers.php)
├─ inc/               PHP 逻辑:post-types / scf(字段与设置)/ share / metrics /
│                     schema / breadcrumb / enqueue / search / category-base …
├─ templates/         11 个块模板(首页 / 归档 / 详情 / 页面 / 搜索 / 404)
├─ parts/             头部 / 页脚 / 文章 meta 行 / 评论区
├─ src/               样式与脚本源码(css / js / blocks / admin)
├─ assets/            构建产物(浏览器实际加载的文件)
├─ scripts/           构建脚本 + 数据迁移脚本(生产包不包含)
├─ languages/         翻译文件目录(textdomain: kuaigouzao)
├─ docs/              本套文档
├─ theme.json         全局样式与模板声明
├─ style.css          主题头信息
└─ functions.php      主题引导

一、适用范围

本须知适用于块构造在本站出售的全部数字产品与技术服务。

数字产品:WordPress 主题、插件及其授权。 技术服务:企业官网搭建、小程序开发、服务器运维、网站优化与推广。


二、交付方式

数字产品 付款后即时开通下载权限或发放授权码,交付内容包括:安装包、授权信息、安装说明。需要协助部署的,可在工作时间内提交工单,由我们远程协助。

技术服务 按项目节点交付。签约后提供需求确认单,开发完成后交付源码、后台账号与操作说明,验收通过即为交付完成。交付形式为线上交付,不提供线下介质。


三、授权范围

  • 数字产品授权绑定购买时的域名或站点,一个授权对应一个站点。多站点使用需另行购买授权。
  • 授权归购买方所有,可自用、可修改源码用于自身项目,但不得转售、不得再分发、不得用于二次开发后对外销售。
  • 技术服务交付的源码与设计文件,版权在尾款结清后归委托方所有;我们保留在作品集、案例展示中使用的权利,如不希望展示请在签约时说明。

四、退款政策

数字产品 数字产品属于在线下载的数字化商品,依据《消费者权益保护法》第二十五条,不适用七日无理由退货。

未下载、未激活的订单,付款后 7 日内可申请全额退款;已下载或已激活的订单,除文件损坏、授权异常等功能性问题外,不予退款。功能性问题经核实后,可选择修复或退款。

技术服务

  • 尚未开工:全额退款。
  • 已完成需求确认、尚未进入开发:扣除已发生的方案与设计成本后退款。
  • 已进入开发阶段:按已完成进度结算,剩余部分退还。
  • 定制类项目开工后,因委托方单方面取消造成的损失,按合同约定处理。

五、价格与发票

站内标价为不含税价格,如需发票请在付款前告知抬头与税号,我们按实际开票类目开具。项目类服务以合同金额为准,站内标价仅作参考。


六、技术支持

  • 数字产品提供 12 个月技术支持,范围为安装配置、功能使用、与常见环境的兼容问题。
  • 技术服务提供 12 个月缺陷修复,范围为交付功能本身的错误;新增需求、界面改版、第三方平台规则变化导致的调整,另行报价。
  • 响应时间:工作日 24 小时内答复。紧急故障(站点无法访问、支付异常)优先处理。

七、几点说明

  • 我们不承诺任何搜索引擎或 AI 平台的收录、排名、引用结果,这类结果由平台规则决定,我们能做的是把技术基础做对。
  • 因客户自行修改源码、安装第三方插件、未按说明升级环境导致的问题,不在免费支持范围内,可付费处理。
  • 服务器、域名、短信、地图等第三方服务的费用与合规责任,由购买方承担。

八、联系与争议

购买前有疑问,建议先联系我们确认需求再下单。售后问题请通过站内工单或订单留言提交,我们按提交顺序处理。发生争议时,双方优先协商解决。

面向站点运营与实施人员。开发向文档(构建链、硬契约、块开发)见仓库根目录 AGENTS.md。

一、环境要求

项目 要求
WordPress 6.6 及以上
PHP 8.0 及以上(推荐 8.1-8.3)
必装插件 Secure Custom Fields(secure-custom-fields,主题已声明为必需依赖)
可选扩展 PHP GD(本地生成分享二维码;缺失时自动回退外网二维码服务)
可选插件 Simple Custom Post Order(后台拖拽排序路线)、拼音别名插件(中文标题生成英文 slug)

二、安装与启用

  1. 后台上传主题 zip(或把 yuntrail_theme 目录放进 wp-content/themes/)
  2. 启用主题;若未安装 Secure Custom Fields,按提示安装并启用
  3. 进入 设置 → 固定链接,点一次「保存更改」(刷新重写规则,线路 URL 才会生效)
  4. 后台左侧出现 主题设置 菜单,按「首次配置」顺序填写

三、首次配置清单(按顺序)

步骤 位置 做什么
1 设置 → 常规 / 阅读 站点标题、副标题;首页显示「最新文章」即可(首页模板会自动接管)
2 外观 → 菜单 建主菜单,分配到「主菜单」位置;可把线路分组、攻略分类、页面加进菜单
3 主题设置 → 基础 品牌名、Logo、主色、面包屑开关、分页数量、全站兜底横幅
4 线路 → 路线分组 建立层级分组(如「国内游 → 云南」),填写分组横幅
5 线路 → 新增路线 逐条录入线路(字段见第四节),设特色图与排序
6 主题设置 → 首页 配轮播图、爆款主推、品牌宣传、分组推荐、游记、特性优势
7 主题设置 → 路线 预订按钮行(立即预订 / 咨询)、站点默认预订须知、推荐路线数量
8 主题设置 → 分享 / 底部 / 浮动面板 分享目标开关、页脚多列与备案、浮动面板按钮
9 主题设置 → SEO 结构化数据开关、默认 SEO 文案、head/footer 代码
10 文章 → 分类 建攻略 / 游记分类(URL 自动无 /category/ 前缀)
11 发布几篇文章 填「地点」字段,首页游记与文章列表即生效

四、内容管理

1. 路线(后台菜单「路线」)

新增 / 编辑路线时,正文下方的「路线信息」面板:

字段 怎么填 前台效果
价格(元) 纯数字,如 4037;免费 / 面议留空 「官方售价 ¥4,037 起」+ 结构化数据价格
价格后缀 默认「起」,可改「起/人」 紧跟价格的小字
行程天数 如 5天4晚,可留空 卡片价格行徽章 + 详情页标题旁
人气信息 如 近期46人出游,可留空 卡片价格行灰字 + 详情页价格行
推荐标签 最多 2 个,每个选色板颜色 卡片与详情页标题旁的胶囊
一句话简介 40 字以内一句话 详情页首屏主色行
卖点描述 2-3 行行程亮点 详情页首屏加粗段
费用包含 3-8 项(图标可选 / 文本必填) 详情页「费用说明」左栏 ✓
费用不含 建议至少 2-3 项 详情页「费用说明」右栏 ✕
热门角标 打开 卡片火焰角标 + 进入首页「爆款主推」候选
预订须知 该线路的退改政策(富文本) 详情页「预订须知」tab(留空用站点默认)
关联攻略分类 选一个文章分类 详情页「出行攻略」tab 文章列表

其余:特色图 = 卡片封面 / 详情页首屏图;正文 = 「行程详情」tab;页面属性 → 排序 控制卡片顺序(首页爆款与列表都按此排序,越小越前)。

2. 路线分组(层级分类法)

  • 支持父子层级:父分组页列出子分组 chips,子分组页列出兄弟分组 chips,每个 chip 带条数
  • 分组编辑页的「分组横幅」字段:背景图、标题、副标题、标签行(留空逐级回退到「主题设置 → 基础 → 横幅」)
  • 扁平结构(没有子分组)时,分组页 chips 自动改为列出所有一级分组 +「全部」入口
  • 分组编辑页的「SEO」字段:自定义标题 / 描述 / 关键词 / OG 图 / noindex

3. 文章与分类

  • 文章新增「地点」字段(如「云南 · 大理」),显示在列表卡片信息行
  • 文章列表卡片统一为游记式:左方图 + 标题 + 两行摘要 + 头像·昵称·地点·日期·浏览·点赞·评论
  • 手动摘要优先;不填则自动截取正文前 64 字
  • 分类归档页顶部横幅、筛选条、每页数量均由主题设置与分类字段控制

4. 页面模板

模板 用途
默认模板 标题 + 正文卡 + 右侧栏(侧栏含分类导航与推荐文章)
满宽正文页(无侧栏) 正文占满容器,适合「关于我们」「服务条款」
空白布局页 页头页脚之间只渲染你插入的区块,适合完全自定义的落地页

五、首页模块配置(主题设置 → 首页)

面板 数据来源 建议
轮播图 手动添加帧(图 / 标题 / 副标题 / 按钮 / 链接) 3-5 帧;首帧放当季主推
爆款主推 勾了「热门角标」的路线,按「排序」升序取前 N 数量 6-8;没有热门时整块不显示
品牌宣传 左侧图片或视频 + 右侧标题 / 描述 / 按钮 视频建议 mp4,大小控制在 5MB 内
分组推荐 每个模块选一个一级分组;模块内 tab 自动取子分组 2-3 个模块;每组数量 8;可配「查看更多」文案 / 链接
游记(文章列表) 最新文章(可限定分类) 4-6 篇;只选一个分类时「查看更多」自动指向该分类
特性优势 手动添加图标 + 标题 + 描述 4 项最佳(PC 一排四个)

所有模块关闭开关或数据为空时前台整块不输出,不会留空白占位。

六、主题设置逐页说明

  • 基础:品牌名 / Logo / 主色(改一个色,全站主色与色阶自动派生,明暗两套)/ 面包屑开关与适用内容类型 / 分页数量(文章、路线各自)/ 全站兜底横幅
  • 首页:见上一节
  • 路线:预订按钮行(可增删排序:立即预订 / 在线咨询 / QQ / 微信 / 自定义链接;微信需上传二维码图)/ 站点默认预订须知 / 推荐路线数量与标题
  • 分享:总开关;按入口开关——路线详情页标题行图标、浮动面板(仅首页);文章 / 页面底部统计条的分享项随总开关生效(v2.6 起由统计条接管,旧的「文章页 / 页面页」独立入口已移除);各分享目标开关(微博 / QQ / 微信 / 复制链接)
  • 底部:站点简介、页脚多列链接、二维码、备案与法律链接、版权文案(支持 {year} 与 {site_title} 占位符)
  • 浮动面板:回顶按钮开关与图标;渠道 repeater(在线咨询 / QQ / 微信 / 电话,可增删排序);移动端显示模式
  • SEO:结构化数据总开关、默认标题分隔符、默认描述、分类 / 文章 SEO 覆盖、head / footer 自定义代码(仅 manage_options 管理员可编辑)

七、详情页行为

  • 首屏:特色图、标题、天数徽章、推荐标签、一句话简介、卖点、官方售价、人气、预订按钮行
  • 内容 tabs(数据为空自动隐藏对应 tab):
    • 行程详情 = 路线正文
    • 费用说明 = 费用包含 ✓ + 费用不含 ✕ 两栏
    • 预订须知 = 路线级「预订须知」,留空回退「主题设置 → 路线 → 路线详情页」的站点默认
    • 出行攻略 = 「关联攻略分类」下的文章(日期 + 标题 + 摘要)
  • 底部:推荐路线(勾热门的优先 → 页面属性排序 → 发布时间)+ 特性优势

分享:路线详情页标题旁有分享图标(受「分享」入口开关控制);文章 / 页面底部统计条含分享按钮与分享数。

八、搜索页

搜索结果分两区:文章区(游记式卡片,标准分页)+ 线路区(路线卡网格,独立分页)。两区互不影响页码。 搜索范围只含文章与路线,页面与文档不会被搜到。

九、SEO 与结构化数据

  • 主题输出 Organization(含站点 logo、联系方式)、WebSite(首页)、Product(路线详情,含 Offer 价格)、BlogPosting(文章)、BreadcrumbList(面包屑)
  • 如果同时使用第三方 SEO 插件:请在插件里关闭其结构化数据输出,否则同页会出现两套实体
  • 分类 / 分组 / 文章 / 页面 / 路线都有独立 SEO 字段,留空回退到「主题设置 → SEO」默认值
  • head / footer 自定义代码字段:低权限用户只读,保存层也会静默拒绝,避免脚本注入

选择块构造,理由足够震撼

专注 WordPress、ThinkPHP、uni‑appX 定制开发,从品牌视觉到线上推广,一站式落地你的数字化项目

全栈定制开发能力
深耕 WordPress、ThinkPHP、uni‑appX 开发,从网站到跨端应用,按需定制,拒绝模板化流水线产品。
品牌视觉一体化打造
平面设计配套建站服务,网站素材、宣传物料原创设计,品牌形象统一,强化客户记忆。
稳定高性能部署方案
服务器环境搭建、缓存与安全加固,全站多端适配,PC / 平板 / 手机访问稳定流畅,加载迅速。
一站式全链路技术托管
从品牌知识产权、广告投放,到网站运维迭代,全流程配套服务,交付后持续技术护航。