用于获取标签列表
HkCms_2.2.4.230206版本起
参数
参数名称 | 可选值 | 默认值 | 是否必填 | 说明 |
---|---|---|---|---|
tid | 标签ID或0 | - | - | 0-表示获取所有 |
arcid | 文章ID | - | tid与arcid选一个 | 获取指定文章包含的标签 |
model | 模型ID | - | acrid填写时,该值不能为空 | 指定标签属于的模型 |
catid | 栏目ID | - | - | 指定标签属于的栏目 |
order | - | views desc(点击量降序) | - | 排序 |
num | - | - | - | 限制结果数量 |
where | - | - | - | sql筛选条件 |
page | 1 | - | - | 开启分页,配合 {hkcms:contentpage /} 分页标签 |
id | - | $item | - | 指定循环里的变量名,例如id='obj',模板调用如:{$item.title} 变成 {$obj.title} |
empty | - | - | 否 | 为空的时候输出提示,支持传入html |
cache | - | 3600秒 | - | 缓存时间,默认3600秒 |
currentstyle | - | active | - | css class 类名,用于定义当前选择状态样式 |
简单示例
1. 获取所有标签
{hkcms:taglist tid="0"}{php}dump($item);{/php} // 输出所有字段{/hkcms:taglist}
2. 获取指定标签
{hkcms:taglist tid="3"}{php}dump($item);{/php} // 输出所有字段{/hkcms:taglist}
3. 文章详情页,获取当前文章所有标签,也可用于列表页
详情页:
{hkcms:taglist arcid="$Info.id" model="$Info.model_id"}<a href="{$item.url}">{$item.title}</a>{/hkcms:taglist}
4. 只获取特定模型的标签
{hkcms:taglist model="1"}{php}dump($item);{/php} // 输出所有字段{/hkcms:taglist}
5. 只获取特定栏目的标签(1.0.3版本)
{hkcms:taglist catid="1"}{php}dump($item);{/php} // 输出所有字段{/hkcms:taglist}
5. 分页,page=1:开启分页,num=10,每页显示10条记录
{hkcms:taglist tid="0" page="1" num="10" order="views desc"}<div class="col-xs-3"> <a href="{$item.url}" target="_blank">{$item.title}</a></div>{/hkcms:taglist}// 显示页码{hkcms:contentpage item="home,pre,pageno,next,last,info" mobile_item="pre,pageno,next" pre="«" next="»" /}