目录

安装部署

  • 8 次浏览
入门

安装部署

Qi-theme 以标准 WordPress 主题包 Qi-theme.zip 交付，支持后台上传、服务器放置、FTP 与子主题四种方式。本文给出环境要求、分步操作与常见问题排查。

准备工作

  • 从官方渠道获取 Qi-theme.zip（解压后顶层目录名为 qi-theme）。
  • 建议先备份站点数据库与 wp-content，避免切换主题时影响既有内容。
  • 确认服务器满足下方「环境要求」。

环境要求

项目最低要求推荐
WordPress6.0最新版
PHP7.48.1 及以上
MySQL / MariaDB5.6 / 10.08.0 / 10.6
PHP 内存限制64M256M
必需 PHP 扩展curl、fileinfo、gd、mbstring、zip、json
浏览器现代 Chrome / Edge / Firefox / Safari同上
内存不足？ 在 wp-config.php 中加入 define('WP_MEMORY_LIMIT', '256M'); 即可提升后台可用内存。

方式一：WordPress 后台上传（推荐）

后台「外观 → 主题 → 添加 → 上传主题」界面截图占位，替换为你的实际操作截图
  1. 登录后台，进入 外观 → 主题 → 添加。
  2. 点击右上角「上传主题」，选择本地的 Qi-theme.zip。
  3. 点击「现在安装」，等待上传与解压完成。
  4. 点击「启用」，主题即生效。

方式二：宝塔 / 服务器直接放置

适合熟悉命令行的用户，将压缩包上传到主题目录后解压：

cd /www/wwwroot/你的站点/wp-content/themes
unzip Qi-theme.zip
# 解压后目录结构应为：
# wp-content/themes/qi-theme/
#   ├─ style.css
#   ├─ functions.php
#   ├─ inc/
#   └─ assets/
注意：解压后顶层目录名必须为 qi-theme；若显示为 qi-theme-1.0.0 等，请重命名后再到后台启用。

方式三：FTP 上传

  1. 本地解压 Qi-theme.zip，得到 qi-theme/ 文件夹。
  2. 用 FTP 将该文件夹整体上传到 wp-content/themes/ 下。
  3. 后台进入 外观 → 主题，找到 Qi-theme 点击「启用」。

方式四：子主题安装（进阶 / 开发者）

若你需要在不修改父主题源码的前提下做二次开发，可安装配套子主题：

  1. 将子主题目录（如 qi-theme-child/）放入 wp-content/themes/。
  2. 确保子主题 style.css 头部 Template: 字段值为 qi-theme。
  3. 后台启用子主题；父主题 Qi-theme 作为样式与功能的来源保留。
建议：文档区块（hero / 各内容块）的 CSS、JS 通过子主题 functions.php 用 wp_enqueue_* 引入，更新父主题时不会丢失。

启用后必做

  • 导入演示：后台 外观 → 导入演示，几步还原官方演示站点作为起点（详见《快速开始》）。
  • 全局设置：外观 → 自定义 设定主色、字体、版心宽度等（详见《快速开始》）。
  • 配置菜单：外观 → 菜单 设置顶部与页脚导航。

常见安装问题排查

  • 上传提示权限不足 / 无法创建目录：将主题目录权限设为 755、文件 644；宝塔确认目录属主为 www 用户。
  • “上传的文件超过了 php.ini 中 upload_max_filesize”：调大 upload_max_filesize 与 post_max_size（如 64M），或改用方式二 / 方式三。
  • 启用后白屏：多为内存不足或 PHP 版本过低；开启 WP_DEBUG 查看具体报错，按需升级 PHP 或提高内存。
  • 主题不出现在列表：检查目录名是否为 qi-theme，且 style.css 头部 Theme Name 字段存在。
  • 缺少 zip 扩展导致解压失败：在 PHP 中启用 zip 扩展，或手动解压后上传。