Becomin' Charles

让WordPress 2.6正确统计中文字数

Charles — Fri, 25 Jul 2008 23:12:41 +0800

从WordPress 2.6版本开始，后台撰写日志的界面带有了字数统计功能。不过呢，我发现，这个字数统计功能，计算出来的数字非常的不靠谱。

打开代码看了看，原理不是很复杂，就自己动手给改了。效果如下：

我将这个小小的修正写成了插件，明白原理的同学，直接看代码决定怎么处置，不明白的同学，下载我写的插件，启用即可。

不多说什么了，如果有需要，我可以在系列文章里面介绍。

中文字数统计插件

功能：正确统计中文字数，连带统计英文单词数（注意不是字母数）

用法：下载——解压——上传到插件目录——启用——OK

下载链接：

http://www.charlestang.cn/downdown/chinese-wordcount.zip

P.S. 好像还是有误差的，但是比较靠谱了，如本文267字，有兴趣数数^_^？

收藏、分享这篇文章!

标签：plugins, WordPress

WordPress插件开发实例--（01）

Charles — Fri, 25 Jul 2008 12:47:10 +0800

很多朋友来我这里，可能真的会很失望了，因为——看不懂！囧。相信我，我如果写每个人能看懂的东西，那真的是很难看的，你们看我侧栏上的热门文章列表，还是以技术文章居多，就说明了一个问题，我写技术文章还对很少数的人能有所助益，我如果写大众化的文章，那就是完全的废物了。

所以，我宁愿读者少一点，也不愿做个没用的人。

现在，技术书籍的市场上，蔓延着一种浮躁的风气，经典的书不多，大都是些媚俗的技术书籍，《XXXX实例教程》就是一大类，说到这里，你就发现了，我在技术文章领域是媚俗的。这类书籍永远不会放在书架上长久保存，看过就扔，看过的人马上会意识到，这是没有价值的书。但是，这类书，还是可以让入门级选手有个感性认识的。考虑到博客文章本身的特点，比如时效性，片面性，博客还是比较适合发表这类文章的。

经典文章由大师来写，这种看过就算的文章，就由我来写吧。

此系列文章，又是一个漫漫长征路，因为，我的计划又是很宏伟壮阔的，这也符合我的性格——虎头蛇尾。关注这个系列的文章，你将会看到许多插件的运行原理，一部分插件的编写过程，构思过程，实际编码过程，调试过程，发布过程等等。我的理想是很伟大的——看过此系列，插件开发不再神秘，人人皆可动手。

Add Bottem Info

在文章中加入版权信息，可以保护自己的版权。当然，这个东西不光是加入版权信息，还可以加入各类讯息，只要你往里写就行。添加这一类的信息，有多种办法，最傻的，每篇文章写一个，很汗。然后是稍微好点的，写在模板里面，single.php，但是呢，换模板就不行了，又要重来，而且不懂HTML，PHP是比较困难的。最后，就是用插件，不但可以一劳永逸，而且，还可以给别人分享，以上呢，就是插件的成因了。

WordPress是一个事件触发的系统，我们写插件基本上依赖的也是WordPress内部的事件来触发我们自定义的动作。

WordPress事件，能够触发两种动作，一种，就叫动作（Action），就是说某件事情发生了，能诱发一个动作，些插件的时候，你就可以在这个动作发生的时候，做一些自定义的事情。

另一种呢，叫做过滤器（Filter），就是说某件事情发生的时候，诱发一个动作的同时，把相关的数据都传送过来，允许你对数据进行过滤，变更等。

看过源代码的都知道，这两者的实现机制其实是一模一样的，具体运行的代码都是同一段代码，所以说，WordPress插件一般选用两种中的一种来进行开发，但是并非非得用其中一种，就不能用另一种实现。其选择原则，一半就是方便，符合逻辑，好理解，易管理。

然后来看看这个插件的本质是什么，就是在显示文章信息的时候，后面附加一段文字。自然而然的，我们想到了过滤器，将文章读入，然后附加一段文字，再把修改后的东西输出。（当然，你硬是要用Action来做这个事情也没什么不可以，这个就当成读者自己思考的题目吧，用Action怎么做这个事情呢？）

好了，既然知道了是要用一个能过滤文章内容的Filter，那么我们就去把它找出来吧。到哪里找呢？

http://codex.wordpress.org/Plugin_API/Filter_Reference

没错，正是官方文档。这不是最好的找寻之处，最好的在源代码里。但是这是最方便的。足够用来开发插件了。

我们知道了要用的这个过滤器叫做the_content。

然后，我们就要动手开发了。（有些东西不想重复说了，就是一些ABC，可以看看插件开发API，那是我翻译的文档。）

