指定栏目标签

指定栏目标签用于获取某个特定栏目的信息，或输出该栏目及其子栏目列表。与「当前栏目」标签不同，它可以在任意页面指定栏目编码或栏目ID。

1. 指定单栏目信息（块标签）

通过 id 或 scode 获取某个栏目的全部字段。

{soeay:sort id=5}
    <h1>[soeay:name]</h1>
    <p>[soeay:description]</p>
    <img src="[soeay:ico]" alt="[soeay:name]">
{/soeay:sort}

{soeay:sort scode=5}
    <h1>[soeay:name]</h1>
{/soeay:sort}

属性	说明
id	栏目数据库ID，与 scode 二选一
scode	栏目编码，与 id 二选一

2. 指定栏目列表（块标签）

输出指定栏目的子栏目或同级栏目，常用于侧边栏子导航。

{soeay:sortlist scode=5 num=10}
    <li><a href="[soeay:link]">[soeay:name]</a></li>
{/soeay:sortlist}

属性	说明	默认值
scode	父栏目编码，与 id 二选一	无
id	父栏目数据库ID，与 scode 二选一	无
type	类型：child（子栏目）/ tree（含自身）/ self（仅自身）	child
num	显示数量	100

3. 当前栏目信息（单标签）

如果您想获取当前页面所在栏目的信息，请使用单标签形式，详细说明请参见「当前栏目标签」章节。

{soeay:sort.scode}      当前栏目编码
{soeay:sort.name}       当前栏目名称
{soeay:sort.filename}   当前栏目URL标识
{soeay:sort.tcode}      当前顶级栏目编码

4. 自闭合内联标签（属性值内取栏目）

块标签 {soeay:sort} 只能包裹整段模板代码，不能塞进 <a href="..."> 或其他 HTML 属性值里——块标签正则在属性值内会与模板里其他块标签产生交错配对错乱，导致后续内容丢失。

当您需要在 属性值 中动态引用某个栏目的 URL 或字段时，请使用以下两个自闭合内联标签（不进块标签正则，与 PbootCMS {pboot:sort} 块标签的常用场景对齐）：

4.1 `{soeay:sort_link}` —— 获取指定栏目的链接

返回栏目列表页或单页的绝对路径，可直接作为 href 属性值使用。栏目 filename 在后台变更时，前台自动跟随更新。

<!-- 按 scode 取（推荐） -->
<a href="{soeay:sort_link scode=4}">查看全部开发动态</a>

<!-- 按数据库 id 取 -->
<a href="{soeay:sort_link id=12}">进入应用插件列表</a>

<!-- 实际输出：/devnews.html 或 /store.html -->

属性	说明
scode	栏目编码，与 id 二选一
id	栏目数据库ID，与 scode 二选一

4.2 `{soeay:sort_field}` —— 获取指定栏目的任意字段

取栏目表（soeay_content_sort）中的任意字段值，如名称、描述、标题、SEO 关键词等。

{soeay:sort_field scode=4 field=name}       // 开发动态
{soeay:sort_field scode=4 field=title}      // SEO 标题
{soeay:sort_field scode=4 field=keywords}   // SEO 关键词
{soeay:sort_field scode=4 field=ico}        // 栏目缩略图路径

属性	说明
scode	栏目编码，与 id 二选一
id	栏目数据库ID，与 scode 二选一
field	栏目字段名，默认 `link`（等价于 sort_link）

栏目表常用字段：name（名称）、title（SEO 标题）、description（描述）、keywords（SEO 关键词）、filename（URL 标识）、ico（缩略图）、scode（编码）、mcode（模型类型）、outlink（外跳链接）。

注意事项

{soeay:sort} 块标签与 {soeay:sort.xxx} 单标签是两套用法，不要混淆。
块标签必须指定 id 或 scode，否则不会输出任何内容。
循环体内的 [soeay:link] 会自动生成栏目链接（单页模型直接跳转，列表模型进入列表页）。
块标签 {soeay:sort} 不可写在 HTML 属性值内（如 <a href="{soeay:sort scode=4}[soeay:link]{/soeay:sort}">），会导致块标签正则交错配对错乱、后续模板内容丢失。属性值内请使用自闭合标签 {soeay:sort_link scode=4} 或 {soeay:sort_field scode=4 field=xxx}。

开发手册