6. 配置文件 · HkCms tp6版使用手冊《免授權，永久商用》-02251406

# 6. 配置文件 ## 配置文件插件配置文件用于給到用戶自定義一些選項，用戶安裝后，可根據需要靈活配置你的插件。目前支持text、textarea、radio、checkbox、select、image、images、date、datetime、array組件。組件可前往這里了解：[字段類型與組件](Qian%20Yan.html) ## 配置后的效果 ![](https://img.kancloud.cn/c2/8e/c28e04b60cab5093e94592e01f2cab20_954x674.png) ## 文件路徑 ``` <pre class="calibre16">``` addons ├─demo │ ├─Demo.php │ ├─config.php 配置文件 │ ├─info.ini ``` ``` ![](https://img.kancloud.cn/36/8f/368f09fc59379c5e6ead638d6fdcfdec_188x211.png) ## 無標簽頁示例 ``` <pre class="calibre16">``` <?php return [ // 名稱，保持唯一，獲取時：$tmp['value1'] 即可獲取value值。 'value1' => [ 'title' => '標題', // 標題 'type' => 'text', // 組件類型 'tips' => '提示', // 提示信息 'rules' => 'required;length(3~16)', // 驗證規則，可參考字段類型與組件下的驗證規則，多個規則;隔開 'error_tips'=>'值必須', // 錯誤的提示信息 'value' => '' // 默認值 ], 'value2' => [ 'title' => '描述', 'type' => 'textarea', 'tips' => '', 'rules' => '', 'error_tips'=>'', 'value' => '' ], 'radio' => [ 'title' => '是否顯示', 'type' => 'radio', 'tips' => '', 'rules' => '', 'error_tips'=>'', 'options' => [ // 選項 '1' => '顯示', '0' => '不顯示' ], 'value' => '1' ], 'checkbox' => [ 'title' => '多項選擇', 'type' => 'checkbox', 'tips' => '', 'rules' => '', 'error_tips'=>'', 'options' => [ // key=>標題 '1' => '顯示1', '2' => '顯示3', '0' => '不顯示' ], 'value' => '1,2' // 多選時英文逗號分隔，對應選項key值 ], 'select' => [ 'title' => '下拉選擇', 'type' => 'select', 'tips' => '我是提示', 'rules' => '', 'error_tips'=>'', 'options' => [ '1' => '測試1', '2' => '測試2', '3' => '測試3' ], 'value' => '2' ], 'array1' => [ 'title' => '測試array組件', 'type' => 'array', 'tips' => '', 'rules' => '', 'error_tips'=>'', 'data_list'=>[// 鍵值名稱 'key'=>'標題', 'value'=>'值' ], 'value' => [ '標題1'=>'2'// 默認值 ] ], 'value1' => [ 'title' => '動態下拉url類型', 'type' => 'selectpage', // 動態下拉 'tips' => '', 'rules' => '', 'error_tips'=>'', 'data_list'=>[ 'type'=>'url',//鏈接地址類型 'url'=>'/cms.flags/index',//鏈接地址類型 'show-field'=>'title', // 顯示字段 'key-field'=>'id',// 存儲字段 'search-field'=>'title',// 搜索字段 'and-or'=>'',// 值為and、或者or，search-field為多個時，值為and時表示同時成立反之其中一個成立即可 'order-by'=>'',// 排序：id desc,view asc 'param'=>[ 'status'=>'normal' // 指定額外的條件 ], 'multiple'=>0,// 多選，1=開啟，0=關閉 'pagination'=>0,// 分頁，1=開啟，0=關閉 'select-only'=>1,// 只讀，1開啟，0關閉 'enable-lang'=>1,// 啟用多語言區分，1開啟，0關閉 ], 'value' => '' ], 'value2' => [ 'title' => '動態下拉table類型', 'type' => 'selectpage', 'tips' => '', 'rules' => '', 'error_tips'=>'', 'data_list'=>[ 'type'=>'table',// 數據源來自數據庫表 'table'=>'flags',// flags表，不用寫表前綴 'show-field'=>'title', 'key-field'=>'id', 'search-field'=>'title,name', 'and-or'=>'or', 'order-by'=>'id desc', 'param'=>[ 'status'=>'normal' ], 'multiple'=>1,// 多選，1=開啟，0=關閉 'pagination'=>0,// 分頁，1=開啟，0=關閉 'select-only'=>0,// 只讀，1開啟，0關閉 'enable-lang'=>1,// 啟用多語言區分，1開啟，0關閉 ], 'value' => '' ], ]; ``` ``` 效果圖 ![](https://img.kancloud.cn/7c/06/7c06f516d55ea795d0556b5a8b7f050e_780x445.png) 如果配置項過多，可以使用下面方式，生成標簽頁 ## 標簽頁分組示例使用標簽頁布局時，獲取的配置結構是不一樣的。 ``` <pre class="calibre16">``` return [ // 自定義名稱，獲取：$tmp['base']['value1'] 'base'=>[ // 標簽頁標題 'title' => '基礎配置', 'item' => [ // 標簽頁包含的配置項 'value1' => [ 'title' => '標題', 'type' => 'text', 'tips' => '提示', 'rules' => 'required;length(3~16)', 'error_tips'=>'值必須', 'value' => '' ], 'value2' => [ 'title' => '描述', 'type' => 'textarea', 'tips' => '', 'rules' => '', 'error_tips'=>'', 'value' => '' ], 'radio' => [ 'title' => '是否顯示', 'type' => 'radio', 'tips' => '', 'rules' => '', 'error_tips'=>'', 'options' => [ '1' => '顯示', '0' => '不顯示' ], 'value' => '1' ], 'checkbox' => [ 'title' => '多項選擇', 'type' => 'checkbox', 'tips' => '', 'rules' => '', 'error_tips'=>'', 'options' => [ '1' => '顯示1', '2' => '顯示3', '0' => '不顯示' ], 'value' => '1,2' ], 'select' => [ 'title' => '下拉選擇', 'type' => 'select', 'tips' => '我是提示', 'rules' => '', 'error_tips'=>'', 'options' => [ '1' => '測試1', '2' => '測試2', '3' => '測試3' ], 'value' => '2' ], 'selects' => [ 'title' => '下拉多項選擇', 'type' => 'selects', 'tips' => '我是提示', 'rules' => '', 'error_tips'=>'', 'options' => [ '1' => '測試1', '2' => '測試2', '3' => '測試3' ], 'value' => '2,3' ] ] ], 'more'=>[ 'title'=>'更多選項', 'item'=>[ 'image' => [ 'title' => '圖片', 'type' => 'image', 'tips' => '請上傳圖片', 'rules' => 'required', 'error_tips'=>'請上傳圖片', 'value' => '' ], 'images' => [ 'title' => '圖片', 'type' => 'images', 'tips' => '請上傳圖片', 'rules' => 'required', 'error_tips'=>'請上傳圖片', 'max_number'=>5, 'value' => '' ], 'date' => [ 'title' => '日期', 'type' => 'date', 'tips' => '', 'rules' => 'required', 'error_tips'=>'日期選擇', 'value' => '' ], 'datetime' => [ 'title' => '日期時間', 'type' => 'datetime', 'tips' => '日期時間', 'rules' => '', 'error_tips'=>'日期時間', 'value' => '' ] ] ] ]; ``` ``` 效果 ![](https://img.kancloud.cn/e2/91/e2911da917fbfff236c175c9b3fa508b_781x499.png) ## 獲取插件配置 ``` <pre class="calibre16">``` /** * $type = 'template' 表示模板應用，$type='addon' 表示插件應用 * $name 插件標識名稱 * $module 模板應用會用到，用于確定獲取后臺模板配置、或前臺模板、或其他模塊的模板。 * $complete true-表示獲取所有結構數組，false-表示獲取配置值 */ get_addons_config($type, $name, $module, $complete) // 例如獲取demo插件配置 get_addons_config('addon','demo'); ``` ``` ## 自定義配置頁如果系統自帶的配置頁，滿足不了你的需求時，您可以自定義配置頁，只需在自己的插件目錄新建config.html即可。 ![](https://img.kancloud.cn/04/6a/046a1e441dbca5a46c7a0893ec438fbe_426x184.png) 在html頁面獲取的變量有：`$sdata` 里面的值結構就是你寫的配置文件結構，你可參考默認的表單生成文件`template/admin/adminlte/appcenter/field.html`。打印輸出： ``` <pre class="calibre16">``` <?php dump($sdata);?> ``` ``` ![](https://img.kancloud.cn/91/c1/91c1d2024360a3a057793e7d3cef7f22_270x224.png) > 提示：若對自定義配置頁仍有疑問，歡迎前往Q群咨詢。