WoodMart 主题安装与演示数据导入（完整图文步骤）

一、开始前的准备

安装主题前，请确认服务器环境满足以下最低要求

项目	最低要求	推荐配置
PHP 版本	7.4	8.2 或 8.3
PHP 内存限制	256M	512M 或更高
最大上传文件大小	32M	64M 或更高
最大执行时间	120 秒	180 秒或更高
max_input_vars	3000	10000
MySQL 版本	5.6	5.7 或 8.0
SSL 证书	必须有	HTTPS 是 WoodMart 官方要求，也是电商站的硬性条件

💡 max_input_vars 是很多人忽略的参数：它的值太低时，演示导入会中途失败，菜单和主题设置保存时也会被截断，排查起来很隐蔽，建议一开始就调到 10000。

🔍 1.1 检查方法

1. 登录 WordPress 后台。
2. 进入 工具 → 站点健康 → 信息 → 服务器。
3. 查看 PHP 版本、PHP 内存限制、最大上传大小是否达标。

如果数值不达标，在宝塔面板中调整 ⚙️：

• 软件商店 → 找到 PHP 版本 → 安装或切换到 8.2 / 8.3，并在「网站 → 站点设置 → PHP 版本」中为站点绑定新版本

• PHP 设置 → 配置修改：

• 把 memory_limit 改为 512M

• 把 upload_max_filesize 和 post_max_size 改为 64M

• 把 max_execution_time 改为 180 或更高

• 把 max_input_vars 改为 10000

• 重启 PHP 服务

📋 1.2 还需要准备

• 🆕 一个干净的 WordPress 站点（建议先用测试站练习）

• 🔌 已安装并启用 WooCommerce 插件

• 🛒 已从 ThemeForest 官方购买 WoodMart 主题，下载了主题安装包

⚠️ 不要使用来历不明的破解版主题包。破解版可能包含后门、恶意代码，导致站点被黑或无法更新。

---

二、下载正确的主题包

购买 WoodMart 后，从 ThemeForest 下载的文件通常类似 woodmart.zip，也可能是一个更大的综合包（文件名通常带版本号，如 woodmart_v8.5.5_package.zip）。

🤔 2.1 判断该上传哪个文件

• 📦 如果下载的文件解压后只有一个 woodmart.zip，直接上传它。

• 📂 如果下载的是综合包，解压后会看到多个文件夹，其中真正的主题安装文件是 woodmart.zip。

• ⚠️ 不要上传整个综合包到 WordPress，否则会报错「找不到 style.css」。

📦 2.2 子主题包

同一个下载包里通常还包含 woodmart-child.zip，这就是子主题。后面会用到。

---

三、安装 WoodMart 父主题

🖥️ 3.1 方法一：通过 WordPress 后台上传

1. 登录 WordPress 后台。
2. 进入 外观 → 主题 → 添加新主题 → 上传主题。
3. 点击「选择文件」，选中 woodmart.zip。
4. 点击「立即安装」。
5. 安装完成后，点击「启用」。

📁 3.2 方法二：通过 FTP / 宝塔上传

如果后台上传因为文件过大失败，可以用 FTP 或宝塔文件管理器：

1. 把 woodmart.zip 解压。
2. 把解压得到的 woodmart 文件夹上传到 /wp-content/themes/ 目录下。
3. 回到 WordPress 后台 → 外观 → 主题 → 启用 WoodMart。

💡 启用主题后，可能会提示安装推荐插件。暂时可以先跳过，等演示数据导入完成后再根据需要安装。

🧭 3.3 关于 Setup Wizard（设置向导）

启用 WoodMart 后，通常会自动弹出设置向导（Setup Wizard），把「许可证激活 → 一键安装子主题 → 安装配套插件 → 导入演示数据」串成一条流水线，跟着向导走即可完成本篇第四到第六章的全部内容，是新手最省事的方式。

如果你想完全掌控每一步，或者向导被意外关闭、中途失败，可以按照下面第四到第六章的手动方式完成，效果完全一样。

---

四、安装并启用子主题

💡 子主题的作用是：以后更新父主题时，你在子主题里做的修改不会丢失。

