商城与商家标签

为什么需要商品标签

商城默认只有一个商品列表页（/shop）。但「首页放四件推荐商品」「活动页放两件套装」 这类需求非常常见 —— 以前没有标签可用，只能去改 PHP。{naicha:shop} 就是为这件事加的： 商品能不能出现在某个页面，应该由模板作者决定，而不是由内核决定。

{naicha:shop} —— 取商品

{naicha:shop num="4" order="sort desc"}
  <a href="{shop.url}">
    <img src="{shop.thumb_url}" alt="{shop.title}">
    <h3>{shop.title}</h3>
    <p>{shop.summary excerpt="42"}</p>
    <span>{shop.price}</span>
  </a>
{/naicha:shop}

参数

循环里能用的字段（一律 {shop.xxx}）

标签外可用的两个变量

• {shopTotal} —— 符合条件的商品总数。写空状态就靠它： {naicha:if var="shopTotal" eq="0"}…{/naicha:if}
• {shopItems} —— 本次实际取到几件

命名与 {naicha:list} 的 listTotal/listItems 是同一套， 两个标签的写法不用换脑子。

排序只能用内置的键

order 只认这几个（写别的不会报错，会静默回落到 sort desc —— 所以写错了页面上看起来"正常"，只是顺序不对）：

sort desc、sort asc、publish desc、publish asc、 hits desc、id desc、id asc。

{naicha:merchants} —— 推荐商家

{naicha:merchants num="8" featured="1"}
  <a href="{merchant.url}">{merchant.name}</a>
  <img src="{merchant.show_shot}" alt="{merchant.show_name}">
{/naicha:merchants}

featured="1" 只取勾了「首页推荐」的（首页那一节用）；不传则取全部显示中的（列表页用）。

把商品放到首页的完整例子

<div class="shop-grid">
  {naicha:shop num="4" order="sort desc"}
  <a class="shop-card" href="{shop.url}">
    <div class="shop-thumb">
      {naicha:if var="shop.thumb_url" notempty="1"}
      <img src="{shop.thumb_url}" alt="{shop.title}" loading="lazy">
      {naicha:else}
      <span class="shop-noimg">{shop.kind_label}</span>
      {/naicha:if}
    </div>
    <div class="shop-info">
      <h3>{shop.title}</h3>
      <p class="shop-sum">{shop.summary excerpt="42"}</p>
      <div class="shop-foot">
        <span class="shop-price">{shop.price}</span>
        <span class="shop-sold">{shop.sold_text}</span>
      </div>
    </div>
  </a>
  {/naicha:shop}
</div>

这几个 class（shop-grid/shop-card/shop-thumb/ shop-info/shop-foot/shop-price/shop-sold/ shop-noimg）主样式表里都有，直接抄就能用，不用自己写 CSS。