ThinkSSL🔒 一键申购 5分钟快速签发 30天无理由退款 购买更放心 广告
# 总览 本页面将会介绍用于主题的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 获取评论内容。