首先，准备好要插入的文字，可以先用个普通网页把东西调试好，然后，写成字符串的模样。

<?php
   $bottem_string = '<div class="bottominfo">';
   $bottem_string .= '<p>作者：<a href="' . get_the_author_url() . '">' . get_the_author() . '</a></p>';
   $bottem_string .= '<p>原文链接：<a href="' . get_permalink(get_the_ID()) . '">' . get_the_title() . '</a></p>';
   $bottem_string .= '<p><a href="' . get_bloginfo('siteurl') . '">《' . get_bloginfo('name') . '》</a>版权所有，转载时必须以链接形式注明作者和原始出处及本声明。</p>';
   $bottem_string .= '</div>';
?>

就像上面的样子。

然后，我们来写一个函数，把这些东西放进去。

<?php
function add_info($content = ''){
//在这里放上上面的那些串，然后进行连接操作
}
?>

函数内部的东西，我就不赘述了，要做的就是将上面的串，连接到content后面。

最后，就是将这个过滤器，跟the_content这个Filter挂钩（Hook）。

<?php
add_filter('the_content','add_info',1,1000);
?>

到此，一个插件，就算完成了，你看到这里，完全可以自己动手试试看的。

当然，一个插件的完成，还需要考虑一些因素的，以后再找机会说吧，感兴趣，你可以从代码里看。

插件下载

http://www.charlestang.cn/downdown/add-bottom-info.rar

收藏、分享这篇文章!

标签：develop, plugins, WordPress

WordPress到底在整啥？—(09)

Charles — Thu, 24 Jul 2008 10:48:45 +0800

依旧续上一篇，仍然是函数参考

maybe_unserialize( $original )
mysql2date( $dateformatstring, $mysqlstring, $translate = true )
nocache_headers()
number_format_i18n( $number, $decimals = null )
path_is_absolute( $path )
path_join( $base, $path )
remove_query_arg( $key, $query=FALSE )
require_wp_db()
size_format( $bytes, $decimals = null )
smilies_init()
status_header( $header )
update_option( $option_name, $newvalue )
wp( $query_vars = '' )
wp_check_filetype( $filename, $mimes = null )
wp_die( $message, $title = '' )
wp_explain_nonce( $action )
wp_ext2type( $ext )
wp_get_http( $url, $file_path = false, $red = 1 )
wp_get_http_headers( $url, $red = 1 )
wp_get_original_referer()

maybe_unserialize

反串行化。

mysql2date

这个函数还是很有用的，可以根据指定的格式来翻译日期字符串，php自己倒是也有日期翻译的函数，这个函数不过是在外面包裹了一层，实现了对于不同语言的日期字符串翻译。

nocache_headers

这个函数发送了一个不让浏览器缓存的header。这里很好玩，我看到了一句注释：
why are these @-silenced when other header calls aren't?
这也是我想问的，呵呵。

number_format_i18n

返回一个格式化的数字串。

path_is_absolute

判断一个路径是否是绝对路径。

path_join

连接两个路径，处理好了中间斜杠的数量。原来php有这种可以trim任意字符的函数啊。

remove_query_arg

从一个querystring中移除一个或者数个键值对。

require_wp_db

这个函数在会在WP中引入DB类对象，这里我们其实可以看出，WP还是给其他类型的数据库留了接口的，你完全可以自己实现一个dp.php然后放杂wp-content目录下面，不过现在到底有没有使用别的数据库系统的wp呢？

size_format

humen readable filesize generate。

smilies_init

这个函数很有意思的，有一个全局变量叫做$wpsmiliestrans，这个变量里面存储了wp里面默认表情的符号，和图片的对应关系，其实，一直以来，我都觉得这个东西很有问题，这套默认的表情系统与汉字这样的多字节语言的结合不是很好。我在给别人留言的时候，那个表情符号起始的冒号前面必须有一个空格，如果没有，表情图片就不能正确翻译，这真的是让我很困扰，难道就不能换成别的字符码？其实看了sohu（用的shortcode样式），新浪（用的是斜杠），他们的表情翻译系统都工作良好，wp不能在这里有所改进么？

status_header

此函数和get_status_header_desc是一对，向浏览器发送一个带有HTTP状态的header。

update_option

又是一个option系列函数中的一员。

这个函数，本质上就是WP的主函数，这个函数会在wp-blog-header.php中被调用，此函数内部，也调用了WP的main函数，这也放到以后去看吧。当此函数返回的时候，所有的一切就已经准备好了，也就到了装载模板的时候了。

wp_check_filetype

