## 全局標簽 全局標簽指不限定模板的標簽，只要引入了CMS內容管理系統的標簽庫都可以調用的標簽。 ## 區塊 cms:block 區塊標簽常應用于文字、圖片鏈接展示、自定義HTML代碼等。 ### 標簽參數 | 名稱 | 介紹 | 必選 | | --- | --- | --- | | id | 區塊ID，可以從后臺管理中獲取，id和name任選其一 | 否 | | name | 區塊名稱，可以從后臺管理中獲取，id和name任選其 | 否 | | field | 字段名稱 | 否 | ### 調用示例 ~~~scss //通過區塊ID來調用顯示區塊 {cms:block id="1" /} //通過名稱Name來調用顯示區塊 {cms:block name="bannerad" /} //通過顯示指定字段的內容 {cms:block name="bannerad" field="image" /} ~~~ ## 區塊 cms:blocklist 用于調用區塊列表 ### 標簽參數 | 名稱 | 介紹 | 必選 | | --- | --- | --- | | id | 列表循環變量 | 是 | | empty | 數列為空時顯示的數據 | 否 | | key | 列表循環鍵名變量,默認為`i` | 否 | | mod | 取模值，常用于控制換行，默認為2 | 否 | | row | 篩選的行數,默認為10 | 否 | | orderby | 排序字段，支持一個字段或多個字段，如：`views`或`views desc,id desc` | 否 | | orderway | 排序方式，支持`desc`降序和`asc`升序 | 否 | | limit | 篩選的`行數`或`偏移值,行數`,優先使用row配置 | 否 | | cache | 緩存標識，也可以是緩存時長(秒)，默認始終緩存，如果不希望緩存請置為-1，0表示永久緩存 | 否 | | type | 區塊類型，可以從后臺管理中獲取 | 否 | | name | 區塊名稱，可以從后臺管理中獲取 | 否 | | condition | 自定義條件過濾，可追加使用SQL篩選，請參考文檔：自定義過濾條件 | 否 | | paginate | 數據分頁，請參考文檔：分頁標簽 | 否 | ### 調用示例 ~~~bash {cms:blocklist id="block" name="focus" row="5"} {$block.title} {/cms:blocklist} ~~~ ## 配置 cms:config 用于調用FastAdmin站點配置信息 ### 標簽參數 | 名稱 | 介紹 | 必選 | | --- | --- | --- | | name | 調用名稱 | 是 | `name`可以調用以下配置文件中的信息 ~~~less //無前綴 application/config.php //前綴site. application/extra/site.php //前綴cms. addons/cms/config.php ~~~ ### 調用示例 ~~~scss {cms:config name="site.version"/} {cms:config name="site.name"/} {cms:config name="cms.title"/} {cms:config name="cms.sitename"/} //CMS首頁地址 {cms:config name="cms.indexurl"/} //CMS其它配置值，支持`addons/cms/config.php`中的配置名稱 {cms:config name="cms.名稱"/} ~~~ ## 面包屑 cms:breadcrumb 用于顯示面包屑導航。 ### 標簽參數 公共參數 ### 調用示例 ~~~bash {cms:breadcrumb id="item"} //鏈接文字 {$item.name} //鏈接地址 {$item.url} {/cms:breadcrumb} ~~~ ## 欄目導航列表 cms:nav 用于顯示欄目列表 ### 標簽參數 | 名稱 | 介紹 | 必選 | | --- | --- | --- | | maxlevel | 欄目顯示的級數 | 是 | | condition | 自定義條件過濾，可追加使用SQL篩選，請參考文檔：自定義過濾條件 | 否 | ### 調用示例 ~~~scss {cms:nav maxlevel="3" cache="86400" /} ~~~ ## 執行SQL cms:execute 查詢指定的SQL語句，不返回結果。 ### 標簽參數 | 名稱 | 介紹 | 必選 | | --- | --- | --- | | sql | 需要執行的SQL語句 | 是 | ### 調用示例 ~~~scss //將ID為1的會員昵稱修改為：測試昵稱 {cms:execute sql="update fa_user set nickname='測試昵稱' where id='1'"/} ~~~ ## 查詢SQL列表 cms:query 查詢指定的SQL語句并返回結果列表。 ### 標簽參數 | 名稱 | 介紹 | 必選 | | --- | --- | --- | | id | 列表循環變量 | 是 | | empty | 數列為空時顯示的數據 | 否 | | key | 列表循環鍵名變量,默認為`i` | 否 | | mod | 取模值，常用于控制換行，默認為2 | 否 | | sql | 需要查詢的SQL語句 | 是 | | bind | 綁定的參數，多個參數時請以`,`分隔 | 否 | ### 調用示例 ~~~bash //查詢 ID 小于 10 的用戶 {cms:query sql="select * from fa_user where id<10" id="user"} {$user.nickname} {$user.avatar} {/cms:query} //通過綁定參數傳遞 {cms:query sql="select * from fa_user where id<?" id="user" bind="10"} {$user.nickname} {$user.avatar} {/cms:query} //通過獲取動態參數傳遞 {cms:query sql="select * from fa_user where id<?" id="user" bind=":$_GET['id']"} {$user.nickname} {$user.avatar} {/cms:query} //通過獲取動態參數傳遞，多參數(多參數時以`,`進行分隔) {php}$bind = $_GET['idmin'] . ',' . $_GET['idmax'];{/php} {cms:query sql="select * from fa_user where id between ? and ?" id="user" bind=":$bind"} {$user.nickname} {$user.avatar} {/cms:query} //為空時自定義輸出 {php}$empty='<h3>未找到相關內容</h3>';{/php} {cms:query sql="select * from fa_user where id between ? and ?" id="user" bind=":$bind" empty="$empty"} {$user.nickname} {$user.avatar} {/cms:query} ~~~