VN:F [1.9.22_1171]
Rating: 0 (from 0 votes)
VN:F [1.9.22_1171]
Rating: 0.0/5 (0 votes cast)

WP Kit CN中文工具箱扩展版

侧边栏挂件集合,如最近评论,热评文章等等共6个挂件供选用,为主题开发者提供9个模版函数,接口简单稳定,此外增加了文章自动摘要,对中文兼容良好。从【中文WordPress工具箱】改进而来,在原有插件功能基础上,规范统一了模版函数接口,提供了侧边栏挂件。

中文WordPress工具箱——这是一个享有盛名的插件,一直以来就是中文WordPress博客必不可少的插件之一,地址在这里(http://yan.me/dia/wordpress/kit/)。

如果你在使用WordPress 随机文章和 WordPress 评论插件,务必先停用这两个插件。(建议,没经本站测试,同样功能的插件用两个,一般没有必要。)

原插件从很大程度上扩展了WordPress的能力,所以备受欢迎,但是,又由于对其的合理运用需要一定的技术门槛,而备受诟病,一时间,互联网上修改,扩展原插件的案例不断,很多模板作者拿到插件后,也都经过了自己的手动优化。

我或许可以让这款插件更加地平易近人。

这款插件的目标就是:让不懂PHP,不懂HTML的您,可以使用几乎全部的功能!

功能描述

  1. 最新评论输出
  2. 最新文章输出
  3. N天内留言最多用户输出
  4. 本周或本月内留言最多用户输出
  5. 随机文章输出
  6. 评论最多的文章输出
  7. 最近回响输出
  8. 自动摘要算法,更加适合中文使用

 

特性描述

  • 丰富的Widget支持,几乎每个功能,都有对应的边栏Widget,轻松调用
  • 标准模板标签,为主题作者准备,标准的WordPress模板标签调用方式
  • 后台管理面板,支持参数设定

WP Kit CN 文档

English Version

目录

Widget设定参考

热评文章Widget


热评文章Widget设定界面截图
标题 此Widget在页面侧栏显示的标题
文章数量 热评文章列表中包含的文章数量
几天之内 这是一个为了防止热评文章聚焦效应(人们倾向于查看热评文章,使得热评文章越来越热,永远占据着列表首位)的设计,通过这个参数,可以给进入列表的文章加上时间限制,如15天内发表的热评文章列表,可以通过指定-1来禁用此项功能
条目之前标记 一般来说,标题列表使用的HTML标记为<li>,你可以自己给li标签添加id或者class属性,或者干脆不用li标签,默认情况下,会使用li标签,此外,还有一个小小的加号,这个加号继承自中文工具箱的原版,算是原版本的一个小小印记:)
条目之后标记 如果使用li标签,则必须封口
显示的文章类型 此项可以设定页面是否也进入热评文章列表
是否显示评论数量 设定是否显示评论数量,目前其样式无法自定义,显示格式如:(15)

最近评论Widget

标题 此Widget在页面侧栏显示的标题
评论数量 显示的评论的条数
条目之前标记 一般来说,标题列表使用的HTML标记为<li>,你可以自己给li标签添加id或者class属性,或者干脆不用li标签,默认情况下,会使用li标签,此外,还有一个小小的加号,这个加号继承自中文工具箱的原版,算是原版本的一个小小印记:)
条目之后标记 如果使用li标签,则必须封口
评论内容长度 截断评论显示的字数
排除用户 不希望某位用户的评论显示在最近评论列表里,可以指定多位,使用半角逗号分隔
Gravatar头像尺寸 如果要在最近评论列表里显示头像,在这里设定尺寸
评论自定义格式 设置评论列表显示的格式,这里可以使用xformat格式,支持的变量如下: 

  • %post_title%—文章的标题
  • %comment_count%—该篇文章的评论数量
  • %comment_auhtor%—评论作者
  • %comment_auhtor_url%—评论作者的网站
  • %permalink%—该条评论的永久链接
  • %comment_excerpt%—评论摘要
  • %gravatar%—头像

上面的图是对最新评论Widget的设定说明,最底下的那个参数,在我的文章《WP Kit CN再次更新》里还有个例子。

  1.  %gravatar%<a class=”commentor”href=”%comment_author_url%” >%comment_author%</a>: <aclass=”comment_content” href=”%permalink%” title=”View the entire comment by %comment_author%”>%comment_excerpt%</a>

模板标签参考

此节,将提供一个模板标签的调用参考手册。WP Kit CN的模板标签采用了统一的风格,都是wkc开头的函数,参数采用字符串给出。

  1. wkc_recent_comments
  2. wkc_recent_pings
  3. wkc_recent_posts
  4. wkc_most_commented_posts
  5. wkc_random_posts
  6. wkc_most_active_commentors
  7. wkc_recent_commentors

 

wkc_recent_comments

