1. 归档标签:una_archives

1.1 归档标签语法

标签语法:

<@una_archives>
    ...
</@una_archives>

归档标签将对后台内容进行归档处理,以文章创建时间按照降序排列进行分组;返回一个List列表,列表的key为results。Archive对象包含两个属性:name(归档名称,yyyy-MM)和count(文章数量)

1.2 归档标签示例

下面是归档标签的使用示例代码:

<div class="archive-box">
    <div class="archive-title">
        <h3 class="text">归档</h3>
    </div>
    <div class="archive-list">
        <ul>
            <@una_archives>
                <#if results?? && results?size gt 0>
                    <#list results as archive>
                        <li><a href="${una}/archives/${archive.name}">${archive.name} [${archive.count}]篇文章</a></li>
                    </#list>
                </#if>
            </@una_archives>
        </ul>
    </div>
</div>

1.3 归档标签参数

归档标签无任何参数

2.归档文章标签:una_archive_post

归档文章标签用于获取某个归档下的所有文章,通常会在归档详情页中使用此标签。

2.1 归档文章标签语法

归档文章标签语法如下:

<@una_archive_post name="archiveName">
    ...
</@una_archive_post>

使标签成功解析后将返回一个文章列表List results。

2.2 归档文章标签示例

假设有一个名为“2019年11月的归档”,现需要获取该归档下的所有文章,示例代码如下:

<div class="post-box">
    <ul class="post-list">
        <@una_archive_post name="2019年11月">
               <#if results?? && results?size gt 0>
                <#list results as post>
                    <li><a href="${una}/post/${post.slug}" target="_blank">
                        ${post.title}
                        </a>
                    </li>
                </#list>
            </#if>
        </@una_archive_post>
    </ul>
</div>

2.3 归档文章标签参数

参数名 必须 类型 说明
name String 归档名称,无默认值,若该参数缺省,将返回null

3.关联文章标签:una_associate_post

关联文章标签用于在文章详情页面获取与之有关联性的文章。

3.1 关联文章标签语法

<@una_associate_post id=currentPostId size=associatePostSize>
...
</@una_associate_post>

3.2 关联文章标签示例

假定当期文章编号为1,通过关联文章标签获取与之相关的5篇文章,示例如下:

<div class="associate-post-box">
    <ul class="post-list">
        <@una_associate_post id=1 size=15>
            <#if results?? && results?size gt 0>
                <#list results as post>
                    <li><a href="${una}/post/${post.slug}">${post.title}</a></li>    
                </#list>
            </#if>
        </@una_associate_post>    
    </ul>
</div>

3.3 关联文章标签参数

参数名 必须 类型 说明
id Integer 当前文章ID
size Integer 获取数量,默认为4篇

4. 导航标签:una_navigate

只有在后台将栏目设置为导航栏可见,该标签才会获取值。

4.1 导航标签语法

<@una_navigate>
    ...
</@uan_navigate>

4.2 导航标签示例

<nav>
    <ul>
        <@una_navigate>
            <#if results?? && results?size gt 0>
                <#list results as nav>
                    <li><a href="${una}/${nav.slug}">${nav.name}</a></li>
                </#list>
            </#if>
        </@una_navigate>
    </ul>
</nav>

5. 栏目文章标签:una_category_post

该标签用于获取栏目下所有以发布的文章。

5.1 栏目文章标签语法

<@una_category_post category=categoryId>
...
</@una_category_post>

此标签可应用于指南等教程栏目中,获取某个指南的全部章节内容

5.2 代码示例

<div>
    <ul>
        <@una_category_post category=1>
            <#if posts?? && posts?size gt 0>
                <#list posts as post>
                    <li><a href="${una}/post/${post.slug}">${post.title}</a></li> 
                </#list>
            </#if>
        </@una_category_post>
    </ul>
</div>

注:category参数必须提供,否则将返回null

6 . 热门文章标签:una_hottest

该标签用于获取后台中访问量最高的文章,格式如下:

<@una_hottest size=5>
    ...
</@una_hottest>

其中,size为取值数量,若不设置,系统默认取5篇访问量最高的文章,并按照访问量进行降序排列。

7. 最新文章标签:una_newest

该标签用于获取最新发布的文章,格式如下:

<@una_newest size=10>
    ...
</@una_newest>

其中,size的默认值为5,若不设置size属性,则以默认值获取最新发布的文章,并根据发布时间进行降序排列。

8. 文章Tag标签:una_post_tags

该标签用于获取文章的tag列表,格式如下:

<@una_post_tags postId=5>
    ...
</@una_post_tags>

其中,postId为当前要获取tag的文章ID,如不设置该值,将返回null。

9. Tag列表标签:una_tags

该标签用于获取文章所有的tag,格式如下:

<@una_tags>
    ...
</@una_tags>

10. 友链列表标签:una_links

该标签用于获取系统的友情链接数据,格式如下:

<@una_links>
...
</@una_links>