苹果CMS网址导航maccms:website标签参数详解与实战调用教程

一、网址导航模块基础配置

苹果CMS网址导航模块专为网址大全、资源导航类站点开发，自带来路访问统计、数据排序、资源筛选等实用能力，是网址类模板开发的核心功能模块，拥有独立模板目录与专属数据调用模型。

• 模板文件目录：html/website

• 模块调用模型：model('Website')

• 模块ID：mid为10

• 核心循环标签：{maccms:website 参数="值"}内容{/maccms:website}

二、maccms:website标签全参数解析

该标签支持排序、筛选、分页、缓存、时间判定、数据区间判定等多种配置，可自由组合参数实现最新、最热、指定分类、指定时段的网址数据输出，完整参数如下：

order 排列顺序：desc倒序、asc正序
by 排序依据：id、time、time_add、score、hits、hits_day、hits_week、hits_month、up、down、level、rnd、referer、referer_day、referer_week、referer_month
start 数据读取起始条数
num 单次调取数据条数
ids 精准指定网址ID，多ID英文逗号分隔
not 排除指定网址ID，多ID英文逗号分隔
type 分类筛选：all为全部分类，支持自定义多ID筛选
letter 按网址名称首字母筛选
level 按推荐权重筛选，支持多值匹配
area 按地区筛选，支持多地区参数
lang 按语言筛选，支持多语言参数
timeadd 按添加时间筛选：-1 day/-1 week/-1 month/-1 hour
timehits 按点击时间筛选，时间规则同timeadd
time 按更新时间筛选，时间规则同timeadd
hitsmonth 月点击量筛选：gt(大于)、lt(小于)、between(区间)
hitsweek 周点击量筛选，判定规则同hitsmonth
hitsday 日点击量筛选，判定规则同hitsmonth
hits 总点击量筛选，判定规则同hitsmonth
refermonth 月来路数据筛选，支持大小、区间判定
referweek 周来路数据筛选，支持大小、区间判定
referday 日来路数据筛选，支持大小、区间判定
refer 总来路数据筛选，支持大小、区间判定
paging 分页开关：yes开启分页
pageurl 自定义分页跳转路由
cachetime 自定义缓存时长，单位秒

三、基础网址列表调用示例

常规网址列表采用排序号升序排列，适合用于首页网址汇总、分类默认列表展示，可输出网站图标、名称、备注及详情链接，循环内可调用所有$vo前缀网址字段。

{maccms:website num="10" paging="no" order="asc" by="sort"}
 <a href="{:mac_url_website_detail($vo)}">
    <img src="{:mac_url_img($vo.websitepic)}" alt="{$vo.website_name}" />
    <dl>
        <dt>{$vo.website_name}</dt>
        <dd class="bg">备注：{$vo.website_remarks}</dd>
    </dl>
 </a>
 <!-- 更多内部标签字段请参考网址字段文档，以$vo.开头即可调用 -->
{/maccms:website}

四、来路热度排行调用示例

maccms:website标签支持依据来路访问数据排序，可快速制作今日热门、本周热门、本月热门网址榜单，适配导航站热度排行模块开发。该功能仅支持苹果CMSv10 2022.1000.3006及以上正版版本，低版本存在功能异常问题。

来路排序专属参数：总来路 referer、今日来路 referer_day、本周来路 referer_week、本月来路 referer_month。

{maccms:website num="10" paging="no"  by="referer_day"}
 <a href="{:mac_url_website_detail($vo)}">
    <img src="{$vo.website_jumpurl}" alt="{$vo.website_name}" />
    <dl>
        <dt>{$vo.website_name}</dt>
        <dd class="bg">备注：{$vo.website_remarks}</dd>
    </dl>
 </a>
{/maccms:website}