该函数接受参数为一个文件名，返回的是一个数组，该数组包括两个字符串，一个是扩展名，一个是相对应的MIME类型串。估计是在处理附件的时候使用的函数。

wp_die

这个函数也比较眼熟，前面也遇到过了，调用这个函数，可以显示一个能展示wp出错信息的页面，并且是wp中止运行。

wp_explain_nonce

这个函数很搞笑，是一大堆操作失败的提示，暂时还不知道是用在哪里的。

wp_ext2type

从扩展名判断文件类型的函数。

wp_get_http

哇哈哈，又见递归函数啊，此函数从一个给定的url获取文件，然后将取到的文件写入到参数中指定的文件里面。如果参数中不给出可写的文件，那么该函数会发送一个HTTP HEAD。如果访问的url被重定向，如301或302，那么就递归地重复过程。

wp_get_http_headers

就是上面一个函数，只不过省掉了文件名这个参数。

wp_get_original_referer

这个函数没有看得很明白，估计以后还会遇到吧。嘿嘿

===============
今天就到这里了~

收藏、分享这篇文章!

标签：code reading, WordPress

WordPress到底在整啥？—(08)

Charles — Mon, 14 Jul 2008 12:34:04 +0800

续上一篇，继续函数参考

do_enclose( $content, $post_ID )
do_feed()
do_feed_atom( $for_comments )
do_feed_rdf()
do_feed_rss()
do_feed_rss2( $for_comments )
do_robots()
form_option( $option )
get_alloptions()
get_num_queries()
get_option( $setting )
get_status_header_desc( $code )
get_weekstartend( $mysqlstring, $start_of_week = '' )
is_blog_installed()
is_lighttpd_before_150()
is_new_day()
is_serialized( $data )
is_serialized_string( $data )
make_url_footnote( $content )
maybe_serialize( $data )

do_enclose

很老实地说，目前还没有看懂这个函数呢！！

do_feed

嘿嘿，这个函数真的是非常好玩啊，让我终于找到了以前一直想做但是没有做成的一个功能的方法。这个函数包括下面4个do_feed_xxx函数，是一组，就写这么一段吧。这个函数，揭示了wp输出feed的方法，首先，从query string中提取出关于feed的那个变量，然后，用此变量生成一个hook，检查这个hook是否存在，如果不存在，则wp_die，如果存在，则触发action。

我举个例子吧，比如要访问我的feed：

http://www.charlestang.cn/?feed=rss2

然后，do_feed被调用，然后wp得到了需要的类型“rss2”。

接着，生成一个hook名称叫做“do_feed_rss2”，然后检查这个hook是否存在（当然存在了！就在下面）。

然后，触发action do_feed_rss2。（这个action是在default-filters.php里面添加的）

do_feed_atom

do_feed_rdf

do_feed_rss

do_feed_rss2

do_robots

这个函数呢，我在这里大胆猜测一下它的功能吧，记得安装WP的时候，让大家选择是否允许google，百度等搜索引擎索引你的博客，这个“允许”，或者“不允许”，就是使用robots.txt这个东西来实现的，具体的使用方法，可以参看http://www.robotstxt.org/，其实，使用wp博客，设定比较合理的robots.txt也是比较重要的，也是seo的一个方面。至于如何设定，其实有个捷径，就是找到你心目中的牛博，直接抄它的robots.txt就OK啦，嘿嘿，够坏吧。

form_option

没看明白这个是干啥的，只有一行，信息太少了。以后再说。

get_alloptions

取得所有的option。这个应该归入option系列函数的一类，以后专门分析吧。

get_num_queries

用在模板里面，用来显示一种执行了多少次query的一个函数，直接打印出来。不过呢，这个query数量一定是要使用wpdb对象执行的才行哦~~

get_option

option系列函数。

get_status_header_desc

这个函数里面提供了一个http状态编号对应的含义的列表，可以用来查询http状态。后面有一个status_header函数会调用这个函数，差不多是整个wp仅有地调用这个函数的函数。用来查询状态文字，然后作为header发送给agent。

get_weekstartend

又是一个只用到一次的函数，在wp-get_archives里面调用的。

is_blog_installed

通过在数据库里面查询来判断是否安装。

is_lighttpd_before_150

对服务器版本的判定

is_new_day

超简单的一个函数，不过没看出是干啥用的。

is_serialized

判断一个变量的内容是否已经串行化，很多正则，没有看懂。

is_serialized_string

同上。

make_url_footnote

这个函数可是很好玩的哦，可以把文章中所有的超链接都转变成脚注。目前只有the_content_rss里面调用过这个函数，不过，据我所见的，还没有人通过参数启用这个功能。奇怪的东西真多，这里面有个抽取链接的正则表达式，倒是可以摘抄一下，不错。
'/<a(.+?)href=\"(.+?)\"(.*?)>(.+?)<\/a>/'