如果你已通过 Setup Wizard 安装过子主题，可以跳过本章。

1. 再次进入 外观 → 主题 → 添加新主题 → 上传主题。
2. 选择 woodmart-child.zip 并安装。
3. 安装完成后，启用子主题，而不是父主题。

启用后，WordPress 后台左上角仍会显示 WoodMart，但实际上运行的是子主题。后续如果需要在 functions.php 里加代码，应该编辑子主题的 functions.php。

---

五、激活主题许可证

🔑 WoodMart 需要输入购买码（Purchase Code）才能自动更新、导入演示数据、使用主题面板完整功能。

1. 启用主题后，通常会自动跳转到 WoodMart 欢迎页或 Setup Wizard。
2. 如果没有自动跳转，进入 WoodMart → Theme License（主题许可证）。
3. 输入你的 ThemeForest 购买码。
4. 点击激活。

🔑 5.1 购买码在哪里找

• 登录 ThemeForest。

• 进入「下载」页面，找到 WoodMart。

• 点击「下载 → 许可证证书和购买码」。

• 文件里会有一串类似 a1b2c3d4-e5f6-7890-abcd-ef1234567890 格式的代码。

⚠️ 如果提示「已达到激活上限」，需要先在你之前的站点上解绑，再重新激活。

---

六、导入演示数据

✅ 激活成功后，就可以导入演示数据了。

🚪 6.1 进入演示导入页面

1. 进入 WoodMart → 演示导入（Demos）。
2. 你会看到多个演示站点，涵盖服装、数码、家具、有机食品等不同行业，具体名称以实际页面展示为准。

🎯 6.2 选择适合的演示

👉 新手建议先选 Base 或与你行业最接近的演示。不要重复导入同一个演示，也不要一次导入多个演示，否则会拖慢服务器。

---

七、导入完成后的检查

✅ 导入成功后，按顺序检查以下内容：

检查项	正常状态
前台首页	能正常打开，显示导入的首页布局
菜单	顶部导航有内容，链接能点击
产品页	商店页面有产品展示
图片	图片能正常加载，没有大量裂图
页眉/页脚	有 Logo、菜单、版权信息等
移动端	用手机或浏览器开发者工具查看，布局不崩

🖼️ 7.1 如果图片显示缓慢或缺失

演示数据中的图片很多是从远程服务器拉取的，首次加载可能较慢。如果 10 分钟后仍有大量图片不显示：

1. 检查服务器是否能正常访问外网（宝塔服务器可在终端 ping 一下境外域名测试）。
2. 确认第一章的 PHP 参数都已按推荐值调整，然后回到 WoodMart → 演示导入，对同一个演示重新运行一次导入，未完成的媒体文件会继续拉取。
3. 如果反复失败，截图记录报错信息，携带购买码到 XTemos 官方支持论坛提交工单。

⛔ 7.2 如果导入卡住或报「AJAX import error」

这是 WoodMart 官方论坛中最高频的导入问题，按以下顺序排查：

1. 停用所有第三方插件：只保留 WoodMart Core、WooCommerce、Elementor（或 WPBakery）这几个主题必需插件，其余全部停用后重试。
2. 确认 PHP 参数达标：重点检查 memory_limit（512M）、max_execution_time（180 秒或更高）、max_input_vars（10000），改完记得重启 PHP 服务。
3. 重新运行导入：回到 WoodMart → 演示导入 再执行一次，导入器会跳过已完成的部分继续。
4. 仍失败：记录卡住时的进度百分比和完整报错文本，到 XTemos 官方支持渠道求助。

---

八、导入完成后建议做的清理

🧹 演示数据里通常包含大量示例产品和页面，正式使用前建议：

1. 删除不需要的示例产品（保留几个做模板）。
2. 删除不需要的示例页面、文章、菜单。
3. 进入 WoodMart → HTML Blocks，删除不需要的页眉、页脚、弹窗模板。
4. 进入 媒体库，删除没有使用的示例图片。
5. 进入 设置 → 固定链接，保存一次，确保 URL 正常。
6. 安装缓存插件并清空缓存。