源码系统概览
文章正文
这套源码属于 WordPress 网址导航主题，主题名为 Yowao Navigation Pro，中文叫要哇棱镜导航主题。
前台是一套单页式导航界面，围绕网址卡片、私有书签、搜索框和登录注册展开，视觉上走玻璃拟态风格。
作者在 README 里声明基于 GPL v3 开源，允许自由使用、修改甚至去掉署名，适合想自建导航站的站长直接改造。
源码简介
这份免费源码是一套可以直接放进 wp-content/themes 的导航主题，适合学习 WordPress 自定义文章类型和前台交互接口的写法。
主题目录结构很紧凑，只有 index.php、functions.php、404.php、style.css 以及 assets 和 weather 两个子目录。
functions.php 中用 register_post_type 注册了 yowao_app 与 yowao_bookmark 两种内容类型，分别对应后台的网址导航和用户私有收藏。
style.css 头部标注版本 1.0.0，说明中提到 Tailwind CSS 与 CSRF 防护，assets/js 目录下已经本地放好 tailwind.js 和 vue.js。
weather 子目录里另有一套独立的天气查询脚本，配合本地缓存文件为首页提供城市天气展示。
适用场景
- 搭建个人或团队的网址导航站、常用工具入口页
- 学习 WordPress 自定义文章类型、后台设置页和 AJAX 接口的写法
- 在导航站基础上二次开发会员书签、点赞排行一类的互动功能
功能亮点
- 网址与书签管理：functions.php 注册 yowao_app、yowao_bookmark 两种文章类型，并用 add_meta_box 挂出「网址设置」和「收藏设置」表单
- 接口统一校验：前台动作先由 wp_create_nonce(‘yowao_frontend_action’) 下发票据，各个处理函数都调用 check_ajax_referer 校验来源
- 邮箱注册与找回密码：源码中包含 y_send_reg_code、y_register_v67、y_reset_pwd 等动作，验证码和重置链接通过 wp_mail 发送
- 互动统计：可见 y_like_app、y_get_app_likes、y_click_bookmark 等点赞与点击统计接口
- 访问优化：头像地址替换成 cravatar.cn，站点图标由 y_get_favicon 抓取后缓存到 uploads/yowao/favicons 目录
- 后台设置页：「主题设置」菜单可配置 Logo、ICP 备案号与链接、页脚版权、统计代码、SEO 描述与关键词、搜索引擎列表以及邮箱注册开关
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端：本地化的 Tailwind CSS 与 Vue，图标使用主题内置的 Font Awesome 字体文件。 | 依具体方案选型，需自行搭建与维护 |
| 部署方式 | 1. 把 yowao-theme 目录上传到 /wp-content/themes/，或者在后台「外观」→「主题」里上传 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 网址与书签管理：functions.php 注册 yowao_app、yowao_bookmark 两种文章类型，并用 | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
前端：本地化的 Tailwind CSS 与 Vue，图标使用主题内置的 Font Awesome 字体文件。
后端：PHP + WordPress 主题，业务逻辑集中在 functions.php 与 index.php 两个文件。
数据库：随 WordPress 使用 MySQL，网址和书签以自定义文章类型存储。
运行环境：README 建议 PHP 7.4 或 8.0 以上，并要求 /wp-content/uploads/ 目录可写。
其他依赖：邮件功能需要自行配置 SMTP，README 推荐搭配 WP Mail SMTP 插件。
安装与部署提示
1. 把 yowao-theme 目录上传到 /wp-content/themes/，或者在后台「外观」→「主题」里上传压缩包后启用。
2. 启用主题后进入「设置」的固定链接页面点一次保存，刷新伪静态规则，避免网址和书签页面出现 404。
3. 到后台「主题设置」填写 Logo、备案号和 SEO 信息，并按需要开启或关闭邮箱验证码注册。
4. 想换壁纸时，把图片放进 assets/img/bg/ 目录，前台会自动读取该目录下的图片随机展示。
截图与演示说明
第一张是主题包自带的 screenshot.png，对应启用主题后前台首页的整体版式。
第二张是仓库根目录的展示图，可以看到超大时钟、搜索框和玻璃质感的网址卡片排布。
本地部署后建议再补充后台「网址导航」列表页、网址编辑页里的「网址设置」表单，以及「主题设置」配置页的截图。
常见问题
问：新增的网址和书签页面打不开，提示 404 怎么办？
答：这是伪静态规则没有刷新导致的；进入后台「设置」的固定链接页面，不用改任何选项，直接保存一次即可。
问：注册验证码收不到邮件是什么原因？
答：验证码走 WordPress 的 wp_mail 发送，默认 PHP 邮件基本发不出去；按 README 装好 SMTP 插件并填对授权码后再测试。
安全风险提示
本源码有几处需要留意的地方，部署前建议先处理：
路径：yowao-theme/weather/weather.php
类型：独立入口文件与远程抓取
证据：该文件不经 WordPress 引导即可被直接访问，会按 GET 参数 city 抓取 m.weather.com.cn 数据并写入同级 cache 目录
建议：不需要天气模块时直接删除 weather 目录，或用服务器规则限制它被外部访问
路径：yowao-theme/weather/getip.php
类型：老旧代码兼容风险
证据：使用 PHP4 风格构造函数配合纯真 IP 库 CoralWry.dat，在 PHP 8 环境下会直接报错
建议：不使用 IP 定位功能时一并删除，确需保留请改写为新语法
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
主题涉及用户注册、邮箱验证码和私有书签等个人信息处理环节，上线前请补齐隐私政策与邮件发送配置，并遵守个人信息保护法及相关平台规范。