tags标签管理插件,支持文章类的模型,注意使用该插件会在主题目录下生成tags/tags_index.html,防止覆盖已有页面,插件带的模板您需要手动修改,该文件内容,仅供参考。
一:使用说明
1. 在安装启用插件后,先进入配置,配置对应模型才能生效。
2. 插件有提供前台访问控制器与模板,模板路径为:
首页:模板路径/tags/tags_index.html
列表页:模板路径/tags/tags_list.html
由于每个模板主题布局不一致,并不适合所有主题,您需要自己手动调整html页面。
3. 首页访问路径说明: 插件安装成功后会自动添加到站点配置里面的伪静态,你可根据需要调整伪静态配置即可。如下:
标签首页:域名/t/index。列表页:域名/t/标签名字.html
伪静态自动添加,如下
二:模板标签的使用
1. 获取标签列表
参数
参数名称 | 可选值 | 默认值 | 是否必填 | 说明 |
---|---|---|---|---|
tid | 标签ID、0 | - | 是 | 0-表示获取所有 |
arcid | 文章ID | - | 否(tid与arcid选一个) | 获取指定文章包含的标签 |
model | 模型ID | - | 否(acrid填写时,该值不能为空) | 指定标签属于的模型 |
catid | 栏目ID | - | 否 | 指定标签属于的栏目(1.0.3版本) |
order | - | views desc (点击量降序) | 否 | 排序 |
num | - | - | 否 | 限制结果数量 |
where | - | - | 否 | 条件,跟hkcms标签一致 |
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. 文章详情页,获取当前文章所有标签,也可用于列表页
// arcid 跟 model 一起用。
{hkcms:taglist arcid="$Info['id']" model="$Info['model_id']"}
{$item.url} // 获取url
{$item.title} // 获取标签名称
{/hkcms:taglist}
4. 只获取特定模型的标签(1.0.3版本)
{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}
2. 获取标签文章内容列表
参数
参数名称 | 可选值 | 默认值 | 是否必填 | 说明 |
---|---|---|---|---|
tid | 变量、标签ID | - | 是 | |
order | - | create_time desc | 否 | 排序 |
num | - | - | 否 | 限制结果数量 |
where | - | - | 否 | |
page | 1 | - | - | 开启分页,配合 {hkcms:contentpage /} 分页标签 |
id | - | $item | 否 | 指定循环里的变量名,例如id='obj',模板调用如:{$item.title} 变成 {$obj.title} |
empty | - | - | 否 | 为空的时候输出提示,支持传入html |
cache | - | 3600秒 | 否 | 缓存时间,默认3600秒 |
示例
// 完整示例,在标签列表页有$Tags变量,即当前标签,这里代码意思是:获取当前标签下的文章。
{hkcms:tagarclist tid="$Tags['id']" num="6" page="1"}
<div class="card col-xl-4 p-xl-2 rounded-0">
<div class="border">
<a href="{$item.url}" title="{$item.title}"><img src="{:cdn_url($item.thumb)}" style="object-fit: cover;" alt="{$item.title}"></a>
<div class="card-body">
<h5><a href="{$item.url}" title="{$item.title}">{$item.title}</a></h5>
<h6>{hkcms:date name="$item['publish_time']" /}</h6>
<p class="card-text"><a href="{$item.url}">{$item.description}</a></p>
</div>
</div>
</div>
{/hkcms:tagarclist}
// 输出所有字段
{hkcms:tagarclist tid="$Tags['id']" num="6" page="1"}
{php}dump($item);{/php}
{/hkcms:tagarclist}
1.0.7 2022-10-20 <= HkCms_2.2.3
【修复】修复content标签内使用时覆盖标签。
1.0.6 2022-10-15 <= HkCms_2.2.3
【修复】修复已知问题
【优化】兼容2.2.3版本
1.0.5 2022-02-23 <= HkCms_2.1.220504
【优化】优化后台列表
【修复】修复分页问题,旧版cms分页使用content2标签,用法与HkCms分页一致
【修复】修复其他已知问题
1.0.4 2021-12-29 >= HkCms_2.1.211201
【修复】修复配置保存错误
1.0.3 2021-12-28 >= HkCms_2.1.211201
【新增】支持多语言区分
【优化】优化了一些数据
1.0.2 2021-12-25 >= HkCms_2.1.211201
【新增】新增参考模板
【新增】所有标签,支持分页
【修复】修复已知问题
1.0.1 2021-12-23 >= HkCms_2.1.211201
【优化】适配2.1.211201版本,标签名称全新化。
【修复】 修复已知问题
1.0.0 2021-09-28 >= HkCms_2.1.210909
发布了第一个版本
博文
问答
相关应用
推荐应用