目录
Widget设定参考
热评文章Widget
|
| 热评文章Widget设定界面截图 |
| 标题 | 此Widget在页面侧栏显示的标题 |
| 文章数量 | 热评文章列表中包含的文章数量 |
| 几天之内 | 这是一个为了防止热评文章聚焦效应（人们倾向于查看热评文章，使得热评文章越来越热，永远占据着列表首位）的设计，通过这个参数，可以给进入列表的文章加上时间限制，如15天内发表的热评文章列表，可以通过指定-1来禁用此项功能 |
| 条目之前标记 | 一般来说，标题列表使用的HTML标记为<li>，你可以自己给li标签添加id或者class属性，或者干脆不用li标签，默认情况下，会使用li标签，此外，还有一个小小的加号，这个加号继承自中文工具箱的原版，算是原版本的一个小小印记：） |
| 条目之后标记 | 如果使用li标签，则必须封口 |
| 显示的文章类型 | 此项可以设定页面是否也进入热评文章列表 |
| 是否显示评论数量 | 设定是否显示评论数量，目前其样式无法自定义，显示格式如：（15） |
最近评论Widget
 |
| From illustration |
| 标题 | 此Widget在页面侧栏显示的标题 |
| 评论数量 | 显示的评论的条数 |
| 条目之前标记 | 一般来说，标题列表使用的HTML标记为<li>，你可以自己给li标签添加id或者class属性，或者干脆不用li标签，默认情况下，会使用li标签，此外，还有一个小小的加号，这个加号继承自中文工具箱的原版，算是原版本的一个小小印记：） |
| 条目之后标记 | 如果使用li标签，则必须封口 |
| 评论内容长度 | 截断评论显示的字数 |
| 排除用户 | 不希望某位用户的评论显示在最近评论列表里，可以指定多位，使用半角逗号分隔 |
| Gravatar头像尺寸 | 如果要在最近评论列表里显示头像，在这里设定尺寸 |
| 评论自定义格式 | 设置评论列表显示的格式，这里可以使用xformat格式，支持的变量如下：
上面的图是对最新评论Widget的设定说明，最底下的那个参数，在我的文章《WP Kit CN再次更新》里还有个例子。
|
模板标签参考
此节，将提供一个模板标签的调用参考手册。WP Kit CN的模板标签采用了统一的风格，都是wkc开头的函数，参数采用字符串给出。
- wkc_recent_comments
- wkc_recent_pings
- wkc_recent_posts
- wkc_most_commented_posts
- wkc_random_posts
- wkc_most_active_commentors
- 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的评论 ?>
<?php wkc_recent_comments('number=10&length=30&skipuser=Charles'); ?>
<?php wkc_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'); ?>
<?php wkc_recent_pings('number=10&type=trackback'); ?>
wkc_recent_posts
此函数显示最新文章的列表。接受参数为：
number——显示最新文章的条数，默认5条。before——列表表项前使用的代码，默认<li>。after——列表表项后面使用的代码，默认</li>。showpass——是否显示密码保护文章的评论，默认0（不显示）。1为显示skip——跳过前面多少篇，默认0echo——是否直接打印，默认为1（打印）。选0，则直接返回数据库查询结果，是一个数组。
使用范例：
<?php //显示10条最新文章，不包括已经显示的在首页的5篇文章 ?>
<?php wkc_recent_posts('number=10&skip=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'); ?>
<?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'); ?>
<?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'); ?>
<?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，则直接返回数据库查询结果，是一个数组。
使用范例：
<?php //显示本月活跃用户 ?>
<?php wkc_recent_commentors('type=month&skipuser=Charles'); ?>
<?php wkc_recent_commentors('type=month&skipuser=Charles'); ?>
与作者取得联系
如果上面的帮助有不详细的，或者插件有bug，请联系我：
[...] http://sexywp.com/wp-kit-cn-doc [...]
[...] http://sexywp.com/wp-kit-cn-doc [...]
你好，请问下，你添加的模版标签是wkc_recent_comments这个类型的，但是我看了代码里，并没有这个函数的声明定义啊，代码里只有个get_recent_comments，这是怎么回事呢？呵呵，我是小白，不会PHP，麻烦你说一下好吗？
[...] 官方下载（这里），具体使用说明请看：《WP Kit CN 文档》 [...]
选模板调用函数和加最近评论Widget两者之间，选前者不能屏蔽掉发布者链接，选后者不能排除博主的回复评论，呵呵！
有办法解决吗？Charles
Widget是完全建立在模板标签的基础上的，所以说直接手动调用模板标签，也就是你说的“模板调用函数”，只可能获得更多的功能，不可能缺少任何功能。Widget的本质，就是“我帮你调用函数”。
你在调用函数的时候，试一下这个：
$args = array(
"xformat" => "%author%:%content%",
"skips" => "独木"
);
wkc_recent_comments($args);
上面代码只是个形式，具体写法，你要参照源代码里面的写法。
我懒得打开看具体是怎么写的了。
非常感谢charles，我去试试
请问查尔斯，如何让Recent Comments里的用户名和评论文字用不同的颜色显示呢？我的siderbar挂上了Recent Comments、Random Posts、Most Commented，不过感觉好乱，查尔斯能不能看一下，然后给点建议，谢谢！
你看到上面的插图里面，有个地方可以设定自定义链接格式的吧？在那里，你可以调整链接的格式，当然使用仅使用CSS也是可以改变颜色的。
是的，那个我看到了，是不是利用标记进行设置？我对代码不了解，也不清楚如何用CSS做到，能不能给一个这方面的点拨，可以让我Google一下？
这个……那你只好google “CSS入门”这个关键字了……
好的，谢谢 ^ ^
我在自定义格式里边写了 %post_title%
可是无法显示标题，前台页面还是显示 %post_title%
谢谢提供线索，我会尽快调查，这里可能有bug。再次感谢~~
我已经尝试修复了这个问题，请于20分钟后重新下载8.10.29版本，现在不便升级，给您带来不便，请谅解~~
[...] WordPress新版中文工具箱WP-Kit-CN。可能太久没有关注中文工具箱，出了新版都不知道。要不是这次换了主题，突然发现热评日志——就是评论最多文章那里出了问题。要不是这个原因我还不会找到这个新版的WP Kit CN。 [...]
对我这种代码菜鸟来说这样看起来方便多了
呵呵，能有帮助就好了~~
报告一个问题，为什么我用
列表里每个文章名前面多了一个“+”。不知道代表什么意思？
wp-kit-cn.tags.php第116行我去掉就好了=。=
还在widget-random-posts.php第62行跟widget-most-commented-posts.php第64行发现这个神秘的加号……
请看本页第一副插图的第四个空格。这个加号是从原来的中文工具箱中继承过来的，只是放在列表项前面的一个小小装饰而已。这个东西可以通过参数修改掉，或者在Widget管理界面删掉。不需要修改源代码。否则，你一升级，又会跑出来。:-D
我用代码弄得，没使Widget……
使用代码调用方式，应该采用参数设置，而不是修改源代码。
=。=那是不是要添加before跟after
[...] http://www.charlestang.cn/wp-kit-cn-doc [...]
[...] 相关使用说明请查看作者文档图解教程：http://www.charlestang.cn/wp-kit-cn-doc 个人感觉 Charles 做得已经相当人性化了，当然这款插件也适时名为：wp kit cn [...]
[...] http://www.charlestang.cn/wp-kit-cn-doc [...]
[...] http://www.charlestang.cn/wp-kit-cn-doc Popularity: 1% [?] [...]
[...] | 说明文档 Tags：Wordpress|插件, [...]