前后端分离视频站wordpress主题qinPress使用说明

一、安装说明

1. 安装 WordPress 后端

qinPress 是一个前后端分离的视频主题，WordPress 仅作为内容管理和 API 后端。以下是安装步骤：

1. 安装 WordPress：新建一个 PHP 站点并安装 WordPress。建议使用子域名（如 api.yourdomain.com）来安装，因为主域名将用于前端展示。
2. 上传主题：通过 FTP 将 qinpress 主题文件夹上传到 WordPress 的 /wp-content/themes/ 目录下。
3. 启用主题：登录 WordPress 后台，在“外观”->“主题”中启用 qinPress 主题。
4. 验证首页：访问网站首页（需退出后台登录），应能看到前端登录界面。
5. 测试 API：访问 你的域名/wp-json/wp/v2/，应返回 JSON 格式的数据。若显示异常，请检查服务器伪静态规则（如 Nginx 的 rewrite 规则）是否已正确配置为 WordPress 规则。
6. 创建必要页面：在主题设置中点击“创建页面”。页面创建后可能显示异常或乱码，此属正常现象，请继续下一步。
7. 检查分类：在“文章”->“分类目录”中，检查主题是否已自动生成“动漫分类”和“动漫类型”。请对照后续的必需设置表格核对，如有缺失或错误需手动修正，否则前端页面可能无法正常显示。
8. 安装 JWT 插件：安装并激活 JWT Authentication for WP-API 插件，用于前后端用户认证。
9. 生成密钥：访问 WordPress 密钥生成页面，复制其中一组密钥。
10. 配置密钥：将以下代码添加到网站根目录的 wp-config.php 文件中，通常放在其他 define('AUTH_KEY', ...) 语句附近：

    define('JWT_AUTH_SECRET_KEY', '你的密钥字符串');
    define('JWT_AUTH_CORS_ENABLE', true);

11. 设置前端域名：在主题设置中，添加你的前端站点域名（如 https://www.yourdomain.com）到“允许前端域名访问”列表，以启用跨域请求。

2. 部署前端静态站点

前端是内容展示的主体，建议分别为 PC 端和移动端部署独立的站点。

• 域名建议：PC 端使用主域名（如 www.yourdomain.com），移动端使用子域名（如 m.yourdomain.com）。
• 文件部署：新建 Web 站点，将主题包内的 web（PC端）或 h5（移动端）文件夹中的全部文件上传至网站根目录。

服务器配置（以 Nginx 为例）：

1. 伪静态：配置类似 WordPress 的规则，但将默认索引文件改为 index.html。

   location / {
       index index.html index.htm index.php;
       try_files $uri $uri/ /index.html?$args;
   }

2. UA 跳转（可选）：在 PC 端和移动端的 Nginx 配置中相互设置跳转，以实现设备识别。
   PC 端跳转到移动端：

   if ($http_user_agent ~* (mobile|nokia|iphone|ipad|android|samsung|htc|blackberry)) {
       return 301 https://m.yourdomain.com$request_uri;
   }

   移动端跳转到 PC 端：

   if ($http_user_agent !~* (mobile|nokia|iphone|ipad|android|samsung|htc|blackberry)) {
       return 301 https://www.yourdomain.com$request_uri;
   }

3. 配置 API 地址：编辑前端站点根目录下的 static/config.js 文件，修改 baseurl 为你的 WordPress 后端域名（如 https://api.yourdomain.com），basename 为你的网站名称。

功能验证：

1. 访问前端站点，应能正常加载页面。
2. 测试登录、注册功能。
3. 登录后进入用户中心，确认功能正常。
4. 测试图片上传等功能，如遇问题请检查 WordPress 站点的文件上传目录权限（通常 /wp-content/uploads/ 需设置为 755 或 775）。

二、必需设置项

若使用配套的前端主题，必须在 WordPress 后台创建以下页面和分类，并确保其“别名”（slug）完全正确，否则前端将无法正确访问。

1. 页面

2. 动漫分类

3. 动漫类型

注意：以上分类和页面创建后，请将对应的动漫内容归类到相应分类下。

三、注意事项

1. 后台链接跳转：可以将 WordPress 后台的“站点地址”修改为前端地址，并调整伪静态规则，以实现从后台直接跳转到前端对应页面。
2. 安全授权：务必在主题设置中正确配置“授权域名”（即你的前端域名）。这是防止他人盗用你的 API 数据搭建相同前端的关键措施。对于高流量站点，建议在此基础上实施额外的安全策略。
3. API 使用：本文档基于配套前端主题。若自行开发前端，请参考主题源码或未来的完整 API 文档。