# 总览
本页面将会介绍用于主题的Collection。
[TOC]
# Pages
## 说明
该类主要获取独立页面列表,并实现枚举。
该类继承了 [DataContainer](1872716),并且使用了 [Dynamic](1884553#Dynamic\_0)。
## 数据方法
### id
获取当前(行)页面的id。
### link
获取当前(行)页面的链接。
### title
获取当前(行)页面的标题。
# Categories
## 说明
该类主要获取分类列表,并实现枚举。
该类继承了 [DataContainer](1872716)。
## 构造方法
可传入数据,必须为数组。
## 方法
### link
回显分类的链接。
### name
回显分类名称。
# Comments
## 说明
该类主要获取文章评论,并实现枚举。
该类涉及到递归,因此处理数据时需要小心,否则导致陷入死循环。
该类继承了 [DataContainer](1872716),并且使用了 [Dynamic](1884553#Dynamic\_0)。
## 构造方法
需要传入文章/独立页面模型。
## 方法
### pageNav
显示评论分页。有两个可选参数,第一个参数是上一页的文字;第二个参数是下一页的文字。
### listComments
列出评论。这里有一个hook:list_comments。
支持传入一个参数:$singleCommentOptions。参数的内容:
~~~
$defaultOptions = [
'before' => '<ol class="comment-list">',
'after' => '</ol>',
'beforeAuthor' => '',
'afterAuthor' => '',
'beforeDate' => '',
'afterDate' => '',
'replyWord' => '回复',
'commentStatus' => '您的评论正等待审核!',
'avatarSize' => 32,
'defaultAvatar' => NULL
];
~~~
### getChildrenByParentId
读取数据库中评论的回复。
### getChildren
获取当前评论回复。
### hasChildren
判断当前评论是否有回复。
### threadedCommentsCallback
评论回调函数。实际上是一个输出当前(行)评论的方法,并且递归输出子评论(回复)。
支持传入一个参数,就是 $singleCommentOptions 。详情请看 [listComments](#listComments)。
该方法会优先执行 threadedComments 函数来代替原来的功能,可以在主题的 functions.php 进行定义并实现。具体实现的内容,请参考该方法。
### threadedComments
递归输出评论。实际上是一个处理子评论(回复)输出的方法,在 threadedCommentsCallback 中被调用。
### alt
根据规则选择参数输出。作用主要是选择样式类。参数一般为两个或两个以上。
### levelsAlt
根据深度余数输出。同上。
### author
显示评论作者。
### gravatar
调用gravatar输出用户头像。该方法调用了hook:avatar。
参数1为头像尺寸,参数2为默认头像,参数2系统默认仅支持:mm identicon monsterid wavatar retro。
### reply
评论回复链接。实际上是一个调用 TarBlogComment.reply 评论JS的链接。该方法调用了hook:reply。
参数为显示链接的文字,默认显示”回复“。
### cancelReply
取消评论回复链接。实际上是一个调用 TarBlogComment.cancelReply 评论JS的链接。该方法调用了hook:cancelReply。
参数为显示链接的文字,默认显示”取消回复“。
### status
判断评论当前状态。参数为想要比较的状态字符串。
### isAuthor
判断是否为评论作者。判断标准是,作者id与当前登录id相同,或者是当前使用的昵称和邮箱与该评论的昵称和邮箱相同。
## 数据方法
### permalink
获取某个评论的锚点。
### theId
获取评论元素id,根据评论id生成。
### id
获取评论id。
### date
获取评论日期,实际上带有时间。
### content
获取评论内容。