[模板开发]前台门户模板开发

前台门户模板只负责首页展示，不负责业务判断。你只需要把页面结构、样式、文案、图片和跳转链接写好，系统会把站点基础信息传给你。

1. 模板放哪里

门户模板固定放在：

view/index/index/模板名/

最少保留 index.html。建议再带上 template.json 和 preview.png，这样后台列表更完整。

目录名只允许字母、数字、下划线、短横线，不要用中文和空格。

2. 页面能拿到什么

门户页只传 site 这一份数据。常用字段如下：

字段	说明
title	网站标题
desc	网站描述
key	网站关键词
logo	网站 LOGO
favicon	浏览器ico图标
qq	联系 QQ
icp	备案信息
user_login_enable	是否允许用户登录
user_register_enable	是否允许用户注册
forgot_password_enable	是否允许找回密码
register_method	注册方式

如果后台把首页规则改成 user_direct，站点访问会直接跳到用户中心，不再显示门户首页。

3. 页面怎么写

建议先复制 view/index/index/default/ 再改。门户页常见写法就是直接取 site 变量：

<title>{$site.title|default='抖音获客系统Pro'}</title>
<meta name="keywords" content="{$site.key|default='抖音获客,私信管理,自动回复'}">
<meta name="description" content="{$site.desc|default='抖音获客系统Pro'}">
<link rel="icon" href="{$site.favicon|default='/favicon.ico'}">

门户页默认没有固定 AJAX 接口。要做公告、轮播、统计这类动态模块时，可以自己额外补接口，前端直接按 JSON 读取。

4. 参考模板信息文件

template.json 只是给后台看得更完整，不写也能用，建议格式如下：

{
  "name": "简洁门户",
  "author": "你的名字",
  "version": "1.0.0",
  "description": "适合做首页展示的门户模板"
}

preview.png 会出现在后台模板列表里，没有这个文件时就显示默认占位图。

5. 实际写的时候记住这几条

• 静态资源尽量用绝对路径，比如 /assets/...
• 首页先保证手机端不乱
• 模板里别直接拼业务判断，业务逻辑放到后端接口里
• 先复制默认模板，再改成自己的风格，最稳