易优EyouCMS程序中adv标签获取广告列表的使用方法及示例

一、基础用法

标签名称：{eyou:adv}
描述：用于根据广告位ID（pid）获取广告列表，支持数量控制、排序方式、自定义变量名等。
语法格式：
```
 
```
html

{eyou:adv pid='广告位ID' loop='显示条数'} <a href="{$field.links}"><img src="{$field.litpic}" alt="{$field.title}" /></a> {/eyou:adv}

二、常用属性说明

属性名	必填	说明
`pid`	是	广告位置ID，对应后台广告位设置中的唯一标识
`loop`	否	调用广告数量，默认为10条
`orderby`	否	排序方式：<br>`now`（按发布时间）、<br>`hot` / `click`（点击量）、<br>`sort_order`（排序号）、<br>`rand`（随机）、<br>或自定义组合如 `sort_order asc, id desc`
`currentclass`	否	当前广告应用的样式类名（可用于高亮当前项）
`empty`	否	没有广告数据时显示的内容
`mod`	否	每隔N行输出特定内容，常用于布局换行或添加分隔线
`id`	否	自定义循环变量名，默认是 `field`，可设为 `field1` 等

三、使用示例

示例1：调用指定广告位的3个广告并展示图片链接

html

{eyou:adv pid='1' loop='3'} <a href="{$field.links}"><img src="{$field.litpic}" alt="{$field.title}" /></a> {/eyou:adv}

说明：调用广告位ID为1的广告，最多显示3条，并展示图片和链接。

示例2：按点击量排序展示广告

html

{eyou:adv pid='2' loop='5' orderby='click'} <div class="ad-item"> <h3>{$field.title}</h3> <a href="{$field.links}"><img src="{$field.litpic}" alt="{$field.title}" /></a> </div> {/eyou:adv}

说明：调用广告位ID为2的广告，按点击量从高到低排序，显示前5条。

示例3：使用自定义变量名 field1

html

{eyou:adv pid='3' loop='4' id='field1'} <li> <a href="{$field1.links}">{$field1.title}</a> </li> {/eyou:adv}

说明：通过 id='field1' 设置自定义变量名，并在模板中使用 $field1.title 调用广告标题。

示例4：广告为空时提示信息

html

{eyou:adv pid='999' empty='暂无广告'} <a href="{$field.links}"><img src="{$field.litpic}" alt="{$field.title}" /></a> {/eyou:adv}

说明：如果广告位ID为999没有广告，则显示“暂无广告”。

示例5：每隔2条广告插入一个清除浮动的div

html

{eyou:adv pid='1' loop='6' mod='2'} <li><a href="{$field.links}"><img src="{$field.litpic}" alt="{$field.title}" /></a></li> {eyou:if condition='$mod eq 0'}<div class="clearfix"></div>{/eyou:if} {/eyou:adv}