## 留言模型(表单)标签 用于获取在后台创建的留言表单输出到前台 <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 | 验证码 |