灵狐导航主题（FoxNav Pro)

# FoxNav Pro 主题使用说明 ## 概述 FoxNav Pro 是一个强大的 WordPress 导航主题，集成了灵狐框架（Fox Framework），提供了完整的后台配置选项，让您无需编写代码即可自定义网站的各个方面。 ## 主要特性 ### 1. 灵狐框架集成 - 强大的后台配置面板 - 可视化的选项设置 - 实时预览功能 - 支持导入/导出配置 ### 2. 模块化设计 主题采用模块化设计，所有页面区块都可以独立控制： - 头部导航 - Banner横幅 - 热门内容 - 左侧导航 - 主内容区 - 新闻资讯 - 页脚区域 ### 3. 动态内容调用 所有内容都从 WordPress 数据库动态获取： - 自动读取文章分类 - 动态显示文章列表 - 支持自定义文章类型 - 灵活的查询参数 ## 主题选项配置 进入 WordPress 后台 → **灵狐主题设置**，您可以看到以下配置选项： ### 使用说明 主题的基本介绍和使用提示。 ### 图标设置 - **站标设置**：浏览器标签页显示的图标（建议尺寸：128×128） - **网站Logo**：网站头部显示的Logo图片 ### 基本设置 - **开启基础设置**：总开关 - **网站欢迎语**：显示在特定位置的欢迎文字 - **网站公告**：富文本编辑器，支持HTML ### SEO设置 - **网站名称**：显示在标题栏的网站名称 - **网站关键词**：多个关键词用英文逗号分隔 - **网站描述**：网站的简短描述 ### 头部设置 - **网站Logo**：头部Logo图片（建议尺寸：410×167） - **网站标题**：Logo旁边的文字标题 - **显示头部菜单**：是否显示顶部导航菜单 - **头部按钮文字**：右上角按钮的文字 - **头部按钮链接**：按钮点击后跳转的URL - **头部按钮图标**：使用RemixIcon图标类名 ### Banner设置 - **显示Banner横幅**：是否显示首页Banner区域 - **Banner背景颜色**：Banner的背景色 - **Banner标题**：大标题文字 - **Banner副标题**：副标题文字 - **Banner背景视频**：上传MP4格式的背景视频 - **显示搜索框**：是否显示搜索功能 - **搜索框占位符**：搜索框的提示文字 ### 热门内容设置 - **显示热门内容模块**：是否显示该模块 - **模块标题**：模块的标题文字 - **模块描述**：模块的描述文字 - **模块背景颜色**：模块的背景色 - **显示数量**：显示多少篇文章 ### 左侧导航设置 - **显示左侧导航**：是否显示左侧分类导航 - **导航标题**：导航区域的标题 - **允许收缩导航**：是否允许用户收缩导航 ### 主内容区设置 - **显示主内容区**：是否显示主要内容区域 - **主内容区背景**：背景颜色 - **每个分类显示数量**：每个分类显示多少篇文章 - **网格列数**：选择3列、4列或5列布局 ### 新闻资讯设置 - **显示新闻资讯模块**：是否显示该模块 - **模块标题**：模块的标题文字 - **模块描述**：模块的描述文字 - **模块背景颜色**：模块的背景色 - **显示数量**：显示多少篇新闻 ### 页脚设置 - **页脚Logo**：页脚区域的Logo图片 - **关于我们标题**：关于我们区块的标题 - **关于我们描述**：关于我们的文字描述 - **版权信息**：页脚的版权声明 - **ICP备案号**：网站备案号 - **公安备案号**：公安备案号 ### 颜色设置 - **主题色**：网站的主色调 - **导航背景色**：导航栏的背景颜色 - **导航文字颜色**：导航栏的文字颜色 ## 菜单设置 进入 WordPress 后台 → **外观** → **菜单**，您可以创建和管理以下菜单位置： 1. **顶部导航**：网站头部的主导航菜单 2. **页脚菜单1-4**：页脚的四列菜单 3. **友情链接**：页脚的友情链接区域 4. **页脚底部菜单**：页脚底部的链接菜单 5. **移动端菜单**：移动设备显示的菜单 ## 自定义文章类型 主题包含以下自定义文章类型： ### Site（导航站点） 用于发布导航工具/网站信息。 **自定义字段：** - `site_icon`：站点图标/Logo - `site_url`：站点外链地址 - `is_featured`：是否精选 - `is_hot`：是否热门 - `views`：浏览次数 **分类法：** - `tool_category`：工具分类 ### FriendLink（友情链接） 用于管理友情链接。 ## 辅助函数 主题提供了丰富的辅助函数，方便二次开发： ### 获取主题选项 ```php foxnav_get_option($key, $default = '') ``` ### 获取网站Logo ```php foxnav_get_logo() ``` ### 获取主题色 ```php foxnav_get_main_color() ``` ### 获取分类列表 ```php foxnav_get_terms($taxonomy = 'tool_category', $args = array()) ``` ### 获取分类下的文章 ```php foxnav_get_posts_by_term($term_id, $taxonomy = 'tool_category', $posts_per_page = 16, $post_type = 'site') ``` ### 获取热门文章 ```php foxnav_get_hot_posts($count = 20, $post_type = 'site') ``` ### 获取最新文章 ```php foxnav_get_latest_posts($count = 10, $post_type = 'post') ``` ### 渲染工具卡片 ```php foxnav_render_tool_card($post, $show_feature = true) ``` ### 渲染新闻卡片 ```php foxnav_render_news_card($post) ``` ## 文件结构 ``` foxnav-pro/ ├── inc/ # 核心功能文件 │ ├── fox-framework/ # 灵狐框架 │ ├── fox-settings.php # 主题选项配置 │ ├── theme-helpers.php # 辅助函数 │ ├── setup.php # 主题初始化 │ ├── cpt-site.php # 自定义文章类型：站点 │ ├── cpt-friendlink.php # 自定义文章类型：友链 │ ├── taxonomies.php # 自定义分类法 │ ├── meta-boxes.php # 自定义字段 │ └── ... ├── template/ │ └── two/ # 模板文件 │ ├── index.php # 主模板文件 │ ├── header.php # 头部模板 │ ├── banner.php # Banner模板 │ ├── hot-content.php # 热门内容模板 │ ├── left-nav.php # 左侧导航模板 │ ├── main-content.php # 主内容区模板 │ ├── news.php # 新闻模块模板 │ └── footer.php # 页脚模板 ├── static/ # 静态资源 │ ├── css/ │ ├── js/ │ └── picture/ ├── functions.php # 主题函数文件 ├── index.php # WordPress入口文件 └── style.css # 主题样式表 ``` ## 使用步骤 ### 1\. 安装主题 1. 将主题文件夹上传到 `wp-content/themes/` 目录 2. 在 WordPress 后台启用主题 ### 2\. 配置基本信息 1. 进入 **灵狐主题设置** 2. 依次配置各个选项卡的内容 3. 上传Logo、图标等图片 4. 设置SEO信息 ### 3\. 创建菜单 1. 进入 **外观** → **菜单** 2. 创建主导航菜单并分配到"顶部导航"位置 3. 创建页脚菜单并分配到相应位置 ### 4\. 添加内容 1. 创建工具分类（tool\_category） 2. 发布导航站点（Site文章类型） 3. 发布新闻文章（Post文章类型） ### 5\. 自定义样式（可选） 如需自定义样式，可以： 1. 使用主题的颜色设置选项 2. 在子主题中添加自定义CSS 3. 使用WordPress自定义器 ## 常见问题 ### Q: 如何修改主题颜色？ A: 进入 **灵狐主题设置** → **颜色设置**，修改主题色、导航背景色等。 ### Q: 如何添加新的工具分类？ A: 进入 **站点** → **工具分类**，添加新分类。分类会自动显示在左侧导航和主内容区。 ### Q: 如何设置分类图标？ A: 编辑分类时，可以在自定义字段中设置 `term_icon`，使用RemixIcon图标类名。 ### Q: 如何隐藏某个模块？ A: 在 **灵狐主题设置** 中找到对应模块，关闭"显示XX模块"开关即可。 ### Q: 如何修改网格列数？ A: 进入 **主内容区设置**，选择3列、4列或5列布局。 ## 技术支持 * 主题官网：https://www.xintheme.com * 技术支持：通过主题官网联系我们 * 文档中心：查看更多详细文档 * 开发速查：参见 [FOX-FRAMEWORK-QUICKSTART.md](./FOX-FRAMEWORK-QUICKSTART.md) ## 更新日志 ### Version 1.0.0 * 初始版本发布 * 集成灵狐框架 * 完整的后台配置选项 * 模块化模板系统 * 动态内容调用 * 响应式设计 *** 感谢您使用 FoxNav Pro 主题！ ``` ```