企业主题 CorporateTheme · 使用说明

版本：1.0.00 | 作者：kuakeba.cn | 联系 QQ：11341905

一套开箱即用的企业官网插件：内置四套风格、可视化内容定制、支持主站路径与独立域名双入口。

一、插件能做什么

• 内置 4 套企业官网风格，切换即换肤，无需改模板
• 可视化内容定制：首屏、关于、服务、案例、新闻、团队、客户评价、联系方式、页脚，全部后台填写
• 双访问入口：主站路径 /corporate，或绑定独立域名直接访问根路径
• 支持 多站点：一个后台管理多套企业站，各自独立内容、风格、域名
• SEO 标题 / 关键词 / 描述、Logo、Favicon、自定义主色
• 所有页面输出经过转义与 URL 白名单过滤；保存后自动清理整页缓存

二、环境要求

三、安装

1. 将 CorporateTheme 整个目录放入 plugins/（或后台上传插件包）
2. 后台 → 插件管理 → 找到「企业主题」→ 点击 安装
3. 安装完成后，左侧菜单出现 企业主题

安装过程会自动完成：

• 创建数据表 {前缀}corporate_site
• 复制静态资源到 public/static/CorporateTheme/（corporate.css、corporate.js）
• 注册后台菜单与 11 条权限规则
• 写入一个示例站点「示例科技有限公司」（标识 company，已设为默认站点）
• 清除站点解析缓存与权限缓存

全新安装后可直接访问 /corporate 查看效果，再逐步替换成自己的内容。

四、后台入口

菜单路径：企业主题 → /admin/corporate

列表行操作：内容定制 · 编辑 · 预览 · 启停 · 设为默认 · 删除

五、站点字段说明

六、四套内置风格

风格决定配色、圆角与排版密度；自定义主色会在风格基础上覆盖主色，适合企业有固定 VI 色的情况。

七、绑定独立域名

操作步骤

1. 在域名服务商处添加解析：A 记录指向服务器 IP（或 CNAME 指向已有域名）
2. 在服务器面板 / Nginx 站点配置中把该域名绑定到当前站点根目录
3. 后台 → 企业主题 → 编辑站点 → 绑定域名 填入域名（如 www.example.com）
4. 保存，立即生效，无需重启服务

规则与限制

• www 与非 www 自动等价：填写 www.example.com 时，example.com 同样可访问，反之亦然
• 绑定后访问 http(s)://域名/ 根路径，直接输出企业站首页，不进入主站首页
• 根路径下的 index、about、services、cases、news、team、testimonials、contact 等路径同样落到企业站对应锚点
• 不能绑定当前后台正在使用的域名，避免把自己锁在门外
• 同一域名不能同时被多个企业站点绑定
• 若域名已被其它插件（如独立站、多站点插件）占用，会提示「该域名已被「XX」插件绑定」，需先到对应插件解绑
• HTTPS 需自行在服务器 / 面板配置证书，插件不代为申请
• 域名解析未生效前访问会 404，属正常现象，可先用 /corporate 入口预览

八、内容定制

入口：站点列表 → 内容定制

区块与字段

列表行数

编辑页会自动补齐到最少行数；留空的行不会在前台输出。

输入规则

• 图片字段：只接受站内路径（/ 开头）或 http(s):// 地址，其它内容会被清空
• 链接字段：只接受 #锚点、/站内路径、http(s)://、mailto:、tel:，其它协议（如 javascript:）会被清空
• 文字字段：超长自动截断（副标题 500 字、正文 5000 字，其余见表单 maxlength）
• 恢复默认示例内容：一键覆盖当前站点全部文案，不可撤销，操作前请自行备份

九、前台访问

访问不存在的站点标识返回 404，不会回落到其它站点，避免出现重复内容。

十、插件设置

后台 → 插件管理 → 企业主题 → 设置

十一、目录结构

plugins/CorporateTheme/
├── plugin.json                     # 插件声明（名称、版本、作者、描述）
├── icon.svg                        # 插件图标
├── install.sql                     # 建表脚本
├── CorporateThemePlugin.php        # 插件入口：安装/卸载/配置/菜单/资源
├── routes.php                      # 前台与后台路由
├── controller/
│   ├── Home.php                    # 前台渲染（域名 / 路径 / 锚点）
│   └── admin/
│       ├── Base.php                # 后台基类：视图、缓存失效、转义
│       ├── Index.php               # 站点 CRUD、启停、设默认
│       └── Content.php             # 内容定制保存与恢复
├── middleware/
│   └── Domain.php                  # 独立域名接管根路径
├── model/
│   └── Site.php                    # 站点模型
├── service/
│   ├── Preset.php                  # 4 套风格 + 默认文案 + 内容规范化
│   └── SiteResolver.php            # 站点解析（域名 / 标识 / 默认站点）与缓存
├── view/
│   ├── admin/                      # 后台视图：index / form / content
│   └── front/site.html             # 前台模板
└── static/                         # 源静态资源（安装时复制到 public）
    ├── corporate.css
    └── corporate.js

运行期产物：public/static/CorporateTheme/corporate.css、corporate.js。

十二、常见问题

1. 访问 /corporate 返回 404

依次检查：插件是否已安装并启用 → 「开启主站路径入口」是否为开 → 站点是否被停用 → 伪静态是否生效。

2. 页面能打开但没有样式

public/static/CorporateTheme/ 下文件缺失。重新保存一次插件设置或重装插件即可自动补齐；同时确认 public/static 目录可写。

3. 后台改了内容，前台还是旧的

后台保存已自动清理站点缓存与企业站整页缓存。若前面套了 CDN / 反向代理，需要手动刷新 CDN；浏览器端请强制刷新（Ctrl+F5）。

4. 绑定域名后打不开

先确认解析已生效（ping 域名 看是否指向服务器），再确认服务器 / 面板已绑定该域名；域名未备案时国内服务器可能被拦截。

5. 提示「不能绑定当前后台所在的域名」

当前访问后台用的域名已被占用为后台入口，请换一个域名，或使用 /corporate 路径入口预览。

6. 提示「该域名已被XX插件绑定」

该域名已在其它插件（独立站、多站点等）中绑定，请先到对应插件解绑，再回到企业主题绑定。

7. 删除站点会删掉内容吗

会。站点与内容存储在同一个表记录中，删除即一并删除，不可恢复。

8. 卸载插件后数据还在吗

取决于「卸载时清除数据」开关：关闭（默认）保留数据表，重新安装后数据仍在；开启则删除数据表。

十三、运维备注

• 数据表：{前缀}corporate_site
• 站点解析缓存键：corporatethemesites_v1（有效期 300 秒，写操作自动清除）
• 整页缓存标签：ucrequestpage（保存站点 / 内容、启停、设默认、删除时自动清除）
• 手动清缓存：后台 → 系统 → 清除缓存

十四、版本记录

十五、联系方式

有问题、要改样式、要加功能，找我：QQ 11341905