## 留言模型(表單)標簽 用于獲取在后臺創建的留言表單輸出到前臺 <blockquote class="danger"><p>v2.2.1.20220603 版本起不在使用該標簽 </p></blockquote> ## 參數 | 參數名稱 | 可選值 | 默認值 | 是否必填 | 說明 | | --- | --- | --- | --- | --- | | id | - | item | - | 指定循環里的變量名，例如id='obj'，模板調用如：{$item.action} 變成 {$obj.action} | | catid | - | - | 是 | 欄目ID，也可傳入變量 | | captcha | 1 | - | - | 驗證碼，1-開啟驗證碼 | | cache | - | 3600秒 | - | 緩存時間，默認3600秒 | ## 參數說明 - id，指定循環里的變量名，id="obj"，如下 ~~~ {hkcms:guestbook catid="34" id="obj"} // 默認是$item，field的值來自于您創建的模型字段參考下圖 <input type="text" class="form-control" name="{$obj.field.name|default=''}" /> {/hkcms:guestbook} ~~~  - catid，留言欄目ID，**必填** - captcha，驗證碼，值為1就是開啟驗證碼，其中的catid可以以傳入變量，例如每個欄目頁會有$Cate欄目變量，寫法：`catid="$Cate['id']"` 或 `catid="$Cate.id"` ~~~ {hkcms:guestbook catid="34" captcha="1"} <form action="{$item.action}" method="post"> <div class="row g-2 mb-3"> <div class="col-md-4"> <input class="form-control" id="captcha" name="{$item.captcha.field}" /> <label for="content">{:lang('Verify code')}</label> </div> <div class="col-md-2"> <a href="javascript:changeVer();"> <img id="captcha-img" src="{$item.captcha.url}" data-url="{$item.captcha.url}"> </a> </div> </div> <button type="submit" class="btn btn-primary">{:lang("Submit")}</button> </form> {/hkcms:guestbook} ~~~ ## 完整示例 ~~~ <div class="col-xl-12 my-3"> {//captcha=1,開啟驗證碼之后在下面自定義驗證碼表單} {hkcms:guestbook catid="34" captcha="1"} {// 獲取欄目名稱} <h5 class="my-3">{$item['category']['title']??''}</h5> {// 請求地址} <form action="{$item.action}" method="post"> <div class="row g-2 mb-3"> <div class="col-md"> <div class="form-floating"> <input type="text" class="form-control" name="{$item.field.name|default=''}" id="name"> <label for="name">{:lang('Name')}</label> </div> </div> <div class="col-md"> <div class="form-floating"> <input type="text" class="form-control" name="{$item.field.phone|default=''}" id="phone"> <label for="phone">{:lang('Telephone')}</label> </div> </div> </div> <div class="row g-2 mb-3"> <div class="col-md"> <div class="form-floating"> <textarea class="form-control" id="content" name="{$item.field.content|default=''}"></textarea> <label for="content">{:lang('Content')}</label> </div> </div> </div> <div class="row g-2 mb-3"> <div class="col-md-4"> <div class="form-floating"> <input class="form-control" id="captcha" name="{$item.captcha.field}" /> <label for="content">{:lang('Verify code')}</label> </div> </div> <div class="col-md-2"> <a href="javascript:changeVer();"><img id="captcha-img" src="{$item.captcha.url}" data-url="{$item.captcha.url}" style="width: 180px"></a> </div> </div> <button type="submit" class="btn btn-primary">{:lang("Submit")}</button> </form> {/hkcms:guestbook} </div> ~~~ ## 數據字典 | 鍵名 | 值 | 說明| | --- | --- | --- | | action | | 請求地址 | | field| 數組 | 放入表單name里面，請求的參數名 | | all | 數組 | 所有留言板字段 | | category | 數組 | 欄目信息 | | captcha | 數組，包含url,field | 驗證碼 |