文档详情标签

说明：用于获取文档详情数据

使用方法：{% archiveDetail 变量名称 with name="字段名称" id="1" %} 变量名称不是必须的，设置了变量名称后，后续可以通过变量名称来调用，而不设置变量名称，则是直接输出结果。

archiveDetail 支持的参数有：

文档 ID id
id 不是必须的，默认会获取当前文档。如果需要指定文档，可以通过设置 id 来达到目的。
文档 URL 别名 token
token 不是必须的，默认会获取当前文档。如果需要指定文档，可以通过设置 id 或 token 来达到目的。
站点 ID siteId
siteId 一般不需要填写，如果你使用后台的多站点管理创建了多个站点，并且想调用其他站点的数据，则可以通过指定 siteId 来实现调用指定站点的数据。

文档详情页，也可以直接使用 {{archive.文档字段}} 来调用文档字段内容。

如果当前在组合文档 URL 下，URL 形式："/{module}/{id}/c-{combine}.html" 如：”/tour/1/c-2.html”，支持多个文档组合对比,最多支持 5 个，如有多个，则使用隔开，如："/cpu/11/c-12-13-14.html"，则可以使用combineIds 或 combineArchives 来对数据进行数据的渲染对比。

name 参数可用的字段有：

文档 ID Id
文档标题 Title
文档 SEO 标题 SeoTitle
文档链接 Link
文档关键词 Keywords
文档描述 Description
文档内容 Content 支持图片懒加载需要使用标签 lazy="data-src"
文档内容的标题 ContentTitles 返回的是一个数组
文档模型 ID ModuleId
文档模型 ID ParentId
文档分类 ID CategoryId
文档规范链接 CanonicalUrl
文档的用户 ID UserId
价格 Price
库存 Stock
划线价格 OriginPrice
成本价 CostPrice
文档阅读等级 ReadLevel
文档的原文链接 OriginUrl
文档浏览量 Views
文档的 Flag 属性 Flag
文档封面图片 Images
文档封面首图 Logo
文档封面缩略图 Thumb
文档评论数量 CommentCount
文档分类 Category
文档添加时间 CreatedTime 时间戳，需要使用格式化时间戳为日期格式 {{stampToDate(item.CreatedTime, "2006-01-02")}}
文档更新时间 UpdatedTime 时间戳，需要使用格式化时间戳为日期格式 {{stampToDate(item.UpdatedTime, "2006-01-02 15:04:05")}}
文档标签
文档模型设置的其他字段参数
产品视频地址 VideoUrl
产品收藏数量 FavoriteCount
产品评价数量 ReviewCount
产品是否已收藏 IsFavorite
产品是否需要物流 NeedLogistics
产品是否免运费 IsFreeShipping
产品销量 SoldCount
产品SKU 模式 OptionType
产品重量 Weight
产品重量单位 WeightUnit
产品是否支持批发 IsWholesale
产品是否允许超卖 AllowOversold
产品是否有有订单扩展字段 HasOrderFields
产品订单扩展字段 OrderFields
产品规格属性 Options
产品规格列表 Skus
产品当前选中的SKU Sku
产品批发配置 WholesaleRules

文档 ID `Id`

标签用法：{% archiveDetail with name="Id" %}

