YMX正式版本发布

**YMX 主题 1.0 正式版**现已发布。YMX 是一款基于 WordPress 开发、面向内容型站点的综合主题，采用**模块化架构**与**可视化的后台设置中心**，把首页、列表、文章、会员、评论、SEO、广告、客服等常用功能全部做成了「开箱即用、后台可配」的形式。无论你是做资讯站、博客、专题站还是带会员互动的社区型站点，都可以在后台完成大部分配置，无需修改代码。

下面从「**核心功能**」「**配置流程**」「**使用方法**」三个方面，完整介绍 1.0 正式版。

—

## 一、核心功能一览

YMX 主题的功能集中后台「**主题设置**」里，按功能划分为多个设置页（Tab），以下为主要能力：

### 1. 基础与外观

– 日间 / 夜间模式一键切换，可设置「默认夜间」；

– 前台多语言：简体中文 / 繁体中文 / English；

– Logo 图片、夜间 Logo、纯文字 Logo、品牌文字、登录页 Logo；

– 网页最大宽度、底部信息、建站起始年份、底部推广区；

– 全站变灰、手机导航、电脑 / 手机搜索开关、顶部用户栏开关；

– 禁止复制、头像服务器、自动首图缩略图、外链缩略图、随机默认缩略图；

– 货币符号、点赞登录限制、阅读量简化、中文用户名、性能信息等。

### 2. 首页模块

– 通栏轮换图（最多 5 张）、焦点图（最多 5 张）；

– 微分类、首页排除分类、最新发布、公告模块；

– 首页各模块可自由开关、自由排版组合。

### 3. SEO 与内容优化

– 首页标题 / 关键词 / 描述自定义，文章自定义 SEO；

– 分类 URL 去除 `category`、外链自动 `nofollow`、面包屑导航；

– 标签 SEO、专题 SEO 等。

### 4. 列表与加载

– 图文 / 文字两种列表模式；

– 缩略图异步加载、分页无限加载；

– 列表相关小部件自由开关。

### 5. 文章增强

– 阅读数、点赞、打赏、相关文章、文章来源、版权提示；

– 文章图片弹窗、长文自动隐藏、手机端表格滚动；

– 发布时间与更新提示、标签、作者介绍、上下篇导航、段落缩进；

– 文章 OG 分享代码等。

### 6. 会员与互动

– 会员中心、用户投稿、找回密码页、邮箱白名单；

– 评论审核邮件通知、腾讯云人机验证码（登录 / 注册 / 评论）；

– 三方登录（QQ / 微信 / 微博）与短信验证码登录（详见下文）。

### 7. 专题体系

– 专题首页、首页专题模块、专题默认图等，适合做合集 / 栏目聚合。

### 8. 客服、分享与社交

– 客服按钮：回顶、QQ、电话、微信、自定义客服、WhatsApp、Telegram；

– 分享按钮：微信、微博、QQ、QQ 空间、Line、X、Facebook、Telegram、Skype；

– 社交关注：关注本站、微信二维码、自定义社交 1–8。

### 9. 广告与运营

– 约 16 处广告位（列表页、文章页、侧边栏等多位置）；

– 网址导航、友情链接、读者墙、标签云等页面；

– 维护模式、直达链接、自定义代码（底部内容 / CSS / 头部代码 / 底部代码 / 统计代码）。

### 10. 侧边栏与小部件

– 内置 9 个侧边栏区域（首页、分类页、文章页、页面、搜索页、公共头部 / 底部等）；

– 内置 11 个小部件：广告、聚合文章、作者、特色内容、最新评论、新闻、站点统计、幻灯片、置顶文章、标签云、专题等。

### 11. 菜单与页面模板

– 内置 3 个导航菜单位置：顶部菜单、网站导航、网站导航（手机端）；

– 内置页面模板：网址导航、归档、友情链接、会员中心。

—

## 二、配置流程

YMX 的配置都集中在 WordPress 后台左侧菜单的「**主题设置**」中，建议按下面的顺序从「基础」到「进阶」逐步配置：

### 第 1 步：安装与启用

1. 将主题文件夹上传至 `wp-content/themes/` 目录；

2. 后台进入「外观 → 主题」，启用 **YMX** 主题；

3. 如需升级：先备份现有主题，再用新版文件覆盖旧版（若曾自行修改主题文件，请先留存差异）。

### 第 2 步：基本设置

进入「主题设置 → 基本设置」，配置：

– Logo（图片 / 夜间 Logo / 纯文字）、品牌文字、登录页 Logo；

– 前台语言（简中 / 繁中 / 英文）、日间 / 夜间模式与默认夜间；

– 底部信息、建站起始年份、网页最大宽度等。

### 第 3 步：菜单与侧边栏

1. 「外观 → 菜单」中创建菜单，并分配到 **顶部菜单 / 网站导航 / 网站导航（手机端）**；

2. 「外观 → 小部件」中，向各侧边栏区域拖入内置小部件（幻灯片、广告、最新评论、标签云等）。

### 第 4 步：首页与 SEO

