guestbook 留言(表單)標簽（廢棄） · HkCms tp6版使用手冊《免授權，永久商用》-02251406

# guestbook 留言(表單)標簽（廢棄） ## 留言模型(表單)標簽用于獲取在后臺創建的留言表單輸出到前臺 > v2.2.1.20220603 版本起不在使用該標簽 ## 參數參數名稱可選值默認值是否必填說明id-item-指定循環里的變量名，例如id='obj'，模板調用如：{$item.action} 變成 {$obj.action}catid--是欄目ID，也可傳入變量captcha1--驗證碼，1-開啟驗證碼cache-3600秒-緩存時間，默認3600秒## 參數說明 - id，指定循環里的變量名，id="obj"，如下 ``` <pre class="calibre16">``` {hkcms:guestbook catid="34" id="obj"} // 默認是$item，field的值來自于您創建的模型字段參考下圖 <input type="text" class="form-control" name="{$obj.field.name|default=''}" /> {/hkcms:guestbook} ``` ``` ![](https://img.kancloud.cn/81/e5/81e5cfd2e1a73efdad172f1e64c19275_789x405.png) - catid，留言欄目ID，**必填** - captcha，驗證碼，值為1就是開啟驗證碼，其中的catid可以以傳入變量，例如每個欄目頁會有$Cate欄目變量，寫法：`catid="$Cate['id']"` 或 `catid="$Cate.id"` ``` <pre class="calibre16">``` {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} ``` ``` ## 完整示例 ``` <pre class="calibre16">``` <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驗證碼