{# 默认用法，自动获取当前页面文档 #}
<div>分类标题：{% archiveDetail with name="Id" %}</div>
{# 获取指定文档id的文档字段 #}
<div>分类标题：{% archiveDetail with name="Id" id="1" %}</div>
{# 自定义字段名称 #}
<div>分类标题：{% archiveDetail archiveId with name="Id" %}{{archiveId}}</div>
<div>分类标题：{% archiveDetail archiveId with name="Id" id="1" %}{{archiveId}}</div>

文档标题 `Title`

标签用法：{% archiveDetail with name="Title" %}

{# 默认用法，自动获取当前页面文档 #}
<div>文档标题：{% archiveDetail with name="Title" %}</div>
{# 获取指定文档id的文档字段 #}
<div>文档标题：{% archiveDetail with name="Title" id="1" %}</div>
{# 自定义字段名称 #}
<div>文档标题：{% archiveDetail archiveTitle with name="Title" %}{{archiveTitle}}</div>
<div>文档标题：{% archiveDetail archiveTitle with name="Title" id="1" %}{{archiveTitle}}</div>

文档链接 `Link`

标签用法：{% archiveDetail with name="Link" %}

{# 默认用法，自动获取当前页面文档 #}
<div>文档链接：{% archiveDetail with name="Link" %}</div>
{# 获取指定文档id的文档字段 #}
<div>文档链接：{% archiveDetail with name="Link" id="1" %}</div>
{# 自定义字段名称 #}
<div>文档链接：{% archiveDetail archiveLink with name="Link" %}{{archiveLink}}</div>
<div>文档链接：{% archiveDetail archiveLink with name="Link" id="1" %}{{archiveLink}}</div>

文档描述 `Description`

标签用法：{% archiveDetail with name="Description" %}

{# 默认用法，自动获取当前页面文档 #}
<div>文档描述：{% archiveDetail with name="Description" %}</div>
{# 获取指定文档id的文档字段 #}
<div>文档描述：{% archiveDetail with name="Description" id="1" %}</div>
{# 自定义字段名称 #}
<div>文档描述：{% archiveDetail archiveDescription with name="Description" %}{{archiveDescription}}</div>
<div>文档描述：{% archiveDetail archiveDescription with name="Description" id="1" %}{{archiveDescription}}</div>

文档内容 `Content`

标签用法：{% archiveDetail with name="Content" %} Content 字段支持图片的 lazyload 用法。需要用 lazy="{定义的src名}"来处理，比如你使用的 lazyload 插件需要将 <img src="" /> 改成 <img data-src="" />，则这么调用 lazy="data-src"

Content 字段在开启 Markdown 编辑器后，会自动对内容进行 Markdown 转 html 操作，关闭 Markdown 编辑器编辑器后，Content 内容不会自动对内容进行 Markdown 转 html 操作。但你可以手动指定是否进行转换，需要添加render参数。接受false|true两个值。render=false不进行 Markdown 转 html 操作，render=true进行转换。

{# 默认用法，自动获取当前页面文档 #}
<div>文档内容：{% archiveDetail with name="Content" %}</div>
{# 获取指定文档id的文档字段 #}
<div>文档内容：{% archiveDetail with name="Content" id="1" %}</div>
{# 自定义字段名称 #}
<div>文档内容：{% archiveDetail archiveContent with name="Content" %}{{archiveContent|safe}}</div>
<div>文档内容：{% archiveDetail archiveContent with name="Content" id="1" %}{{archiveContent|safe}}</div>
{# lazyload 替换 #}
<div>文档内容：{% archiveDetail archiveContent with name="Content" lazy="data-src" %}{{archiveContent|safe}}</div>
{# markdown 转 html #}
<div>文档内容：{% archiveDetail archiveContent with name="Content" render=true %}{{archiveContent|safe}}</div>
{# 不进行markdown转换 #}
<div>文档内容：{% archiveDetail archiveContent with name="Content" render=false %}{{archiveContent|safe}}</div>

文档内容的标题 `ContentTitles`

标签用法：{% archiveDetail contentTitles with name="ContentTitles" %}

返回的是一个数组，内含的对象有： {Title: "标题", Tag: "标签", Level: 层级, Prefix: "前缀"}

需要使用循环来调用：

{% archiveDetail contentTitles with name="ContentTitles" %}
<div>
{% for item in contentTitles %}
    <div class="{{item.Tag}}" level="{{item.Level}}">{{item.Prefix}} {{item.Title}}</div>
{% endfor %}
</div>

文档分类 ID `CategoryId`

标签用法：{% archiveDetail with name="CategoryId" %}

{# 默认用法，自动获取当前页面文档 #}
<div>文档分类ID：{% archiveDetail with name="CategoryId" %}</div>
{# 获取指定文档id的文档字段 #}
<div>文档分类ID：{% archiveDetail with name="CategoryId" id="1" %}</div>
{# 自定义字段名称 #}
<div>文档分类ID：{% archiveDetail archiveCategoryId with name="CategoryId" %}{{archiveCategoryId}}</div>
<div>文档分类ID：{% archiveDetail archiveCategoryId with name="CategoryId" id="1" %}{{archiveCategoryId}}</div>

文档浏览量 `Views`

标签用法：{% archiveDetail with name="Views" %}

{# 默认用法，自动获取当前页面文档 #}
<div>文档浏览量：{% archiveDetail with name="Views" %}</div>
{# 获取指定文档id的文档字段 #}
<div>文档浏览量：{% archiveDetail with name="Views" id="1" %}</div>
{# 自定义字段名称 #}
<div>文档浏览量：{% archiveDetail archiveViews with name="Views" %}{{archiveViews}}</div>
<div>文档浏览量：{% archiveDetail archiveViews with name="Views" id="1" %}{{archiveViews}}</div>

文档封面首图 `Logo`

标签用法：{% archiveDetail with name="Logo" %}

{# 默认用法，自动获取当前页面文档 #}
<div>文档封面首图：<img src="{% archiveDetail with name="Logo" %}" alt=""/></div>
{# 获取指定文档id的文档字段 #}
<div>文档封面首图：<img src="{% archiveDetail with name="Logo" id="1" %}" alt=""/></div>
{# 自定义字段名称 #}
<div>文档封面首图：<img src="{% archiveDetail archiveLogo with name="Logo" %}{{archiveLogo}}" alt=""/></div>
<div>文档封面首图：<img src="{% archiveDetail archiveLogo with name="Logo" id="1" %}{{archiveLogo}}" alt=""/></div>

文档封面缩略图 `Thumb`

标签用法：{% archiveDetail with name="Thumb" %}

{# 默认用法，自动获取当前页面文档 #}
<div>文档封面缩略图：<img src="{% archiveDetail with name="Thumb" %}" alt=""/></div>
{# 获取指定文档id的文档字段 #}
<div>文档封面缩略图：<img src="{% archiveDetail with name="Thumb" id="1" %}" alt=""/></div>
{# 自定义字段名称 #}
<div>文档封面缩略图：<img src="{% archiveDetail archiveThumb with name="Thumb" %}{{archiveThumb}}" alt=""/></div>
<div>文档封面缩略图：<img src="{% archiveDetail archiveThumb with name="Thumb" id="1" %}{{archiveThumb}}" alt=""/></div>

文档封面图片 `Images`

Images 是一组图片，因此需要使用自定义方式来获取并循环输出

标签用法：{% archiveDetail archiveImages with name="Images" %}

{# 自定义字段名称 #}
<div>文档封面图片：
    {% archiveDetail archiveImages with name="Images" %}
    {% for item in archiveImages %}
        <img src="{{item}}" alt=""/>
    {% endfor %}
</div>
<div>文档封面图片：
    {% archiveDetail archiveImages with name="Images" id="1" %}
    {% for item in archiveImages %}
        <img src="{{item}}" alt=""/>
    {% endfor %}
</div>

文档添加时间 `CreatedTime`

CreatedTime 支持预格式化时间。用2006-01-02表示年-月-日，用15:04::05表示时分秒。如需要显示格式为 2021 年 06 月 30 日，可以写成format="2006年01月02日"，如需要显示格式为 2021/06/30 12:30，可以写成format="2006/01/02 15:04"。如果不设置 format，在默认用法下，它会自动被格式化为2006-01-02。

标签用法：{% archiveDetail with name="CreatedTime" format="2006-01-02 15:04" %}

{# 默认用法，自动获取当前页面文档 #}
<div>文档添加时间：{% archiveDetail with name="CreatedTime" %}</div>
<div>文档添加时间：{% archiveDetail with name="CreatedTime" format="2006-01-02 15:04" %}</div>
{# 获取指定文档id的文档字段 #}
<div>文档添加时间：{% archiveDetail with name="CreatedTime" id="1" %}</div>
<div>文档添加时间：{% archiveDetail with name="CreatedTime" id="1" format="2006-01-02 15:04" %}</div>
{# 自定义字段名称 #}
<div>文档添加时间：{% archiveDetail archiveCreatedTime with name="CreatedTime" %}{{archiveCreatedTime}}</div>
<div>文档添加时间：{% archiveDetail archiveCreatedTime with name="CreatedTime" id="1" %}{{archiveCreatedTime}}</div>
<div>文档添加时间：{% archiveDetail archiveCreatedTime with name="CreatedTime" format="2006-01-02" %}{{archiveCreatedTime}}</div>
<div>文档添加时间：{% archiveDetail archiveCreatedTime with name="CreatedTime" id="1" format="2006-01-02 15:04" %}{{archiveCreatedTime}}</div>

文档更新时间 `UpdatedTime`

UpdatedTime 支持预格式化时间。用2006-01-02表示年-月-日，用15:04::05表示时分秒。如需要显示格式为 2021 年 06 月 30 日，可以写成format="2006年01月02日"，如需要显示格式为 2021/06/30 12:30，可以写成format="2006/01/02 15:04"。如果不设置 format，在默认用法下，它会自动被格式化为2006-01-02。

标签用法：{% archiveDetail with name="UpdatedTime" format="2006-01-02 15:04" %}

{# 默认用法，自动获取当前页面文档 #}
<div>文档更新时间：{% archiveDetail with name="UpdatedTime" %}</div>
<div>文档更新时间：{% archiveDetail with name="UpdatedTime" format="2006-01-02 15:04" %}</div>
{# 获取指定文档id的文档字段 #}
<div>文档更新时间：{% archiveDetail with name="UpdatedTime" id="1" %}</div>
<div>文档更新时间：{% archiveDetail with name="UpdatedTime" id="1" format="2006-01-02 15:04" %}</div>
{# 自定义字段名称 #}
<div>文档更新时间：{% archiveDetail archiveUpdatedTime with name="UpdatedTime" %}{{archiveUpdatedTime}}</div>
<div>文档更新时间：{% archiveDetail archiveUpdatedTime with name="UpdatedTime" id="1" %}{{archiveUpdatedTime}}</div>
<div>文档更新时间：{% archiveDetail archiveUpdatedTime with name="UpdatedTime" format="2006-01-02" %}{{archiveUpdatedTime}}</div>
<div>文档更新时间：{% archiveDetail archiveUpdatedTime with name="UpdatedTime" id="1" format="2006-01-02 15:04" %}{{archiveUpdatedTime}}</div>

文档分类 `Category`

{% archiveDetail archiveCategory with name="Category" %}
<a href="{{ archiveCategory.Link }}">
    <span>分类ID：{{archiveCategory.Id}}</span>
    <span>分类名称：{{archiveCategory.Title}}</span>
    <span>分类链接：{{archiveCategory.Link}}</span>
    <span>分类描述：{{archiveCategory.Description}}</span>
    <span>上级分类ID：{{archiveCategory.ParentId}}</span>
</a>
<div>缩略图大图：<img src="{{archiveCategory.Logo}}" alt="{{archiveCategory.Title}}" /></div>
<div>缩略图：<img src="{{archiveCategory.Thumb}}" alt="{{archiveCategory.Title}}" /></div>

{# 或者使用categoryDetail方式调用 #}
<span>分类ID：{% categoryDetail with name="Id" id=archive.Id %}</span>
<span>分类名称：{% categoryDetail with name="Title" id=archive.Id %}</span>
<span>分类链接：{% categoryDetail with name="Link" id=archive.Id %}</span>
<span>分类描述：{% categoryDetail with name="Description" id=archive.Id %}</span>
<span>上级分类ID：{% categoryDetail with name="ParentId" id=archive.Id %}</span>
<div>缩略图大图：<img src="{% categoryDetail with name="Logo" id=archive.Id %}" /></div>
<div>缩略图：<img src="{% categoryDetail with name="Thumb" id=archive.Id %}" /></div>

文档标签

{% tagList tags with limit="10" %}
{% for item in tags %}
<a href="{{item.Link}}">{{item.Title}}</a>
{% endfor %}
{% endtagList %}

文档模型设置的其他字段参数

循环所有的字段

{% archiveParams params %}
<div>
    {% for item in params %}
    <div>
        <span>{{item.Name}}：</span>
        <span>{{item.Value}}</span>
    </div>
    {% endfor %}
</div>
{% endarchiveParams %}

如果你想只显示某个自定义字段的内容，如你自定义字段为 author，那么在模板中就可以这样调用：

{% archiveDetail with name="author" %}

自定义字段参数的使用，例如，你自定义了一个组图的字段，为 arcimages，并且想在前端展示它们，可以这么写：

{% archiveDetail arcimages with name="arcimages" %}
<ul class="arc-images">
  {% for img in arcimages %}
  <li><img src="{{img}}" /></li>
  {% endfor %}
</ul>

常见使用实例

常见文章详情，在文档详情页面显示文档标题、文档分类、文档发布时间、文档标签、文档浏览量、文档详情。如图：

调用代码示例（代码不包含 css 样式控制）

<article>
    <h1>{% archiveDetail with name="Title" %}</h1>
    <div>
        <a href="{% categoryDetail with name='Link' %}">{% categoryDetail with name='Title' %}</a>
        <span>{% archiveDetail with name="CreatedTime" format="2006-01-02" %}</span>
        {% tagList tags with limit="10" %}
        {% for item in tags %}
        <a href="{{item.Link}}">{{item.Title}}</a>
        {% endfor %}
        {% endtagList %}
        <span>{% archiveDetail with name="Views" %}°</span>
    </div>
    <div>
        {%- archiveDetail articleContent with name="Content" %}
        {{articleContent|safe}}
    </div>
</article>

常见产品详情，在文档详情页面显示产品图片、产品名称、产品参数、产品简介、产品详情。如图：

调用代码示例（代码不包含 css 样式控制）

<article>
    <div>
        <div>
            <img src="{% archiveDetail with name='Logo' %}" alt="{% archiveDetail with name='Title' %}" />
        </div>
        <div>
            <h1>{% archiveDetail with name="Title" %}</h1>
            {% archiveParams params %}
            {% for item in params %}
            <div>
                <span>{{item.Name}}：</span>
                <span>{{item.Value}}</span>
            </div>
            {% endfor %}
            {% endarchiveParams %}
            <div>{% archiveDetail with name="Description" %}</div>
            <div>
                <a href="tel:{% contact with name='Cellphone' %}" rel="nofollow">电话联系：{% contact with name="Cellphone" %}</a>
            </div>
        </div>
    </div>
    <div>
        <div>产品详情</div>
        <div>
            {%- archiveDetail articleContent with name="Content" %}
            {{articleContent|safe}}
        </div>
    </div>
</article>

文档详情标签

name 参数可用的字段有：

文档 ID Id

文档标题 Title

文档链接 Link

文档描述 Description

文档内容 Content

文档内容的标题 ContentTitles

文档分类 ID CategoryId

文档浏览量 Views

文档封面首图 Logo

文档封面缩略图 Thumb

文档封面图片 Images

文档添加时间 CreatedTime

文档更新时间 UpdatedTime

文档分类 Category