1. 「主题设置 → 首页设置」配置轮换图、焦点图、微分类、公告模块等；

2. 「主题设置 → SEO 设置」配置首页标题 / 关键词 / 描述及文章 SEO 规则。

### 第 5 步：列表与文章

1. 「主题设置 → 列表设置」选择列表模式、无限加载、去 category 等；

2. 「主题设置 → 文章设置」按需开启阅读数、点赞、打赏、相关文章、版权提示等。

### 第 6 步：会员、专题与评论

1. 「主题设置 → 会员中心设置」配置会员中心、用户投稿、邮箱白名单；

2. 「主题设置 → 专题设置」配置专题首页与默认图；

3. 「主题设置 → 评论设置」「验证码设置」配置评论通知与腾讯云人机验证码。

### 第 7 步：三方登录与短信登录（可选）

1. 前往 `主题设置 → 我的应用`，绑定「一门APP」开发者账号（开发者 ID + 开发者密钥）；

2. 前往各开放平台完成应用申请，回填 AppID / AppSecret 等参数到 `主题设置 → 三方登录` 对应位置；

3. 具体申请步骤与回调地址见下文「三方登录与短信登录」。

### 第 8 步：广告与自定义代码

1. 「主题设置 → 广告位设置」配置约 16 处广告位；

2. 「主题设置 → 自定义代码设置」填写统计代码、CSS、头部 / 底部代码等。

### 第 9 步：页面与辅助功能

1. 新建页面时选择「网址导航 / 归档 / 友情链接 / 会员中心」等内置模板；

2. 「主题设置 → 页面设置」「直达链接设置」「维护模式设置」按需配置。

—

## 三、三方登录与短信登录

YMX 1.0 内置了完整的登录体系：**QQ 登录、微信登录（PC 扫码 + 公众号内 H5）、微博登录、短信验证码登录**，后台各设置页均提供「📘 申请说明」折叠框，展示对应平台申请入口、字段对照与回调地址。

### 1. 支持能力与填写位置

| 功能 | 支持平台 / 方式 | 主题后台填写位置 |

|—|—|—|

| QQ 登录 | QQ 互联「网站应用」 | 主题设置 → 三方登录 → QQ登录 |

| 微信 PC 扫码登录 | 微信开放平台「网站应用」 | 主题设置 → 三方登录 → 微信登录 |

| 微信公众号内登录（H5） | 微信公众平台「服务号」 | 主题设置 → 三方登录 → 微信登录 |

| 微博登录 | 微博开放平台「网站接入」 | 主题设置 → 三方登录 → 微博登录 |

| 短信验证码登录 | 阿里云短信 / 腾讯云短信 | 主题设置 → 三方登录 → 短信登录 |

### 2. 回调地址速查

各平台回调地址（其中 `{站点地址}` 请替换为你的真实域名）：

| 登录方式 | 回调地址 |

|—|—|

| QQ 登录 | `{站点地址}/wp-admin/admin-ajax.php?action=yimen_login_callback&type=qq` |

| 微信 PC 扫码登录 | `{站点地址}/wp-admin/admin-ajax.php?action=yimen_login_callback&type=pc_wechat` |

| 微信公众号内登录 | `{站点地址}/wp-admin/admin-ajax.php?action=yimen_login_callback&type=wechat` |

| 微博登录 | `{站点地址}/wp-admin/admin-ajax.php?action=yimen_login_callback&type=sina` |

> – 微信的两种登录在「微信开放平台 / 公众平台」中**只填域名（授权回调域）**，不填完整路径；QQ、微博则填**完整回调地址**。

> – 短信登录为服务端 API 调用，**无需配置回调地址**，主题后端已内置发送频率限制。

### 3. 一门APP 开发者账号绑定

三方登录采用「**前端直连拉起授权 + 后端由一门APP云端换取 openid**」的方式。因此除各平台的 AppID / AppSecret 外，还需在 `主题设置 → 我的应用` 中绑定「一门APP」开发者账号（开发者 ID + 开发者密钥），否则前端登录会提示「请先绑定一门开发者账号」。

### 4. 配套文档

`docs/` 目录提供完整分篇说明，方便随时查阅：

– 三方登录接口申请总览（README）

– QQ 互联申请说明

– 微信登录申请说明（PC 扫码 + 公众号内）

– 微博开放平台申请说明

– 短信登录申请说明（阿里云 / 腾讯云）

> 国内平台普遍要求**主体认证**与**域名备案**，请提前准备。

—

## 四、使用方法与注意事项

1. **大部分功能无需改代码**：所有开关、参数均在「主题设置」中完成，保存后前台即时生效；

2. **页面模板**：新建页面时，在右侧「页面属性 → 模板」中选择「网址导航 / 归档 / 友情链接 / 会员中心」等模板即可；

3. **小部件**：侧边栏内容通过「外观 → 小部件」拖拽配置，与主题设置互不冲突；

4. **三方登录**：务必先绑定一门APP 开发者账号并完成各平台申请回填，否则无法正常拉起授权；

5. **升级与备份**：升级主题前先备份，避免自定义修改被覆盖。