模组参考网址
网址标签参数
MacCMS V10 网址标签参数:当前支持参数、最小调用示例和无结果排查。
MacCMS V10 · 更新于 · MacCMS Club 编辑部 · 版本与验证范围
使用 maccms:website 在模板中输出网址列表。本模型 mid 为 11。
使用前
先在后台建立一条已启用的网址数据,并记下它的 ID。分类相关页面还需要属于此模型的分类;未审核或无访问权限的数据不一定会显示。 示例放在当前模板的 HTML 文件中,不是粘贴到浏览器控制台或 PHP 文件。
最小列表
{maccms:website num="10" order="desc" by="time"}
<a href="{:mac_url_website_detail($vo)}">{$vo.website_name}</a>
{/maccms:website}循环内部的 $vo 是当前一条网址。示例会生成最多 10 个名称链接;只有 3 条可见数据时只显示 3 条。
当前标签支持的参数
以下参数名按当前标签定义核对。没有写预设值的参数,示例应显式填写;不要把其他模型的参数直接套用。
| 参数 | 用法 |
|---|---|
| order | 排序方向:asc 升序,desc 降序 |
| by | 排序字段;示例 time,分类使用 sort |
| start | 开始位置;使用前确认期望跳过的数据 |
| num | 本次取多少条,例如 10 |
| paging | yes 开启分页;no 不分页 |
| pageurl | 分页动作,例如 vod/search |
| id | 循环变量名,例如 vo;不是内容 ID |
| ids | 指定数据 ID,例如 1,2,3 |
| not | 排除的数据 ID |
| area | 地区,使用后台保存的文字 |
| lang | 语言,使用后台保存的文字 |
| name | 名称筛选 |
| level | 推荐等级,例如 1 |
| letter | 首字母,例如 A |
| type | 分类范围,例如 all、current 或具体分类 ID |
| typenot | 排除分类 ID |
| half | 分页条显示的页码窗口大小;分页函数空值默认按5处理 |
| timeadd | 添加时间条件,例如 -1 day |
| timehits | 点击时间条件,例如 -1 week |
| time | 更新时间条件,例如 -1 day |
| cachetime | 缓存时间,单位秒;改数据后可能要等待失效 |
常见问题
- 无结果:先移除筛选条件,再核对后台状态和分类。
- 改数据仍是旧结果:检查 cachetime 与本站缓存。
- 嵌套循环:外层和内层使用不同 id,例如 outer 和 inner,避免覆盖 $vo。