此函数显示最新评论的列表。接受参数为:

  • number——显示最新评论的条数,默认5条。
  • before——列表表项前使用的代码,默认<li>。
  • after——列表表项后面使用的代码,默认</li>。
  • showpass——是否显示密码保护文章的评论,默认0(不显示)。1为显示
  • length——评论截断的字数,默认50。
  • skipuser——不显示某个用户的评论,默认为admin。留空显示所有评论。
  • echo——是否直接打印,默认为1(打印)。选0,则直接返回数据库查询结果,是一个数组。

 

使用范例:

<?php //显示10条评论,每条显示30个字,不显示Charles的评论 ?>
<?phpwkc_recent_comments(‘number=10&length=30&skipuser=Charles’); ?>

 

wkc_recent_pings

此函数显示最新回响的列表。接受参数为:

  • number——显示最新评论的条数,默认5条。
  • before——列表表项前使用的代码,默认<li>。
  • after——列表表项后面使用的代码,默认</li>。
  • showpass——是否显示密码保护文章的评论,默认0(不显示)。1为显示
  • length——评论截断的字数,默认50。
  • type——回响的类型,默认为both,可选pingback或trackback。
  • nopings——如果回响不存在显示的文字,默认为No Pings。
  • echo——是否直接打印,默认为1(打印)。选0,则直接返回数据库查询结果,是一个数组。

 

使用范例:

<?php //显示10条trackbacks ?>
<?php wkc_recent_pings(‘number=10&type=trackback’); ?>

 

wkc_recent_posts

此函数显示最新文章的列表。接受参数为:

  • number——显示最新文章的条数,默认5条。
  • before——列表表项前使用的代码,默认<li>。
  • after——列表表项后面使用的代码,默认</li>。
  • showpass——是否显示密码保护文章的评论,默认0(不显示)。1为显示
  • skip——跳过前面多少篇,默认0
  • echo——是否直接打印,默认为1(打印)。选0,则直接返回数据库查询结果,是一个数组。

 

使用范例:

<?php //显示10条最新文章,不包括已经显示的在首页的5篇文章 ?>
<?php wkc_recent_posts(‘number=10&skip=5’); ?>

 

wkc_most_commented_posts

此函数显示评论最多文章的列表。接受参数为:

  • number——显示最新文章的条数,默认5条。
  • days——几天之内的热评文章,默认7天
  • before——列表表项前使用的代码,默认+。
  • after——列表表项后面使用的代码,默认<br />。
  • posttype——显示的文章的类型post(日志)还是page(页面)还是both,默认post。
  • showcount——是否在文章标题后面显示评论数量。默认值1,表示显示,可选值0,表示不显示。
  • echo——是否直接打印,默认为1(打印)。选0,则直接返回数据库查询结果,是一个数组。

 

使用范例:

<?php //显示10条15天内评论最多的文章 ?>
<?php wkc_most_commented_posts(‘number=10&days=15’); ?>

 

wkc_random_posts

此函数显示随机文章的列表。接受参数为:

  • number——显示最新文章的条数,默认5条。
  • length——自动文章摘要的长度,默认400字
  • before——列表表项前使用的代码,默认<li>。
  • after——列表表项后面使用的代码,默认</li>。
  • showpass——是否显示密码保护的文章名称,默认0,不显示,1表示显示。
  • showexcerpt——是否在链接title属性中显示摘要,默认1,0表示直接显示文章摘要,不在链接title中显示。
  • echo——是否直接打印,默认为1(打印)。选0,则直接返回数据库查询结果,是一个数组。

 

使用范例:

<?php //显示10条随机文章 ?>
<?php wkc_random_posts(‘number=10&length=250’); ?>

 

wkc_most_active_commentors

此函数显示活跃用户的列表。接受参数为:

  • threshhold——上榜用户最少评论数,默认5。
  • days——时间期限,默认7天内。
  • skipuser——被排除的用户名,默认admin。改参数用于屏蔽作者自己的显示。
  • before——列表项之前显示的html标签,默认值为<li class=”wkc_most_active”>
  • after——列表项之后显示的html标签,默认值为</li>
  • echo——是否直接打印,默认为1(打印)。选0,则直接返回数据库查询结果,是一个数组。

 

使用范例:

<?php //显示15天内评论超过10条用户 ?>
<?php wkc_most_active_commentors(‘threshhold=10&days=15’); ?>

 

wkc_recent_commentors

此函数显示最近留言用户的列表。接受参数为:

  • threshhold——上榜用户最少评论数,默认-1,表示没有限制。
  • type——本周内或者本月内,默认week,可选值为month。
  • skipuser——被排除的用户名,默认admin。改参数用于屏蔽作者自己的显示。
  • before——列表项之前显示的html标签,默认值为<li class=”wkc_recent_commentors”>
  • after——列表项之后显示的html标签,默认值为</li>
  • echo——是否直接打印,默认为1(打印)。选0,则直接返回数据库查询结果,是一个数组。

 

使用范例:

标签:

发表评论

电子邮件地址不会被公开。 必填项已用*标注