maybe_serialize

这个是wp用到的串行化函数，如果本身是string，这个函数，就trim一下，如果本身是数组或者对象，这个函数调用serialize方法，最奇怪的是，如果参数本身已经是经过串行化的，还是会调用一次serialize方法，这个就非我所能懂了，记录一下吧。

收藏、分享这篇文章!

标签：code reading, WordPress

WordPress到底在整啥？—(07)

Charles — Wed, 09 Jul 2008 11:17:29 +0800

好吧，还是来到这里了，这回还是支线情节，但是由于其趣味性和实用性，我还是想写写……

百宝箱functions.php

这个文件确实是一个百宝箱，里面什么都有，我打算分个几次把这里的函数都给罗列一遍，以后就当成我自己的函数参考好了。呵呵……

_config_wp_home( $url = '' )
_config_wp_siteurl( $url = '' )
_deprecated_file($file, $version, $replacement=null)
_deprecated_function($function, $version, $replacement=null)
_mce_set_direction( $input )
absint( $maybeint )
add_magic_quotes( $array )
add_option( $name, $value = '', $deprecated = '', $autoload = 'yes' )
add_query_arg()
apache_mod_loaded($mod, $default = false)
bool_from_yn( $yn )
build_query( $data )
cache_javascript_headers()
current_time( $type, $gmt = 0 )
date_i18n( $dateformatstring, $unixtimestamp )
dead_db()
debug_fclose( $fp )
debug_fopen( $filename, $mode )
debug_fwrite( $fp, $string )
delete_option( $name )

_config_wp_home

这个函数真是让我相当匪夷所思的，为啥？因为这个函数根本没用！唯一使用到的地方就是有一个filter，叫做option_home，而这个filter却从来也没有apply过。很无语……或许是WPMU用的函数？

_config_wp_siteurl

这个函数同上一个函数，也没用，绑定到了option_siteurl这个filter上，但是从来也没有调用过……

_deprecated_file

告知一个文件已经不建议使用，并且告知使用哪个文件来替代。

_deprecated_function

告知一个函数已经不建议使用，并且告知使用哪个函数来替代。检索这个关键字，可以看到所有过期的函数。

_mce_set_direction

这是一个filter（tiny_mce_before_init），其作用是在MCE（也就是撰写文章时候的那个编辑器）初始化之前，更改mce的方向，有些国家的人写在是从右往左写的哦~~~

absint

绝对值。

add_magic_quotes

哈哈^_^，递归！！这个函数本质上就是对数组中的每一个值，运行一次addslashes，说起来PHP的数组，确实是一种树状结构的，只是这个叶子数是很随意的。从这个函数中，可以学习学习遍历数组的递归方法呢~~呵呵

add_option

哎呀，按照字母序看来也是有很大的弊端的，比如这个函数，就是options相关函数群中的一个，怎么办呢？这个问题先放一放吧。唉……

add_query_arg

这个函数的功能是在一个已经有的uri里面增加一个key value对，形成新的uri。

apache_mod_loaded

这个函数有用，可以判断apache服务器是否有安装某个模块。其判断方法也不错，值得学习，一是通过apache_get_modules函数直接取得已经安装的mod的数组，如果该函数不可用，可以通过phpinofo(8)来获得一个字符串，判断是否在这个字符串中包含mod的名字，呵呵，长见识了。

bool_from_yn

把“y”和“n”变成bool值，也即true或false。

build_query

我前面介绍过compat.php这个文件，里面提到了WP自己修补了PHP5不存在的函数http_build_query 。其作用就是将一个数组转换成url的形式。这个函数没啥的，就是调用了这个函数，不过很值得怀疑的一点是，这里为什么调用的是它自己修补的那个版本呢？应该直接调用http_build_query这个函数的，因为已经经过compat.php的修补，一定不会有问题的。真是莫名啊……

cache_javascript_headers

这个东西也是相当的有用哦~调用这个函数，可以发送一个header，要求浏览器缓存一个js文件十天。我搜索了一下WP的所有文件，发现，没有一个地方调用过这个函数的，估计这个函数就是用来让插件或者主题的作者调用的。有些插件会通过PHP生成javascript文件，调用这个函数，可以让php生成的js缓存十天。

current_time

返回表示当前时间的字符串。

date_i18n

这个函数的作用呢，就是返回一个表示时间的字符串，而且这个字符串是符合WP设定的那种语言的语言习惯的。

dead_db

当建立数据库连接发生错误的时候，打印一个页面告知错误，并中止WP的继续运行。

