# 目录
[TOC]
# 网址
网址导航
苹果CMSv10网址功能常用与开发网址导航站点、网址大全等站点，支持来路统计、方向链接检测特色功能。
* 目录`html/website`
* 所属模型`model('Website')`
* 模型mid`10`
* 网址标签`{maccms:website 参数1="值" 参数1="值"}....{/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 多个逗号连接
* `not`不抱含id 多个逗号链接
* `type`指定获取分类数据 all所有；1,2,3指定
* `letter`指定首字母
* `level`指定推荐值 支持多个 1,2
* `area`指定地区 支持多个 大陆,香港
* `lang`指定语言 支持多个 英语,西班牙语
* `timeadd`添加时间 一天前 -1 day，一周前-1 week，一月前-1 month，一小时前-1 hour
* `timehits`点击时间 一天前 -1 day，一周前-1 week，一月前-1 month，一小时前-1 hour
* `time`更新时间 一天前 -1 day，一周前-1 week，一月前-1 month，一小时前-1 hour
* `hitsmonth`月点击量 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `hitsweek`周点击量 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `hitsday`日点击量 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `hits`总点击量 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `refermonth`月来路 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `referweek`周来路 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `referday`日来路 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `refer`总来路 大于一千 gt 1000, 小于一千 lt 1000，区间一千二千之间 between 1000,2000
* `paging`是否分页yes
* `pageurl`分页地址
* `cachetime`自定义缓存时间单位秒
**使用示例:**
~~~
{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}
~~~
## 来路排序示例
参数`by="referer_day"`根据总来路：`referer`今日来路：`referer_day`星期来路：`referer_week`月来路：`referer_month`
> 这里涉及到 苹果CMSv10`2022.1000.3006`版本修复的一个`bug`，必须升级到正版`2022.1000.3006`以上。
~~~
{maccms:website num="10" paging="no" by="sort" 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}
~~~
## 网址字段
~~~
{$obj.website_id} 网址id
{$obj.type_id} 分类id
{$obj.type_id_1} 一级分类id
{$obj.website_name} 网址名
{$obj.website_sub} 副标
{$obj.website_en} 拼音
{$obj.website_jumpurl} 跳转url
{$obj.website_status} 状态
{$obj.website_lock} 锁定
{$obj.website_letter} 首字母
{$obj.website_color} 高亮颜色
{$obj.website_remarks} 备注
{$obj.website_tag} tags
{$obj.website_class} 扩展分类
{$obj.website_pic} 截图
{$obj.website_pic_screenshot}截图多个图片用$$$连接
{$obj.website_logo} logo
{$obj.website_sort} 排序
{$obj.website_level} 推荐值
{$obj.website_up} 顶数
{$obj.website_down} 踩数
{$obj.website_score} 平均分
{$obj.website_score_all} 总评分
{$obj.website_score_num} 评分次数
{$obj.website_time} 更新时间
{$obj.website_time_add} 添加时间
{$obj.website_time_hits} 点击时间
{$obj.website_time_make} 生成时间
{$obj.website_referer} 总来路
{$obj.website_referer_day} 日来路
{$obj.website_referer_week} 周来路
{$obj.website_referer_month} 月来路
{$obj.website_tpl} 自定义模板
{$obj.website_content} 详情
{$obj|mac_url_website_detail} 获取网址详情页链接
~~~
## 网址首页
* 文件目录`html/website/index.html`
* 入口标签`{:mac_url('website/index')}`
* 页面aid值`110`，使用`{$maccms.aid}`标签即可获得当前页面aid值
## 网址分类
* 文件目录`html/website/type.html`
* 入口标签`{:mac_url('website/type')}`
* 页面aid值`111`，使用`{$maccms.aid}`标签即可获得当前页面aid值
* 当前分类数组`$obj`,
* 详细字段参考-**[【分类字段】]**
### 获取当前分类列表示例
~~~
<!-- 列表 -->
{maccms:website num="24" paging="yes" type="current" order="desc" by="time"}
<li><a href="{:mac_url_website_detail($vo)}" title="{$vo.website_name}">
<img src="{:mac_url_img($vo.website_pic)}" alt="{$vo.website_name}"/>
<h2>{$vo.website_name}</h2>
<p>{$vo.website_actor}</p>
<i>{$vo.website_version}</i>
</a></li>
{/maccms:website}
<!-- 通用分页 -->
~~~
## 网址筛选
* 文件目录`html/website/show.html`
* 入口标签`{:mac_url_type(['type_id'=>16],['by'=>'hits'],'show')}`
* 页面aid值`112`，使用`{$maccms.aid}`标签即可获得当前页面aid值
**可传URL参数**
| 参数 | 示例值 | 必有 | 参数说明 |
| --- | --- | --- | --- |
| id | 1 | 是 | 分类id |
| tag | 难 | 否 | 标签 |
| class | B型 | 否 | 扩展分类 |
| lang | 中文 | 否 | 语言 |
| area | 中国 | 否 | 地区 |
| letter | H | 否 | 首字母 |
| order | desc | 否 | 倒序正序筛选 |
| by | time| 否| 排序依据筛选：id, time,time\_add,score,hits,hits\_day,hits\_week,hits\_month,up,down,level |
### 获取筛选结果示例
~~~
<div class="ui-cnt">
<div class="filter-list fn-clear">
<h5>类型：</h5>
<ul>
<li><a {if condition="$param['class'] eq ''"} class="current" {/if} href="{:mac_url_type($obj,['area'=>$param['area'],'lang'=>$param['lang'],'level'=>$param['level'],'letter'=>$param['letter'],'tag'=>$param['tag'],'class'=>'','order'=>$param['order'],'by'=>$param['by'] ],'show')}">全部</a></li>
{maccms:foreach name=":explode(',',$obj.type_extend.class)" id="vo2" key="key2"}
<li><a {if condition="$param['class'] eq $vo2"} class="current" {/if} href="{:mac_url_type($obj,['area'=>$param['area'],'lang'=>$param['lang'],'level'=>$param['level'],'letter'=>$param['letter'],'tag'=>$param['tag'],'class'=>$vo2,'order'=>$param['order'],'by'=>$param['by'] ],'show')}">{$vo2}</a></li>
{/maccms:foreach}
</ul>
</div>
<div class="filter-list fn-clear">
<h5>地区：</h5>
<ul>
<li><a {if condition="$param['area'] eq ''"} class="current" {/if} href="{:mac_url_type($obj,['area'=>'','lang'=>$param['lang'],'level'=>$param['level'],'letter'=>$param['letter'],'tag'=>$param['tag'],'class'=>$param['class'],'order'=>$param['order'],'by'=>$param['by'] ],'show')}">全部</a></li>
{maccms:foreach name=":explode(',',$obj.type_extend.area)" id="vo2" key="key2"}
<li><a {if condition="$param['area'] eq $vo2"} class="current" {/if} href="{:mac_url_type($obj,['area'=>$vo2,'lang'=>$param['lang'],'level'=>$param['level'],'letter'=>$param['letter'],'tag'=>$param['tag'],'class'=>$param['class'],'order'=>$param['order'],'by'=>$param['by'] ],'show')}">{$vo2}</a></li>
{/maccms:foreach}
</ul>
</div>
<div class="filter-list fn-clear">
<h5>语言：</h5>
<ul>
<li><a {if condition="$param['lang'] eq ''"} class="current" {/if} href="{:mac_url_type($obj,['area'=>$param['area'],'lang'=>'','level'=>$param['level'],'letter'=>$param['letter'],'tag'=>$param['tag'],'class'=>$param['class'],'order'=>$param['order'],'by'=>$param['by'] ],'show')}">全部</a></li>
{maccms:foreach name=":explode(',',$obj.type_extend.lang)" id="vo2" key="key2"}
<li><a {if condition="$param['lang'] eq $vo2"} class="current" {/if} href="{:mac_url_type($obj,['area'=>$param['area'],'lang'=>$vo2,'level'=>$param['level'],'letter'=>$param['letter'],'tag'=>$param['tag'],'class'=>$param['class'],'order'=>$param['order'],'by'=>$param['by'] ],'show')}">{$vo2}</a></li>
{/maccms:foreach}
</ul>
</div>
<div class="filter-list filter-list-letter fn-clear">
<h5>字母：</h5>
<ul>
<li><a {if condition="$param['letter'] eq ''"} class="current"{/if} href="{:mac_url_type($obj,['area'=>$param['area'],'lang'=>$param['lang'],'level'=>$param['level'],'letter'=>'','tag'=>$param['tag'],'class'=>$param['class'],'order'=>$param['order'],'by'=>$param['by'] ],'show')}">全部</a></li>
{maccms:foreach name=":explode(',','A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z,0~9')" id="vo2" key="key2"}
<li><a {if condition="$param['letter'] eq $vo2"} class="current"{/if} {/if} href="{:mac_url_type($obj,['area'=>$param['area'],'lang'=>$param['lang'],'level'=>$param['level'],'letter'=>$vo2,'tag'=>$param['tag'],'class'=>$param['class'],'order'=>$param['order'],'by'=>$param['by'] ],'show')}">{$vo2}</a><li>
{/maccms:foreach}
</ul>
</div>
</div>
<!-- 列表 -->
{maccms:website num="24" paging="yes" pageurl="website/show" type="current" order="desc" by="time"}
<li><a href="{:mac_url_website_detail($vo)}" title="{$vo.website_name}">
<img src="{:mac_url_img($vo.website_pic)}" alt="{$vo.website_name}"/>
<h2>{$vo.website_name}</h2>
<p>{$vo.website_actor}</p>
<i>{$vo.website_version}</i>
</a></li>
{/maccms:website}
<!-- 通用分页 -->
~~~
## 网址搜索
* 文件目录`html/website/search.html`
* 入口标签`{:mac_url_search(['wd'=>'优酷'],'website')}`
* 页面aid值`113`，使用`{$maccms.aid}`标签即可获得当前页面aid值
**网址搜索表单**
~~~
<form id="search" name="search" method="get" action="{:mac_url('website/search')}" onSubmit="return qrsearch();">
<input type="text" name="wd" class="mac_wd" value="{$param.wd}" placeholder="网站名称" />
<input type="submit" class="mac_search" value="搜索网站" />
</form>
~~~
**网址搜索结果列表**
~~~
{maccms:website num="10" paging="yes" pageurl="website/search" order="desc" by="time"}
<li><a class="play-img" href="{:mac_url_website_detail($vo)}">
<img src="{:mac_url_img($vo.website_logo)}" alt="logo" /></a>
<h2><a href="{:mac_url_website_detail($vo)}">{$vo.website_name}</a></h2>
<dl><dt>网站：</dt><dd>{$vo.website_website}</dd></dl>
</li>
{/maccms:website}
~~~
## 网址详情
* 文件目录`html/website/index.html`
* 入口标签`{:mac_url_website_detail($vo)}`,在`maccms:website`标签内部使用`$vo`
* 页面aid值`114`，使用`{$maccms.aid}`标签即可获得当前页面aid值
* 当前网站所有信息`$obj`
* 必带参`id`
提示
详情页当前网址数据为`{$obj}`数组,如下查询全部字段可以参考`网址字段`,或者在模板用`{:print_r($obj)}`打印当前网址全部数据。
**示例**
~~~
<h1>网站名称：{$obj.website_name}</h1>
<p>域名：{$obj.website_jumpurl}</p>
<img src="{:mac_url_img($obj.website_logo)}" alt="logo" />
<!-- 网站详细介绍 -->
<div class="content">{$obj.website_content}</div>
<!-- 详情页当前网址数据为 {$obj} 数组,如下查询全部字段可以参考网址字段-->
~~~
**来路统计**
在程序`static/js/home.js`中的`MAC`对象里已经写好了，`MAC.Website.Referer();`，如果模板有引入`home.js`那么无需单独在写逻辑，已经自动实现了。
