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验证码