易优优惠卷coupongoods标签说明

{eyou:coupongoods}` 标签的使用说明整理得更清晰、有条理，方便查阅和使用。我会按照**核心定义-使用规则-实战应用-注意事项**的逻辑重新梳理，让整个文档更易读、更实用。 --- # {eyou:coupongoods} 标签完整使用手册 ## 一、标签核心定义 ### 1. 标签作用 用于在易优CMS模板中查询并展示指定优惠券可使用的商品列表，支持分页、筛选、排序、自定义字段等功能。 ### 2. 基础语法 ```smarty {eyou:coupongoods id='field' coupon_id='123' 其他属性}    <!-- 循环内容：通过 {$field.字段名} 访问商品数据 --> {/eyou:coupongoods} ``` ## 二、核心属性说明（按优先级/常用度排序） | 属性名     | 类型   | 默认值 | 必填 | 核心说明                                                                 | |------------|--------|--------|------|--------------------------------------------------------------------------| | coupon_id  | 数字   | -      | 是   | 优惠券ID，无此参数无法查询商品                                           | | id         | 字符串 | field  | 否   | 循环变量名，内部通过 `{$id.字段名}` 访问数据                             | | page       | 数字   | 1      | 否   | 页码，用于分页（与limit二选一）                                          | | pagesize   | 数字   | -      | 否   | 每页显示数量（推荐用于分页，与limit二选一）                               | | limit      | 数字   | 15     | 否   | 限制返回总数量（与pagesize二选一）                                       | | orderby    | 字符串 | -      | 否   | 排序字段（如 aid、add_time、sales_num 销量、real_sales 真实销量）         | | ordermode  | 字符串 | desc   | 否   | 排序模式：asc（升序）/ desc（降序），需配合orderby使用                   | | typeid     | 数字   | -      | 否   | 筛选指定分类ID的商品                                                     | | keywords   | 字符串 | -      | 否   | 关键词搜索（多关键词用逗号分隔）                                         | | flag       | 字符串 | -      | 否   | 筛选标记商品（如 c=推荐、h=头条，多标记用逗号分隔）                      | | noflag     | 字符串 | -      | 否   | 排除指定标记的商品                                                       | | addfields  | 字符串 | -      | 否   | 附加字段（多字段用逗号分隔，如 content、stock_count）                    | | arcrank    | 字符串 | off    | 否   | 是否显示作者信息：on=显示 / off=隐藏                                    | | titlelen   | 数字   | 100    | 否   | 商品标题截取长度                                                         | | infolen    | 数字   | 160    | 否   | 商品描述截取长度                                                         | | empty      | 字符串 | -      | 否   | 无数据时显示的提示内容（如“暂无可用商品”）                               | | key        | 字符串 | i      | 否   | 循环键名变量，配合mod实现奇偶行样式                                      | | mod        | 数字   | 2      | 否   | 循环取模值，用于奇偶行样式控制                                           | ## 三、可用商品字段说明 | 字段名            | 类型   | 核心说明                                                                 | |-------------------|--------|--------------------------------------------------------------------------| | aid               | 数字   | 商品ID                                                                   | | title             | 字符串 | 商品标题（已按titlelen截取）                                             | | litpic            | 字符串 | 商品封面图URL                                                            | | users_price       | 数字   | 会员折扣后的价格                                                         | | old_price         | 数字   | 商品原价                                                                 | | sales_num         | 数字   | 总销量（含虚拟销量）                                                     | | real_sales        | 数字   | 真实销量                                                                 | | add_time_format   | 字符串 | 格式化的添加时间（如 2026-02-11）                                        | | typename          | 字符串 | 商品分类名称                                                             | | users             | 数组   | 作者/会员信息（仅arcrank='on'时可用，如 $field.users.nickname 昵称）     | | content           | 字符串 | 商品详情内容（需addfields='content'才返回）                              | | 自定义字段        | -      | 通过addfields指定的附加字段（如 stock_count 库存）                        | ## 四、典型使用示例 ### 示例1：基础商品列表（按销量排序） ```smarty {eyou:coupongoods id='goods' coupon_id='123' orderby='sales_num' ordermode='desc' empty='暂无可用商品'} <div class="goods-item">    <a href="{$goods.arcurl}">        <img src="{$goods.litpic}" alt="{$goods.title}">        <h3>{$goods.title}</h3>        <div class="price">¥{$goods.users_price}</div>        <div class="sales">销量：{$goods.sales_num}</div>    </a> </div> {/eyou:coupongoods} ``` ### 示例2：分页+分类+推荐商品筛选 ```smarty {eyou:coupongoods id='goods' coupon_id='123' page='1' pagesize='8' typeid='5' flag='c' orderby='add_time' ordermode='desc'} <div class="goods-item">    <a href="{$goods.arcurl}">        <img src="{$goods.litpic}" alt="{$goods.title}">        <h3>{$goods.title}</h3>        <div class="price">¥{$goods.users_price}（原价¥{$goods.old_price}）</div>    </a> </div> {/eyou:coupongoods} ``` ### 示例3：奇偶行样式+作者信息 ```smarty {eyou:coupongoods id='goods' coupon_id='123' key='i' mod='2' arcrank='on'} <div class="goods-item {if $mod eq 1}even{else}odd{/if}">    <a href="{$goods.arcurl}">        <img src="{$goods.litpic}" alt="{$goods.title}">        <h3>{$goods.title}</h3>        <div class="author">商家：{$goods.users.nickname}</div>    </a> </div> {/eyou:coupongoods} ``` ### 示例4：完整带样式的商品列表（生产级） ```smarty <div class="coupon-goods-list">    <h2>优惠券可用商品</h2>    {eyou:coupongoods id='goods' coupon_id='{$coupon_id}' page='1' pagesize='12' orderby='sales_num' ordermode='desc' empty='暂无可用商品'}    <div class="goods-item">        <a href="{$goods.arcurl}">            <div class="goods-image"><img src="{$goods.litpic}" alt="{$goods.title}"></div>            <div class="goods-info">                <h3>{$goods.title}</h3>                <div class="goods-price">                    <span class="current-price">¥{$goods.users_price}</span>                    <span class="old-price">¥{$goods.old_price}</span>                </div>                <div class="goods-meta">                    <span class="sales">销量：{$goods.sales_num}</span>                    <span class="date">上架时间：{$goods.add_time_format}</span>                </div>            </div>        </a>    </div>    {/eyou:coupongoods} </div> ``` ## 五、关键注意事项 1. **必填项**：`coupon_id` 是唯一必填参数，需确保为有效ID（可通过 `{eyou:coupon}` 标签获取）； 2. **分页规则**：`page+pagesize` 用于分页，`limit` 用于限制总数量，二者不可同时使用； 3. **优惠券类型影响**：分类券（类型3）自动查对应分类商品，商品券（类型2）自动查指定商品ID； 4. **字段获取规则**：作者信息需 `arcrank='on'`，自定义字段需 `addfields` 指定； 5. **数据访问**：内部通过 `{$id.字段名}` 访问，`id` 是标签中设置的循环变量名（如示例中的 `goods`）。 --- ### 总结 1. `{eyou:coupongoods}` 核心是通过 `coupon_id` 查询优惠券可用商品，支持分页、筛选、排序等核心功能； 2. 核心使用逻辑：指定优惠券ID → 配置筛选/分页/排序属性 → 循环渲染商品字段； 3. 关键规则：分页参数二选一、作者/自定义字段需显式开启、优惠券类型会自动过滤商品范围。