debug_fclose

本质上就是fclose。这个函数包括后续的3个，正好就是一套函数，看代码来说，是在$debug这个全局变量的控制下，向文件写入调试信息的一个方法，只是不知道这个$debug是在何处开启的，还是直接在config里面手动设定一下就ok？

debug_fopen

打开文件。

debug_fwrite

向文件写入字符串。

delete_option

option系列函数，以后专门开一篇文章分析一下吧。

收藏、分享这篇文章!

标签：code reading, WordPress

WordPress到底在整啥？—(06)

Charles — Mon, 07 Jul 2008 14:59:30 +0800

上回把前面一对闲杂都说了一遍，今天开始一个个看吧^^

compat.php

具我猜测，compat这个词是compatibility的意思，没错，就是兼容。

做了点啥呢？主要是把新版本有的，而老版本没有的函数，都给实现了一遍。从源代码里面可以看出，WordPress最多兼容到>PHP4.3.0。这是前面看过的代码里面的，我希望我没记错。

这里补充的函数倒也不多，我就罗列一下好了：

http_build_query()
_()
stripos()
hash_hmac()
mb_strcut()

新版本的php手册里面，对这些函数都有解释的，我不想赘述了。我对这里的那第二个函数是非常好奇的，到底是干什么的？接受一个字符串参数，返回那个字符串，那就直接写一个字符串不就得了？我终究还是有点天真的，如果谁知道那个是干什么的，请告诉我，真是太奇怪了，搜索了全部源代码，好像只有class-pop3.php里面用到了。

另一个想唠两句的是最后一个函数，mb_strcut()，按理说，就是 multibyte string cut，也即多字节文字字符串剪切函数，不过从这个函数来看，只对utf8编码的字符串奏效，所以，wp推荐每个博客尽可能使用utf8编码。这个时候，我就想起了著名的中文工具箱，里面用了个utf8_trim，其实是否有可能用这个函数代替呢？还有就是yskin的CJK-excerpt，里面用了一个mb_strlen，是不是也可以用这个函数来代替？我只是一说，希望真正的高手看到这里，能给我指点一二吧。（我个人的感受是，utf8_trim的效果还不是很干净啊，最后还会有一个乱码，有时候是个小方块。也可能我没用对。）

本来今天想在往下写点的，但是我一看，后面两个都是重量级的，马上打了退堂鼓了。一个是WP的百宝箱，functions.php，另一个就是WP这个类的定义了，那个里面有WP这个程序的main函数哦~~~这个算是对后面内容的简短预报了吧，嘿嘿^^

收藏、分享这篇文章!

标签：code reading, WordPress

插件开发全攻略（目录）

Charles — Sun, 06 Jul 2008 11:33:58 +0800

隔了这么久，终于将这个系列文章都翻译完了，这么一遍走下来，实在觉得自己很浅薄，技术和语言水平都十分有限。恐怕也没有全部传达原作者的意图。

我打算陆续将该系列的文章校对一遍，并且打算将这个系列里面的例子改写成自己的例子，这样，我可以对文章有更准确的理解。

这里，我罗列一下这个系列文章的目录吧。英文名字就是原文，底下的中文名字就是译文。

原来的目录页面在：这里

还提供PDF版本的下载哦。

收藏、分享这篇文章!

标签：develop, plugins, translate, WordPress

插件开发全攻略（12）---发布并推广你的WordPress插件

Charles — Thu, 03 Jul 2008 12:10:26 +0800

在你完成了你了不起的WordPress插件后，在你发布和推广你的插件之前，还有一些事情需要考虑。

发布前

努力遵循标准

虽然遵循WordPress编码规范不是必须的，但是有些东西确实可以让你的生活变得简单。其中最有价值的一个建议是永远不要使用简写的PHP。原因呢？并非每个人都会将简写开启。

所以，不要这样写：

<? /*your php code*/ ?>

而要这样写：

<?php /*your php code*/ ?>

确保你已经完全测试了你的插件

找一些爱好者来测试你的插件。技术上来说，专门的测试人员是好的，但是你还是希望有一些普通的并不懂得编程语言的用户来测试。

找到所有的bug是不可能的，但是至少努力推出一个稳定的版本。

确保你有一个Readme文件

在你把插件向大众公开之前，确认一下你是否有一个Readme文件。这个文件应该包含最基本的安装流程介绍。对于一个要求严格的readme文件版本，请检查WordPress推荐Readme格式。甚至有一个绝妙的Readme文件验证器。

设立一个专门的WordPress插件页面

Ajay D'Souza曾经写过如何发布WordPress主题的建议。他的建议也可以在某种程度上用在插件之上。

