Multiverse 是一款专门为 Z-BlogPHP 开发的多主题演示与站群预览插件。它能够让您的单个网站后台，同时对外展示多套不同的主题模板效果。每一套主题均可绑定独立的预览入口，并支持配置独立的分站标题、Logo、导航菜单以及特定的文章分类展示。
如果您是主题开发者、模板销售商或建站服务商，Multiverse 能帮您免去为每个主题重复安装 Z-BlogPHP、配置独立数据库和上传重复文章的繁琐步骤，用最少的服务器资源实现最优雅的模板演示站群。
🚀 一站多显：单后台、单数据库，同时预览多套主题，数据保持同步。
🎨 个性分站：每个主题分站支持独立设置站点标题、副标题、专属 Logo 和个性化导航菜单。
📁 分类过滤：可限制特定主题只显示指定的文章分类（例如：展示画册主题时只显示“案例”分类的文章）。
🔗 双预览模式：支持免配置的 Cookie+URL 参数预览，也支持更具品质感的泛域名（子域名）独立访问。
💬 浮现式提示条：前台预览时，底部自动浮现精致的悬浮提示条，展示当前预览主题名称，并支持一键退出预览。
🛠️ 开发者模式：开启后，每次刷新页面均自动重构模板编译文件，代码修改立即可见，无需手动清空缓存。
v1.5.2 (2026-05-21)
⚙️ 优化：微调后台管理界面的排版与布局，提升管理页面的加载与响应速度。
🐛 修复：解决某些特定主题在使用自定义导航模块时出现的缓存未及时清理问题。
v1.5.0 (2026-04-12)
🎨 新增：支持分站独立 Logo 上传及路径自定义，不同主题可呈现专属 Logo。
💬 优化：前台悬浮提示条自适应多套高质感配色，完美匹配各种深/浅色主题。
🛠️ 优化：优化“一键创建导航模块”的逻辑与命名规范，降低操作门槛。
v1.2.0 (2026-02-18)
📁 新增：新增分站“文章分类过滤”多选功能，实现各主题独立演示特定栏目内容。
🔍 新增：后台集成 DNS 泛解析一键测试工具，规避域名解析配置错误。
🚀 优化：重构 Cookie 侦测与状态保持机制，避免静态缓存导致的状态冲突。
v1.0.0 (2026-01-05)
🎉 发布：正式版首发！支持单站多主题双预览模式（Cookie 与 泛域名模式）。
在全局设置中，您可以轻松切换预览侦测方式，配置基准域名，以及开启悬浮提示条与开发者模式
内置便捷的 DNS 测试工具，帮您快速检测泛域名解析是否生效。
在分站配置中，您可以为每套主题设置个性化名称、副标题、专属 Logo 路径，以及一键创建该主题对应的独立导航菜单。
当用户通过特定链接或子域名访问时，系统将自动套用相应主题，并在页面底部呈现质感悬浮提示条，方便用户随时退出预览。
登录您的 Z-BlogPHP 后台。
进入 插件管理。
点击 本地上传并安装插件，选择 Multiverse.zba 文件并上传。
安装完成后，点击 启用 “多主题演示站群” 插件。
本插件提供以下两种预览模式，您可以根据实际需求选择：
适用于本地快速调试或轻量演示，无需修改域名解析与服务器配置。
访问方式：在您的主站链接后加上 ?theme=主题ID。
例如：http://localhost:8888/?theme=tpure
实现原理：访问该链接后，插件会在浏览器写入 Cookie 记录预览状态。此后，用户浏览首页、分类页、文章详情页时，都将持续保持该主题效果。
退出方式：点击页面底部悬浮提示条的“退出预览”即可。
适用于正式模版演示站、模版商城官网等，为每套主题提供完全独立的访问入口。
访问形式：http://主题ID.demo.yourdomain.com/
例如，如果主题 ID 为 tpure，则通过 http://tpure.demo.yourdomain.com/ 访问。
域名解析配置：
在您的域名解析服务商（如阿里云、腾讯云、Cloudflare 等）后台，为您的域名添加一条 泛解析 记录（通配符记录）：
主机记录（Host）：*.demo （或 *）
记录类型（Type）：A 记录
记录值（Value）：指向您服务器的公网 IP 地址。
服务器 web 服务配置：
您需要配置 Web 服务器，使其能够接收并处理发往泛域名的请求：
Nginx 示例配置：
server {
listen 80;
server_name demo.yourdomain.com *.demo.yourdomain.com;
root /path/to/your/zblog;
index index.php index.html;
# ... 其他 PHP-FPM 配置 ...
}
Apache 示例配置：
在虚拟主机配置中，加入 ServerAlias：
<VirtualHost *:80> ServerName demo.yourdomain.com ServerAlias *.demo.yourdomain.com DocumentRoot "/path/to/your/zblog" # ... 其他配置 ... </VirtualHost>
插件后台设置：
登录 Z-Blog 页面，进入插件的 全局设置。
侦测方式选择 泛域名模式。
填写 演示基准域名（如 demo.yourdomain.com，注意不要带 http:// 或 https://，也不要带末尾的斜杠）。
点击 保存设置。
您可以点击输入框旁的 测试 DNS 按钮，验证泛域名解析配置是否生效。
进入 分站配置 标签页，您会看到已安装的所有主题列表。点击相应的主题卡片可以展开详细配置：
启用预览分站：勾选后，该主题的独立演示功能才会生效。
分站名称：自定义该分站展示给用户的标题，如“极简博客主题演示”。在预览状态下，它会覆盖主站的 $zbp->name。
分站副标题：自定义分站副标题，如“大气的响应式个人博客模板”。预览时会覆盖主站的 $zbp->subname。
分站 Logo：可上传或选择一张独立的 Logo 图片。预览时会覆盖主站的 Logo。
[!NOTE]
出于安全考虑，Logo 上传支持 JPG, JPEG, PNG, GIF, WebP, ICO 格式，暂不支持 SVG 格式。建议使用透明背景的 PNG 格式图片。
分站导航菜单：
默认使用主站的导航菜单。
若要为该主题配置专属菜单，可以点击右侧的 一键新建 按钮，系统将自动为该主题生成一个名为 theme_主题ID_nav 的专属导航模块。
新建后，您可以去 Z-Blog 后台 模块管理 中编辑该模块的内容（即菜单链接），然后在分站配置里选中该导航模块即可。
分站显示文章分类：
可在多选框中勾选允许该主题显示的文章分类。
若不勾选任何分类，则默认展示主站的全部公开文章。
若勾选了特定分类，则在该主题预览状态下，首页、列表页、搜索结果、Feed 订阅以及文章详情页都将仅仅展示已勾选分类下的文章，极具针对性！
A: 请按照以下步骤排查：
确认该主题是否已在插件的“分站配置”中勾选了“开启预览分站”。
确认您输入的“主题ID”是否完全正确（区分大小写，通常为主题的文件夹名称）。
确认您当前访问的是前台页面，而不是 Z-Blog 后台。
检查浏览器是否启用了 Cookie，某些无痕模式或隐私插件可能会拦截 Cookie 写入导致链接预览失效。
检查您的网站是否安装了页面静态化插件（如静态生成插件）或者开启了 CDN 强缓存。如果使用了缓存，请配置 CDN 缓存 Key 区分 Cookie: theme 或不同的 Host，或暂时清理缓存进行测试。
A: 这通常是 Web 服务器没有正确配置导致的。虽然您已经配置了 DNS 泛解析，但您的 Nginx 或 Apache 配置文件中没有绑定对应的虚拟主机别名。请参考上文中的 泛域名配置指南 检查 server_name 或 ServerAlias 设置。
A: 部分主题的配置逻辑与当前启用的默认主题绑定较深。如果该主题在预览状态下能正常显示，但插件后台的“配置主题”快捷入口打不开，您可以先将该主题临时设置为 Z-Blog 的“当前启用主题”，在主题自身的配置页面调整好参数并保存后，再切回原来的主站主题即可。
A: 不能。本插件的定位是单后台多主题演示系统。它的所有分站共享同一个 Z-BlogPHP 后台、同一套数据库以及同一套用户账号体系。它最适合用于模版展示与销售，如果您需要每个子站点拥有完全独立的后台、独立的用户和数据库，建议使用 Z-Blog 多站点相关方案。
Z-BlogPHP 版本：1.7.0 及以上
PHP 环境：5.6 及以上（推荐 PHP 7.4 及以上）
服务器软件：Nginx / Apache / IIS 等
当前版本：v1.5.2
发布日期：2026-05-21
1. 您在购买应用前，须要先确认该应用是否符合您的使用需求，数字化商品不支持试用。依据《消费者权益保护法》第二十五条规定，该应用为在线下载的数字化商品，在购买后一经下载安装不能退款。
2. 您在应用中心购买的应用，仅是该应用的许可使用权，该应用的所有权仍归应用提供方所有。
3. 一个应用仅可用于单一账号使用，未经本站和应用提供方同意，不得二次发布、赠送、转售、租让、盗版等，否则我们将永久关闭用户账号并保留继续追究相关责任的权利。
4. 如包含该应用的网站被转售或赠送、租让等，请另用新账号购买该应用或移除该应用，否则将视为违反使用协议被永久取消该账号的使用权利。
5. 如无特殊说明，已购买应用仅包括相关使用权及免费更新服务，应用中心及应用提供方不提供额外售后安装等服务。
6. 您使用应用中所存在的风险，完全由用户自己承担，包括系统受损、资料丢失以及其它任何风险。
7. 用户不得利用该应用以任何方式从事违反法律法规及社会公序良俗的行为，用户须对其不当使用行为可能带来的后果负全部法律责任，本站及应用提供方不承担任何责任。
8. 应用提供方和本站如发现用户将应用安装于黄赌毒诈等非法网站，将停止用户相关的使用权和服务，并将用户相关违法信息上报至网络监管部门。
9. 本站及应用提供方保留在不通知您及不对您承担责任的情况下变更、限制、冻结或终止您对某些内容的使用的权利。
1. 请先注册账号，然后登录“应用中心”。
2. 直接点击“购买应用”，跟随指引即可。
1. 购买者在自己的Z-Blog网站登录，进入后台，在左侧菜单栏点击“应用中心”菜单。
2. 在“应用中心”的首页，使用应用中心注册账号进行登录。
3. 进入“我的应用仓库”，即可看到已购买成功的应用，点击“下载”即可下载安装。
1. 如果通过自己网站后台无法正常访问应用中心，请谨慎购买，因为这将可能导致应用无法顺利下载安装。
2. 如已购买收费应用无法正常下载，请在自己网站后台检查Z-Blog及应用更新，如均已更新至最新版本仍无法下载请及时与我们联系。
3. 应用更新时有可能覆盖本地设置，请在更新前做好备份。
