Docs
系统里的说明
下面和后台「说明」是同一套:怎么用、后台每一栏、主题、模板标签,以及环境和安装。
主题是一套前台外观(Blade 文件 + 它声明的模型)。没有应用市场,都在本机 主题 页切换。改文件、标签见「模板」。
怎么换到本站
- 打开主题。卡片上「当前使用」就是正在用的。点「配置」进这一套的多语言、模型和自定义参数。
- 点预览图看长什么样。缺首页的不能用于本站(没有
index/index.blade.php)。 - 点「用于本站」:会把这套外观设为当前主题,并补上缺少的内容模型和空栏目。已有模型字段、已有栏目和文章都不会改、不会删。
- 当前这套还缺模型时,按钮是「补上模型」,只补缺的,不换外观。
- 前台还是旧样子,到缓存清空。
空栏目补上后还没有文章,需要自己写。体育主题只作公开资讯/目录演示,请合法合规使用。
怎么加一套
| 做法 | 说明 |
|---|---|
| 复制一套 | 从现有完整主题拷文件夹。只改新目录,自带主题不会被覆盖。 |
| 上传 zip | 包里要有 index/index.blade.php,可带一层目录名当标识。不要带可执行 PHP。 |
| 丢文件夹 | 放到 resources/views/themes/标识/,刷新主题页即出现。 |
| 命令行 | php artisan cms:theme-make brand --from=enterprise --name=品牌站 |
自带主题不能删。自己加的可以「去掉」(会删文件夹),正在用的不能去掉。标识只能小写字母数字和横线。
自带主题干什么用
| 主题 | 适合 | 会用到的模型 |
|---|---|---|
| 企业 | 公司官网 | 文章、单页、产品、招聘 |
| 博客 | 简单博客 | 文章 |
| 下载 | 资源下载 | 下载 |
| 导航 | 网址导航 | 链接 |
| 源码 | 源码站 | 源码 |
| 漫画 | 漫画连载 | 漫画、章节 |
| 体育 | 资讯/信号目录 | 信号 |
| 移动 | 手机皮肤 | 与企业类似,可作手机外观 |
点「用于本站」时按 theme.json 里的 models / categories 补缺(配置页勾选的模型会覆盖 json)。栏目标题可写成 {"zh_cn":"新闻中心","en":"News"}。卡片上「多语言」「自适应」也可在配置页勾选。自定义参数写在 config,前台 cms_theme('键')。
站名、Logo、手机外观
设置里改网站名称。设置 → 外观可上传 Logo / Favicon、主色、页脚、ICP。留空则用主题自带配色。
手机要另一套皮:在设置「更多」里选「手机外观」(常用 mobile),可再填手机域名,或按手机浏览器自动切。
主题相关问题
用于本站会不会清掉现在的文章?
不会。只补没有的模型和空栏目。已有字段、栏目、文章原样保留。换皮后字段对不上的,前台可能显示不全,需要自己改栏目模型或模板。
按钮是灰的 / 显示缺首页
这套没有 index/index.blade.php。复制或上传时包不完整就会这样。自带主题不应出现。
换了主题前台没变
到缓存清空。磁盘静态页若开着,也要重新生成。
复制后改哪
只改新文件夹里的 Blade / CSS / theme.json。改完刷新主题页。预览图放 preview.png。标签怎么写见「标签」。