确保你设立了一个专门的插件页面。在这个页面上，用户可以找到关于这个插件的任何东西。这个插件的页面至少要包含以下的东西：

对你的插件的一个简单描述
下载链接
特性列表
安装指南
版本历史
已知的bugs和冲突
截图或者demo
联系或者支持信息（或者允许评论

上述信息将帮助你提升你的插件，尤其是描述和特性部分。

有一个好的目录结构

我会力劝你总是把自己的插件放在一个目录里面，除了主要插件文件外的任何文件都应该放在子目录里面。确保你zip，gzip或者rar你的插件，使得人们可以非常简单的安装你的插件。

你的插件需要修改模板或者文件修改吗？

如果你的插件需要修改模板的设置或者文件，做好被bug报告和等待的帮助猛攻的准备。我认为，一个好的插件绝对不需要修改主题或者某个文件的。除非这个插件往WordPress内核中添加了模板标签。

如果你的插件确实需要模板修改或者文件修改，在你的下载页面包含一些详细的例子，并且尽可能在你的发布中包含一些demo。

推广你的插件

在你拥有了你专门的下载页面后，是时候发布你插件的信息使得人们来下载你的插件了。你花在你的插件描述和特性的撰写上的时间是非产关键的，因为这决定了人们会否采用你的插件。其他人链接到你的插件也非常重要。

在Weblog Tools Collection推广

一个推广你的插件的很好的地方是在Weblog Tools Collection。在他们的插件发布栏目，你可以将你的详细描述投递，推荐你的插件。

在WordPress插件数据库推广

WordPress插件数据库是另一个添加你的插件的好去处。添加你的插件的过程不是那么一帆风顺的，但是有详细的指导。

在WordPress官方插件库推广

WordPress自己提供了主机来存放你的插件。不过，在你被允许添加你的插件之前，你必须满足几个条件。记住，任何宣传都是好的宣传。

使用社会网络推广

将你的插件添加到delicious，digg，和Stumble Upon。让你的朋友来帮忙。如果你的插件足够好，推荐就会广为流传。

在你自己的博客上推广

如果你的插件是人们会注意到的，在你自己的博客上使用吧。人们会开始问，你使用的到底是什么插件。口口相传是非常有效的，尤其是在博客社区内。

结论

你可以拥有世界上最好的插件，但是如果没有正确的发布和推广，只有很少的人会下载它。一旦你开始你的推广过程，倾听特性需求和bug报告是非常重要的，尤其是你的插件非常年轻的时候。如果你的插件不起作用，或者太多的人使用的时候遇到问题，人们下载的时候就会非常担忧。所以，在早期修复那些bug和添加重要的特性是非常重要的。绝大多数这样的问题可以在测试的过程中解决，但是有些bug只有在官方发布后才能看到。

写在《插件开发全攻略》系列的结尾

感谢您阅读插件开发系列文章的最后一篇。希望这个系列能够让您受益，并且帮助你为撰写自己的插件建立基础。非常感谢您的阅读。

收藏、分享这篇文章!

标签：develop, plugins, translate, WordPress

WordPress到底在整啥？—(05)

Charles — Wed, 02 Jul 2008 12:54:05 +0800

我们已经开始了正式的WordPress之旅，接下去就是在Settings这条主线上，每每看到什么重要的景点，我们都会钻进去看个究竟的。开始吧。

首先是个内存大小的定义，WP_MEMORY_LIMIT，关于这个也没啥好说的，就知道这里定了个数字是32M，目前还没看出什么关键的来。

wp_unregister_GLOBALS()

这是wp-settings.php里面执行的第一个非php内建函数，其实，这个东西涉及到php语言的一个特性，不管了，先看看吧。

register_globals

这是php.ini中的一个指令，指定是否将EGPCS(Environment, GET, POST, Cookie, Server) 变量注册为全局变量。在高于4.2.0的php版本中，这个变量已经被默认设定为off了，从PHP6.0开始，这个变量将不推荐使用或者被移除。其实，最主要的问题是，这个选项的开启，会使得php的执行有严重的安全隐患，因为并不是每个程序员都那么严谨地会注意到这个问题。详细的东西，大家可以参考这里。

wp怎么处理的

如果，这个选项没有被开启，则函数直接返回；如果开启了，也即意味着所有的东西（EGPCS）都会变成全局变量，这个意味着啥呢？简单说，就是当你使用一个global $xxx的时候，你必须确认一次这个xxx到底来自何处，否则后果很可能会很严重。所以，wp在这个选项开启的情况下，率先将所有不该出现在GLOBAL里面的变量，全部给unset掉了。具体做法请参看代码，我也并没有完全看懂，还是对php执行的某些机制不了解，也先存个疑。

