项目简介link

kohost 是一款面向主机服务商的专业响应式模板，同时提供 HTML 前端页面和 WHMCS 财务系统全套主题。内置购物车、域名查询、产品展示等模块，适合快速搭建主机销售平台。

技术栈link

• Bootstrap 5.2.2
• jQuery 3.6.0
• SCSS (Sass)
• Gulp 4 (构建工具)
• WHMCS (主题/购物车/钩子)

项目结构link

kohoshtml-1020/
├── kohost/                      # HTML 模板主目录
│   ├── gulpfile.js              # Gulp 构建配置
│   ├── package.json             # 依赖管理
│   └── src/                     # 源代码 (SCSS/HTML/JS)
├── whmcs/                       # WHMCS 集成文件
│   ├── hooks/                   # PHP 钩子函数
│   ├── orderforms/
│   │   └── themetags_cart/      # 购物车订单表单
│   ├── templates/
│   │   └── kohost/              # WHMCS 客户端主题
│   └── lang/overrides/          # 语言包覆盖
├── kohoshtml-1020/               # 原始 HTML 演示站
│   └── src/                     # 静态页面源码
└── documentation/
    ├── HTML-documentation/       # HTML 模板文档
    └── WHMCS-documentation/      # WHMCS 集成文档

核心文件说明link

• kohost/gulpfile.js — Gulp 任务配置，定义开发、构建流程
• kohost/package.json — 项目依赖声明（Bootstrap、jQuery、Sass 等）
• whmcs/hooks/ — WHMCS 自定义钩子，用于扩展系统行为
• whmcs/orderforms/themetags_cart/ — 购物车订单表单模板（产品配置、结算流程）
• whmcs/templates/kohost/ — WHMCS 客户端区域完整主题模板
• whmcs/lang/overrides/english.php — 语言字符串覆盖文件

快速开始link

HTML 模板开发：

cd kohost
npm install
npm start     # 启动开发服务器，热重载
npm run build # 生产环境构建

WHMCS 集成：

1. 将 whmcs/templates/kohost/ 复制到 WHMCS templates/ 目录
2. 将 whmcs/orderforms/themetags_cart/ 复制到 WHMCS orderforms/ 目录
3. 将 whmcs/hooks/ 内容放入 WHMCS hooks/ 目录
4. 在 WHMCS 后台设置默认模板为 kohost，默认购物车为 themetags_cart

使用建议link

该模板同时包含 RTL（阿拉伯语/希伯来语）版本，路径 kohoshtml-1020/kohost-rtl/src/，面向中东市场时可复用。WHMCS 侧需确保版本兼容，钩子文件依赖 !defined('WHMCS') 安全守卫，生产部署前请仔细测试购物车结算流程。