> 模板文件一定要小寫下劃線，如 `list_pubu.html` 你可以給你每一個模板文件增加一個`json`配置文件,用于描述這個模板文件;配置文件和模板文件名是同名的,只是后綴為 json,如`simpleboot3/portal/index.html`模板文件的配置文件就是`simpleboot3/portal/index.json`; 一個簡單的配置文件內容如下: ``` { "name": "門戶應用首頁", /*模板文件名*/ "action": "portal/Index/index",/*模板文件對應的操作*/ "description": "門戶應用首頁模板文件",/*模板文件描述*/ "order": 5.0,/*模板文件在后臺模板文件列表的排序,小在前*/ "more": {} /*模板文件擴展配置, 一般有vars,widgets兩個屬性*/ } ``` > 更改模板配置文件后，一定記得在后臺更新模板 > 模板安裝時檢查模板文件和模板配置文件是否一一對應，如果不對應是不會安裝此模板文件的 一個包含模板變量和控件的配置文件內容如下: ``` { "name": "首頁", "action": "portal/Index/index", "description": "首頁模板文件", "order": 6.0, "more": { "vars": { "varName1": { "title": "測試 text", "value": "1", "type": "text", "tip": "這是一個text", "rule": { "require": true } } }, "widgets": { "widgetName1": { "title": "所有組件演示", "name": "all_widget", "display": "1", "vars": { "text": { "title": "測試 text", "value": "1", "type": "text", "tip": "這是一個text", "rule": { "require": true } } } } } } } ``` 添加好模板配置文件，在后臺模板管理里，找到你的模板，就可以開發設計模板頁面了。設計的目的主要是更改你在配置中設置的變量和控件的值。 a.找到你的當前模板 simpleboot3  b.找到你的模板文件，比如首頁模板文件，點設計  c.模板文件設計界面，可視化編輯數據  d.保存后到前臺刷新相應的模板界面，看界面變化 至于如何在模板中獲取模板設計時更改的模板變量呢？請繼續往下研究~ ## 模板變量 一個模板配置文件可以添加 n多個模板變量,模板變量在模板擴展屬性 `more.vars` 里 `varName1`鍵值就是模板變量名,支持多種類型(text,textarea...)的模板變量,具體請看[模板變量類型](模板變量類型.md);不同的變量類型在后臺設置時表現形式不同; 一個常用的`text`類型的變量配置格式如下: ``` "vars": { "varName1": { "title": "測試 text", /*后臺設置時 input 的 label*/ "value": "1", /*變量默認值*/ "type": "text", /*變量類型*/ "tip": "這是一個text", /*后臺設置時 input 的 幫助提示*/ "rule": { /*后臺設置時 input 的 驗證規則*/ "require": true } } } ``` ## 在模板中輸出模板變量 在前臺模板中,我們把所有模板變量放在`$theme_vars`中,`$theme_vars`就是一個數組,要輸出或使用模板變量只要把它當成`$theme_vars`中的值就可以了,如: ``` {$theme_vars.varName1|default=''} ``` ``` <php> echo $theme_vars['varName1']; //記得要判斷一下這個變量是否存在! </php> ``` ## 模板控件 模板控件就是模板里一個顯示塊,我們通過模板控件可以把一個模板分成 n多個模塊,通過設置控件屬性可以設置是否顯示等,一個模板配置文件可以添加 n多個模板控件,模板控件在模板擴展屬性 `more.widgets` 里 `widgetName1`鍵值就是模板控件名. 一個基本的控件配置格式如下: ``` "widgets": { "widgetName1": { "title": "所有組件演示", /*模板控件標題,用于后臺設置*/ "display": "1", /*控件是否顯示,1:顯示;0:不顯示*/ "vars": {/*模板控件變量,和模板變量一樣*/ "text": { "title": "測試 text", "value": "1", "type": "text", "tip": "這是一個text", "rule": { "require": true } } } } } ``` ## 在模板中使用模板控件 在前臺模板中,我們把所有模板控件放在`$theme_widgets`中,`$theme_widgets`就是一個數組,要使用模板控件只要把它當成`$theme_widgets`中的值就可以了,如: ``` <php> print_r($theme_widgets['widgetName1']);//記得要判斷一下這個控件是否存在! </php> ``` 同時我們也增加一個 `widget`標簽 ``` <widget name="widgetName1"> <!--輸出控件標題--> {$widget.title} <!--調用控件的變量--> {$widget.vars.varName1|default=''} 或: <php> echo $widget['vars']['varName1'];//記得要判斷一下這個變量是否存在! </php> </widget> ``` 如果是公共模板文件，應該加上`is_public`屬性，并且設置值為` 1 `，這時這個配置文件里的變量和控件變成公共變量和控件，在每個頁面都加載，如`simpleboot3/public/config.html`的配置文件`simpleboot3/public/config.json` ``` { "name": "模板全局配置", "action": "public/Config", "description": "模板全局配置文件", "is_public": "1",/*默認值為0，開啟后會在每個頁面加載這個配置*/ "order": 0.0, "more": { "vars": { "enable_mobile": { "title": "手機注冊", "value": "ThinkCMF", "type": "select", "value": 1, "options": { "1": "開啟", "0": "關閉" }, "tip": "" } } } } ```