杂

这里，我实在是没啥名字可以用了。后面做了很多事情。

先是尝试修复WP的运行环境，然后检查了PHP的数据库扩展是否安装。

接着定义了计时开始函数，和计时结束函数，在很多模板的末尾，都有一个执行了多少时间和多少查询的统计，其中那个时间，就是在这里开始的。到了这里，我们来看看这个时间函数的代码。

function timer_start() {
global $timestart;
$mtime = explode(' ', microtime() );
$mtime = $mtime[1] + $mtime[0];
$timestart = $mtime;
return true;
}
//这里在放一个teimer_stop的函数头
function timer_stop($display = 0, $precision = 3) {}
?>

我主要是想说，其实，我们可以参考这个写法，在写插件的时候，利用这个来给自己的插件计算一个执行时间，也算是一个插件作者测试过程中的严谨作风了吧，毕竟，如果你发现你的插件执行时间非常恐怖，就要考虑改进你的算法或者策略了。编写主题的话，也可以考虑在footer中添加一个timer_stop（你完全可以放在注释里面），这样也能观察一下自己主题的性能。这个函数竟然还可以指定精度，倒是让我挺意外的，不过默认的3位已经相当足够了。

然后是一些常量。

DEBUG，我想，以后，我可能会用到这个吧，主要是调试WP的时候用的。

CACHE，这个常量是可以在wp-config.php里面定义的，如果你自己实现了一个advanced-cache.php的话，你可以把那个文件放到wp-content目录里面。

WPINC，引用目录，指向wp-includes目录。

LANGDIR，这个东西蛮好玩的，允许用户指定语言文件的目录，默认是在wp-content/languages或者wp-includes/languages里面。

PLUGINDIR，这个目录也可以指定，当然我不知道，更换这个目录到底有什么用。或许以后会发现。

上面加粗的常量，都是可以放到wp-config.php里面去指定的，以后也会沿用这一记法。

========罪恶分割线=========

终于把闲杂说完了，后面，就开始成批成批的引用其他的php文件了，所以，这里就先打住了。

收藏、分享这篇文章!

标签：code reading, WordPress

插件开发全攻略(11)---在你的WP插件中使用AJAX

Charles — Tue, 01 Jul 2008 13:41:23 +0800

越来越多的插件开始使用AJAX技术。我个人并没有在大多数的插件中看到过AJAX，但是使用AJAX来完成某个任务对你的插件来说可能是必要的。这篇文章将像你展示怎样在你的插件中使用AJAX。

这篇文章将在上一篇文章《在插件中添加js和css》的基础上继续。

建立一个新的PHP文件

Devlounge Plugin Series插件已经有了如下的目录结构了：

devloung-plugin-series
- devlounge-plugin-series.php(main plugin file)
- js
  - devlounge-plugin-series.js.php
- css
  - devlounge-plugin-series.css
- php
  - dl-plugin-ajax.php(新php文件)

注意，我的javascript文件的扩展名是php。我会在这篇文章后面解释这个变化的来历。

我已经建立了一个新的文件，并且把它放到了php文件夹中，并且命名为dl-plugin-ajax.php。我已经在这个文件中放了如下的代码：

<?php
if (!function_exists('add_action'))
{
require_once("../../../../wp-config.php");
}
if (isset($dl_pluginSeries)) {
$dl_pluginSeries->showComments();
}
?>

这个段代码非常简单，并且仅为做AJAX调用而写。它确保了配置结构存在，从而我们可以调用类对象dl_pluginSeries，引用其他WordPress函数和变量。然而，showComments函数还没有创建，我们下一个议程就是来做这件事。

定义showComments函数

showComments函数将放在我们的DevloungPluginSeries类中：

function showComments() {
global $wpdb;
$devloungecomments = $wpdb->get_row("SELECT count(comment_approved) comments_count FROM $wpdb->comments where comment_approved = '1' group by comment_approved", ARRAY_A);
echo "You have " . $devloungecomments['comments_count'] . " comments on your blog";
}
?>

可能已经认出来了，这段代码在数据库交互这篇文章中出现过。此函数输出你博客上留言的数量。

让JavaScript知道你的博客在哪里

使用AJAX时，一个烦人的事情就是外部JavaScript文件不知道你博客安装路径是什么。我是通过在js后面添加php扩展名来处理这个问题的，因为这样，我就可以调用WordPress函数了。在addHeaderCode函数中，我把代码从：

if (function_exists('wp_enqueue_script')) {
wp_enqueue_script('devlounge_plugin_series', get_bloginfo('wpurl') . '/wp-content/plugins/devlounge-plugin-series/js/devlounge-plugin-series.js', array('prototype'), '0.1');
}
?>

