商城：{naicha:shop}

把商品放到任意页面（首页推荐位、活动页）—— 全部参数、循环字段、排序键，以及一个完整的首页商品区。

适用范围：首页、活动页、商城列表页（shop_list.html）。

为什么需要这个标签

商城默认只有一个商品列表页（/shop）。但「首页放四件推荐商品」「活动页放两件套装」这类需求非常常见 —— 以前没有标签可用，只能去改 PHP。{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:shop} 输出空。 模板是站长写死的，关掉商城之后首页上那一节应该自然消失，而不是露出一个空框 —— 所以这里不是「输出 0 件商品的空列表」，而是整块不输出。

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

<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。