换成：

if (function_exists('wp_enqueue_script')) {
wp_enqueue_script('devlounge_plugin_seriess', get_bloginfo('wpurl') . '/wp-content/plugins/devlounge-plugin-series/js/devlounge-plugin-series.js.php', array('prototype'), '0.3');
}
?>

我唯一改变的是一个版本号码，还有就是给JavaScript文件添加了一个php扩展名。

编写JavaScript

这段脚本的目的是找到博客的URL，调用PHP文件，然后返回结果给用户。

<?php
if (!function_exists('add_action'))
{
require_once("../../../../wp-config.php");
}
?>
Event.observe(window, 'load', devloungePluginSeriesInit, false);
function devloungePluginSeriesInit() {
$('devlounge-link').onclick = devloungePluginSeriesClick;
}
function devloungePluginSeriesClick(evt) {
var url = "<?php bloginfo('wpurl') ?>/wp-content/plugins/devlounge-plugin-series/php/dl-plugin-ajax.php";
var success = function(t){devloungePluginSeriesClickComplete(t);}
var myAjax = new Ajax.Request(url, {method:'post', onSuccess:success});
return false;
}
function devloungePluginSeriesClickComplete(t) {
alert(t.responseText);
}

上述代码做了下面这些事情（记住，我们在使用Prototype）：

确定配置结构是存在的，这样我们才能访问WordPress函数
在文档已经装载后，devloungePluginSeriesInit函数被调用了
给你添加到文章末尾的链接上绑定了一个事件。如果你忘了，现在可以加进去。简单地找到文章，然后添加这段代码：<a href="#" id="devlounge-link">Get the Number of Blog Comments</a>
找到PHP文件的绝对路径
调用PHP文件
将反馈输出给用户

结果

下一步，我们假设你已经把那个链接添加好了。我们点击链接“Get the Number of Blog Comments”，脚本使用AJAX调用了DevlongePluginSeries类中的函数，并且以对话框的形式返回了结果。

就如你看到的那样，我的本地安装版本，并没有多少评论。

收藏、分享这篇文章!

标签：develop, plugins, translate, WordPress

WordPress到底在整啥？—(04)

Charles — Mon, 30 Jun 2008 19:44:29 +0800

如果用一条大河来比喻这个WP的话，那么前几次，我们还在此河的源头，代码简单明确，有如涓涓细流的小溪，从wp-settings.php开始，我们已经来到了此河干流，大片的代码，来到了我们的眼前，简直波涛汹涌，不过呢，再怎么多的代码，总归还得顺序执行，幸好这个WP不是多线程（哎呀，这话说得有点武断了，因为我真的没有看完呢^^）。

踏上征途

这里没有沿用前面几篇笔记的标题了，不用wp-settings.php来做标题，我这里简单解释一下，这个wp-settings.php在我看来，已经把WP最后产生出一个可供人们浏览的网页的之前的所有工作都做完了，当然也是靠着require之类的东西，引用别的文件做的，但是，真的做了许许多多的事情。如果我用这个wp-settings.php做标题，就得一直在这个标题下面，没完没了，直到把整个WP一遍跑到差不多80%了才能跳出这个标题，那多累啊。我没有那种一气呵成的水平，和能力，所以，我决定，以wp-settings.php为一个提纲，按照它规定的顺序和路线图，遇山开路，遇水架桥，逐步走完我们通览WP源代码的长征。

怎么走法？

其实，看一大陀的代码，是一件很累人的事情，但是我们想要揭示一下WP的内部运行机理，倒是非得麻烦一下不可，我看了有一些东西了，至少已经3个源码文件了嘛，还是有点心得的，有时候，我们看到上千行代码，总是会马上信心受挫，因为，很简单，真的很多。其实，这么多的东西，大都是支线剧情而已，打一个RPG，我的习惯是先赶快打一遍，把所有的主线剧情都打完，然后再从头开始，逐个地研究支线剧情，估计我们开代码也是如此。

一大堆代码里面，夹杂着许许多多的function xxxx(){}，这个东西叫做函数定义，不叫做函数执行，其实，函数定义在我看来，就应该算是支线剧情了，记住个名字，记住地点，ok了，我们可以先走开，会主线剧情。当然，有的时候，我们真的会判断失误，就是一个剧情其实不是支线剧情，因为走下去的时候，我们发现过不去了，这时候在折回来不迟。

所以，总结一下我们走下去的方法就是：曲折式前进，螺旋式上升。

啥还没说呢，就废了一堆话，唉，……，88

收藏、分享这篇文章!

标签：code reading, WordPress