Becomin' Charles » plugins

［插件开发］获知文章状态变化

Charles — Fri, 31 Dec 2010 18:23:47 +0000

文章（post）是 WordPress 博客的核心价值所在，围绕一篇文章的增、删、改，我们可以开发很多有用的插件。近来，由于维护一款插件的需要，我碰巧研究了一下围绕文章发布流程而设立的一些钩子（hook）。微有所得，记录备查。

事情的起因是插件中的一个函数hook到了一个action上，名字是publish_post，顾名思义，在文章发布时候被激发的。为了要更清楚地掌控这个action，我想在源代码中，把触发点给找出来，这一找，问题来了。理论上，我们hook任何action，WP内部都会有对应的do_action来激发这个钩子，这一次，一搜，根本没有publish_post，那就有点小麻烦，说明具体激发哪个钩子，是运行时决定的，再明白点说吧，这个action的名字，应该使用变量拼出来的，所以我们直接搜publish_post很难找到调用点。

具体寻找的过程，我也不想赘述了，无非是查文档，搜代码。这里想要一提的是，我发现一个新的小技巧，给技巧取个名字叫“农村包围城市”，因为一下无法定位到想要找的代码，那么能准确定位其周边代码也是可以的，至少可以缩小查找范围。从文档中我们看到，在publish_post被激发的点附近，应该还有save_post，那么搜一下save_post，乖乖，准确找到了，然后就看到还有wp_insert_post，pre_post_update等等。然后，马上写一个小插件，向4个感兴趣的点hook，然后随便发布一下文章，根据打出的log，基本确定了publish_post就在pre_post_update和save_post中间激发。这时候就剩下80行左右的范围了，那一行行找还是很快的。

最终结果还是比较有意思的，有个函数叫wp_transition_post_status，这里面提供了3个hook，也可以说n个吧，因为这里面就看到了那个运行时才决定的hook名称的代码。最后不但搞清楚了publish_post的激发原理，还发现了原来可以随意通过hook监测每篇文章的状态变化。虽然短期内看不出来有啥用，但是以后一定可以想出来一些应用的。

transition_post_status 当一篇文章或者页面状态变化时触发，三个参数，分别是原状态，现在状态，文章对象本身
状态_to_状态 某个具体的状态流转时候触发，可以是draft_to_pending，private_to_publish等等，只要是合法的status取值，可以随意组合。一个参数是文章对象本身。
状态_类型 一个状态+一个类型，可以知道publish_post这个钩子，本质上就是这种，真实含义是有一篇类型是post（还可以是page）的文章，状态变成了publish，而不是已开始我理解成的发布一篇文章时候激发。说起来差别不大，但是你对其的理解已经完全变掉了。以此类推，你可以hook到private_post，还可以是draft_page等等。随意组合。

通过上述非常灵活的3种钩子，我们就可以随时掌控任何文章的状态变化了。

标签：action, development, hooks, plugins, WordPress

在插件管理页面给你的插件添加“设置”链接

Charles — Mon, 27 Sep 2010 13:53:31 +0000

在插件管理页面，每个插件下面有2-3个Action link，包含了用户可以对该插件进行的几种操作。在插件为禁用状态时，可用的操作有：Activate（启用），Edit（编辑），Delete（删除）；在插件为已经启用的状态下，默认有两个可用的操作：Deactivate（禁用）和Edit（编辑）。如果我们在这个列表里仔细观察，就会发现，有些插件会多出一个Settings（设置）操作。本文记录了，为插件添加Settings link的方法。没有什么过多的描述，直接放代码了。在插件主要文件中（包含了插件信息注释语句的那个文件），使用下面的代码，就可以为这个插件添加一个Settings link了。

function fmp_add_setting_link( $links ) {
$links[] = 'Settings'; //怎样构造这个link呢？大家可以自己想想
return $links;
}
if(is_admin()){
add_filter( 'plugin_action_links_' . plugin_basename( __FILE__ ), 'fmp_add_setting_link' );
}
?>

标签：code examples, development, DIY, plugins, WordPress

[插件开发]：检测WP插件的运行环境

Charles — Tue, 16 Feb 2010 01:31:36 +0000

WP的插件在开发完成后，会在用户的服务器上运行，而用户的服务器环境基本上可以用千奇百怪来形容。开发过程中，在本地运行得好好的插件的，一旦安装到用户的服务器上，也有可能变得无法运行。

所以，作为WP插件的开发者，最好不要对插件最终的运行环境做任何假设。而且，最好能够在插件被启用的时候，进行必要的检查，给用户以提示，对于自己没法兼容的问题，应该明确指出，避免用户遭遇不必要的麻烦。

在我个人的WP插件开发过程中，我主要遇到的问题，基本上都是PHP相关的问题。

第一个是PHP的版本问题，现在主流的PHP版本是PHP 5.x，而事实上，PHP 4.x仍旧大行其道，如果插件中用到了PHP 5的特性，那么就要想到，插件可能出现兼容问题。比如PHP 5和PHP 4在面向对象方面有一些不同，应用了新特性的插件，在旧有环境下，可能无法正常工作。

我自己遇到的一个例子是DOM Document函数扩展，在PHP 4 和PHP 5中，差别很大，没法兼容，对于这种情况，我也没有很好的办法，只能为两种版本各创建一个函数的版本。做这样的事情非常吃力，乃至我后来已经决定不再开发支持PHP 4版本的插件，只是在插件的说明中写明，未进行过基于PHP 4环境的测试工作，请用户慎重，可能无法运行。这也是一种权衡利弊，有的时候，你的时间精力都有限，可能不愿意做这种吃力不讨好的事情，那也是无可厚非的，但是最好说明这一点。

另一个问题是，个别函数的问题的。比如我遇到一个是mb_str*系列函数的问题，这个系列函数，对于中国用户来说，可能意义特别重大，因为这个系列函数可以正确处理亚洲字符和兼容UTF8字符集。而事实上mbstring这个扩展，并非是每个服务器环境都会配备的，如果调用到了系列的函数，必须要进行检测，好在有好多此系列的函数，可以通过自己实现来弥补。

一般来说，对于有可能不存在的函数，都可以通过自己实现来解决，但是这其中也有一些小陷阱，在解决这种类似的兼容问题后，最好进行全面的测试。举个例子，如果运行时php环境没有包含mbstring扩展，那么当需要调用mb_strlen函数的时候，很简单，可以用自己实现的版本；可是另一些情况就不行，我这里想举个例子，就是scandir函数，这个函数是PHP的内置函数，但是在很多服务器环境中，出于安全的考虑，可能会被禁用，常见的被禁函数有（passthru, exec, phpinfo, system, ini_alter, readlink, symlink, leak, proc_open, popepassthru, chroot, scandir, chgrp, chown, escapeshellcmd, escapeshellarg, shell_exec, proc_get_status），如果插件中用到了，最好认真针对其进行测试。我在处理scandir函数的时候，也用了自己实现函数的法子来解决，谁知道，一测试才发现了不对劲，看看这个提示：

Fatal error: Cannot redeclare scandir() in E:\Green_Software\xampp\htdocs\demos\index.php on line 24

这是我遇到的错误提示。后来写了一小段代码进行了测试，才发现这个问题，scandir是内置函数，在php.ini中，通过disable_functions选项将scandir屏蔽掉后，function_exists('scandir')函数将返回false值，然而，这个函数的状态却是declared。也就是说，这个函数明明“声明”了，却并不“存在”，那么一般套用的先判断函数是否存在，再决定是否实现自己版本的做法，就失灵了，会引发上述错误。这个问题让我相当头痛，在我看来，想要完美地解决，几乎是不可能。我用了一个非常笨拙的方法，就是对这一类可能会被禁止的函数进行封装。然后在实际调用的时候，调用自己重命名过的函数版本。

综上可以知道，就算同样是function_exists返回false情况，用同一种方法，也不能一并解决所有问题。最好的办法，还是用不同的办法综合起来解决问题，并且进行尽可能全面的测试工作，最后对插件可能引发的问题进行详细的说明。

在具体开发过程中，还是不要进行任何假设，对runtime环境进行一遍检查比较稳妥，下面贴一个本人进行环境安全检查的例子：

function safe_check(){
   if(!function_exists('scandir') && (!function_exists('opendir') || !function_exists('readdir'))){
   ?>

Sorry, PHP function 'scandir' is forbidden in your server, so that the plugin will not work. Please disable the plugin.

   }
}
if(is_admin()){
   add_action('admin_notices', 'safe_check');
?>

如上，用户会在打开后台页面时，就发现一条警告信息，说明此插件可能无法正常工作。

标签：develop, plugins, WordPress

[插件开发]：后台管理页面脚本按需加载

Charles — Mon, 15 Feb 2010 09:05:21 +0000

插件的后台管理页面的主要功能是协助用户设定插件运行时参数，一般都需要用户进行交互，这就少不了需要客户端脚本的参与（主要是js脚本，当然还有配套的css样式表）。

WP的后台本身就已经加载了许多的脚本，包括各类类库和基础功能的脚本。过多的脚本文件引入，会增加HTTP请求，增加流量，拖慢速度。好在，WP的后台已经采取了相当多的措施，来管理后台加载的脚本。首先是用wp-dependency管理依赖关系，用load-scripts来压缩、并加载脚本，使得各种类库被合并到同一个文件中进行加载，节省了HTTP请求数量和流量。

在开发插件管理后台的时候，窃以为还是遵循WP本身的开发习惯比较好，也将这一套措施应用到自己的开发过程中，这样一来，会有很多的好处。首先，不会给WP的后台带来太多的负担，使用WP本身的脚本加载机制，就不会为WP的后台增加多于的HTTP请求，而且，WP后台中，将脚本在页面的最尾部引入到页面之中，这也遵循了比较优秀的实践经验。

其次，使用WP自身的脚本管理机制，不会重复引入相同的脚本，也可以合理地管理依赖关系，在进行WP相关的开发过程中，如果需要引入特定的脚本库，只需要调用wp_enqueue_script函数即可，比如引入jquery类库，wp_enqueue_script('jquery);就可以实现在页面中正确引入jquery类库。WP_Script对象会自动判断重复，如果已经有别的插件或者页面本身已经引入了jquery，那么就不会重复引入。另举个例子，假如需要一个拖拽排序的效果，那么需要选用jquery ui中的sortable组件，那么只要调用wp_enqueue_script('jquery-ui-sortable');即可，在页面中，就可以发现，ui.core.js也被加载了，ui.core是sortable依赖的库，但是却不需要开发者自己去操心了。

从上述描述中，也可以看到另一个好处，就是wp其实已经包含，并且注册了很多常用的类库和效果库，使用其自带机制，调用这些脚本都是非常容易的，并不用费心去管这些脚本到底存在何处，其url到底是什么，只需要简简单单用一个名字既可以引入页面中。此外，如果插件中引用的脚本类库升级了，那么也会随着用户端WP的升级而自动更换是上升级的脚本，省却了更新插件的麻烦。

下面是我个人在开发中的实践作法。

在插件开发过程中应用脚本库和特定脚本需要调用的函数就是wp_enqueue_script，上面已经介绍过了，接下来介绍一下这个函数调用的位置。

比如说，我现在要开发一个插件，叫做detail info，在其后台管理页面中，需要用到jquery ui selectable组件。引入这个脚本的方法如下：

function plugin_detail_info_init(){
//一些初始化工作
....
wp_enqueue_script('jquery-ui-selectable');
....
//将实现插件功能的函数挂载到正确的hook上面
....
add_filter('wp_content', 'display_detail_info');
....
}
add_action('plugins_loaded', 'plugin_detail_info_init');
?>

一般我个人开发一个插件的时候，都喜欢将所有的插件初始化工作放到一个init函数中，然后将这个函数hook到plugins_loaded之上（这么做的原因就不赘述了）。在init函数中，就可以调用wp_enqueue_script函数了，当然也有不按照这个结构来写插件的，但是道理是一样的，就是此函数要在action wp_head和admin_head发生之前被调用，plugins_loaded这个action发生的顺序是非常靠前的，所以此函数放在这里，一定可以正确引入脚本。

当然，这么做只是可行的做法，却不是正确的做法，这么做的话，由于是添加到了plugins_loaded这个action中，那么所有的页面中，至少会多出几个脚本文件，一个jquery，一个是ui.core，一个是ui.selectable，这个组件仅需要在后台中引入，却不得不在所有的页面中加载，可以说，是一种很不经济的做法。对于开发者来说没什么，但是对于用户来说，就增加了他们服务器的负担。当然更多时候，用户可能并不懂得其中的意义，他只知道一件事情，就是插件装得越多，自己的博客运转速度就越慢，很多WP用户都经历过热衷于安装各种插件，到头疼安装了很多插件，到最后一切从简对插件望而却步的一个转变过程。其实，我个人觉得，在这个转变过程中，插件的开发者是负有一定责任的。

function plugin_detail_info_init(){
//一些初始化工作
....
if(is_admin()){
wp_enqueue_script('jquery-ui-selectable');
}
....
//将实现插件功能的函数挂载到正确的hook上面
....
add_filter('wp_content', 'display_detail_info');
....
}
add_action('plugins_loaded', 'plugin_detail_info_init');
?>

上面是更加常用的一种做法，通过is_admin()条件判断函数，来使得脚本只在后台加载，这样的话，就不会在博客的页面上添加可能根本就完全不会用到的脚本。

做到了这一步，基本上，事情已经做到差不多了，但是，这离尽善尽美还很遥远。使用上述第2个代码范例，可以使脚本不在前台页面加载，但是在后台页面还是没有区分能力，简单说，就是会在后台所有的页面中都添加了上述几个脚本文件。这样，会拖慢博客后台的速度，好在后台用户并不多，访问压力并不大，一时半会儿，也不会出什么问题。但是，短时间没问题不代表永远没有问题，在后台所有页面引入相同的脚本，有一个后果，很有可能在插件安装数量多了以后，出现脚本冲突问题。虽然这种冲突，可以通过脚本地开发技巧来解决，一般比较成熟的类库都不会互相发生冲突，但是，如果有开发者用这种机制引入了自己的编写的专用脚本，那就很难说了。

最佳的做法，无疑是只在用到的那个页面，才引入相关的脚本。其他页面一律不加入脚本。做到这一点，并不容易，乃至是相当苦难。我个人在开发过程中也试过几种方法，但是效果都不是很好。

起初，我的做法是，直接将脚本写在插件的管理页面的代码中，这么一来，肯定是可以实现脚本按需加载的，但是这样一来，就会使js脚本代码和页面代码混在一起，开发起来，维护起来，还是调试起来，都不是很方便。另外也破坏了web开发行为和数据表现分离的准则。不过，这种做法，确实是一种比较稳定而且比较容易想到，又比较好实现的做法。对与自己写的脚本来说，也没什么太多不便，不便主要体现在类库的引入上面，前文提到的好处一个都不复存在了。

后来，我又发现了一种方法，就是通过$_SERVER系统变量中的QUERY_STRING来判断当前所处的页面。比如，在上述范例的插件中，其管理界面的url显示成这个样子：

http://localhost/wordpress/wp-admin/options-general.php?page=detail_info_manager

从这个URL中，就可以判定出来，当前打开的页面确实是这个插件的管理页面，这样一来，以此为依据就可以决定是否要引入脚本，其示例如下：

function plugin_detail_info_init(){
//一些初始化工作
....
if(is_admin() && strpos($_SERVER['QUERY_STRING'], 'detail_info_manager') !== false){
wp_enqueue_script('jquery-ui-selectable');
}
....
//将实现插件功能的函数挂载到正确的hook上面
....
add_filter('wp_content', 'display_detail_info');
....
}
add_action('plugins_loaded', 'plugin_detail_info_init');
?>

上述这个办法在后台脚本引用管理方面的效果还算不错，基本上按照我的要求做到了按需加载。

标签：develop, plugins, WordPress

WordPress插件：CSDN Shared Items

Charles — Tue, 24 Nov 2009 14:27:40 +0000

我在CSDN上分享了很多东西，一直想把那个列表也在博客上罗列一个，一直就没有付诸于行动，昨天一发狠，终于弄了。

等于昨天几个小时，今天几个小时，搞出了一个小插件。就是右侧的一个小挂件。点上去就会链到CSDN的下载页面。

算是我把一年前的债还了。真开心。

插件里面没什么技术含量，就是小小调用了一下Google Feed API。

做这个插件，也引发了我一个思考。

能否在页面的head部分，就知道这个页面会装载哪些Widget呢？昨天折腾了半天，也没有解决这个问题。

解决的好处是显而易见的，现在的Widget，大多数都需要js来辅助了。但是很多高端的主题有数个sidebar，每页不同，如果Widget开发者，为了符合Web标准，把js放在head部分，就不得不无差别地在所有页面插入代码了。那样的话，添加一个Widget就会带来浪费的流量，页面速度也会被不断拖慢。

当然有个替代方案是把代码放到页面的footer部分，不过，个人以为，只要脚本出现在了Html body里面，那么直接嵌入到Widget中和hook到footer上，其实没什么本质区别，都破坏了行为和数据分离的原则。

这也是无奈之举了。谁叫WP设计成了sidebar.php执行前，无法知道页面会载入哪个sidebar这种结构呢？

当然，不排除还有更好方法的可能，如果知道的网友还望不吝告知。

标签：DIY, plugins, WordPress

如何才能按需加载脚本？

Charles — Sun, 26 Apr 2009 14:35:12 +0000

本文提出问题，并不解决问题。

我在研究Extended Live Archive（ELA）插件的代码，发现一个问题，这个问题具有一定的共性，而且，我现在也没有什么好的解决办法，所以我把它描述一下，看看有没有高人高见。

WP插件一般目标有两个，一个是增强博客页面功能，让观众有更好体验，另一个是增强博客管理页面功能，让博客管理者有更高管理效率。无论是哪一种，我们都经常会用到脚本，比如指定样式的CSS脚本，指定行为的JS脚本。好，现在问题来了，一般来说，我们使用插件增强的功能，都是在某个特定的页面上的功能，只有少数才是全局功能，直觉上，我们希望，在这个特定的页面上引入需要的脚本，而在其他的页面上不引入这段脚本。

我这个话说得有点绕，举个具体的例子。比如，某个插件，用于显示一个漂亮的相册，这个相册有一个自己专属的相册页面，这个相册的翻页功能需要用到prototype类库，你作为一个博客的主人，肯定是希望只有用户打开相册页面时，用户才需要下载prototype，平时看你的博客，不用每个页面都去下载一下prototype。（这个类库在没有pack的情况下128k大。）

希望我说清楚，这个问题概括成一句话，就是按需加载脚本，用到时，才下载。

事实上是这样的，我说得很轻巧，但是做起来却很难。就拿我手头的这个ELA来说事，这个插件是一个AJAX应用，用来展示一个结构化的归档目录。插件通过一个template tag提供用户接口，在调用这个template tag的页面，就会有归档目录出现。这个归档目录，必须要CSS文件来指定其样式，结果，我们的难点是，不知道用户会在哪个页面上调用这个tag，所以只能草草地把这个样式表hook到wp_head，导致的结果是，所有的页面上，都会链入这么一个样式表，而真正起作用的，只有一个页面而已。

我初步想了想，几乎想不出漂亮的办法能解决这个问题。这个问题的根本就在于，程序在执行到wp_head的时候，我们还没法知道后续的部分是不是会出现那个tag，而在真的执行到这个tag的时候，头部的内容已经形成了，我们回天乏力。一个直觉的办法，就是把那个样式表，直接也塞到tag的内部，事实上，插件的作者就是这么做的，不过，他只是把用到的JS脚本这么处理了，却没有把CSS这么处理，我猜想他代码写到这里的时候，可能内心也是非常矛盾的。（因为一个优秀的页面，就应该是数据、表现、行为分离的，这么做等于破坏了这个原则了）

好，到这里，问题应该算是说完了。其实这个问题相当普遍，只要我们需要将一个脚本添加到wp_head或者admin_head（对应的还有各自的footer部分），我们就面临着这个问题，你添加的东西，真的每个页面都需要么？如果是大多数页面需要，那还不是很浪费，最浪费的就是只有一个页面需要，而其他所有的页面都跟着增加负载。

WP的圈子里，有一种论调，就是插件用得越多，博客速度越慢，性能越差。我想，脚本没有能够做到按需加载，也算是造成这个论调的原因之一。

大家一起开动下脑筋吧~

标签：development, plugins, WordPress

怎样撰写Features List

Charles — Mon, 20 Apr 2009 15:02:05 +0000

当开发好一款插件的时候，要为插件撰写一个readme.txt文件，这是让用户了解你的插件的最好方式。很多插件都会在readme.txt的第一个section（description）里，附上一个简单明了的features list，以便用户可以快速扫描你插件包含的功能，决定是否选用。那么应该如何撰写features list呢？本文为您介绍。

我不是一个撰写readme.txt的专家，但是我经常需要做这件事情，我自己也很不在行，从来没有仔细研究过这件事情，今天在这里写下的是我第一次研究的笔记。对本文内容的权威性，大家请自己斟酌。

首先来看一看例子：

Templates : You can add custom templates for your theme.
Media RSS feed : Add the Cooliris Effect to your gallery
Role settings : Each gallery has a author
AJAX based thumbnail generator : No more server limitation during the batch process
Copy/Move : Copy or move images between galleries
Sortable Albums : Create your own sets of images
Upload or pictures via a zip-file (Not in Safe-mode)
Watermark function : You can add a watermark image or text
JavaScript Effect : Use any available popular image effect : Shutter, Thickbox, Lightbox or Highslide
Multiple CSS Stylesheet : Use a nice shadow effect for your thumbnails with your own CSS file
Slideshow : Full integrated flash slideshow
TinyMCE : Button integration for easy adding the gallery tags
Sidebar Widget : Show a slideshow, random or recent picture at your sidebar
Language support : Translated in more than 30 languages
Upload tab integration : You have access to all pictures via the upload tab
Tag support for images : Append related images to your post, create a image tag-cloud
Meta data support : Import EXIF, IPTC or XMP meta data
Sort images feature
Cool flash addons here : url

这份列表，撰写得有其特色，这是NextGen Gallery的features list。其采用的格式为：“特性名称：简述”。特性名称，一般采用的是名词，可以是具体名词，也可以是动名词，其格式基本上比较统一。

而其简述部分，则比较自由。

第一句，you can do sth. 是一个简单句。以第二人称描述，这跟人的感觉像是一个推销员，在与你说话，隐含了一层意思，“如果你用了本插件”，“你就可以用这款插件做……”。第二句，是一个动宾短语，我们可以猜测其隐含主语，窃以为，仍旧是“你”，“(you are able to) add Cooliris Effect to your gallery (with it)”。看到这里，我们就可以统计一下，这么多features里，使用这两种用法的句子，暗红色为第一种，浅蓝色为第二种。除却这两种，我们还看到其他的例子，用绿色标出的，是我个人认为有一些共同点的例子，第一个是简单句，但是是以第三人称为主语的句子，后面两个，则是分词开头的关于，而我猜测其主语，也为第三人称。

看了看原作者的blog，基本上是英文写成的，而也有少量的德语，我们可以视其为是native speaker。从他撰写的特性列表里，我们可以学习到一些西方人传达信息和接受信息的模式。他们更关心的是，可以用这款插件做什么，他们应该怎么使用这款插件。一款插件的使用方式和其提供的可能性，是他们关心的东西。而插件本身利用的技术，插件本身的性质和特性，不是他们关注的东西。

如果你的插件，有许多的特性，你在描述的时候，应该转换一种表达思路，即这种特性，能够带来一种什么样的使用上的可能性。尽量使用第二人称来描述，“你用它，能够干……”。这是西方人，更能接受的一种方式，也符合他们的表达习惯。

行了，本文就写到这里。其实，我还看了两个插件的features list的，但是基本上雷同，大家可以自己分析。本文主要写给自己看，作为自己学习写作的一些笔记。

标签：develop, English writing, plugins, WordPress

Simple Paypal Donate插件

Charles — Sun, 12 Apr 2009 15:25:56 +0000

如果你是一个插件开发者，那么应该使用这款插件，在你发布插件的页面上放上一个Paypal Donate按钮，这样如果用户心情好了，兴许就会给你捐一点。

今天终于看到了这么款插件，但是，我这篇文章其实是想说，这个插件，我对它很不满意，对不起它灌了一个Simple的名字，插入这个按钮好麻烦啊，还要用php函数去写。

我觉得，这款插件可以有个很体贴的改进，就是增加在对shortcode的支持。这样，我不但可以在页面中插入捐赠按钮，也可以在任何一篇文章中插入捐赠按钮，你们说呢？

插件页面在这里

标签：idea, plugins, review

WordPress插件：选项查看器

Charles — Wed, 08 Apr 2009 08:20:47 +0000

Options Inspector is a tool with which you can list all the options in your database, view a certain one in detail, even its data is serialized, and alter exactly a certain part of option value. It is mainly designed for plugin developers and theme designers.

When I am debugging a plugin, I always want to konw, whether the options in this plugin are saved exactly or not. Usually, I add var_dump statement in my source code to print the options out. Everything looks good, but when I finished my job, it bothered me a lot to remove this debug statements. What annoyed me even more is that when I change my mind and changed the structure of the option, I must use additional statement to alter the option or directly use SQL in phpMyAdmin. Finally, I created this tool to assist the plugin development.

Features:

List all options order by option_id.
Search option through keyword.
View unsierialized value of options.
Modify option use PHP code.

Demo: (Click to see the full size.)

Download: Options Inspector v1.0.1

选项查看器是一款开发辅助工具，用于显示，修改和删除选项。免去了使用打印语句和使用phpMyAdmin的调试后台选项的麻烦。愿大家能够更轻松地开发WordPress插件和主题。

一般，不建议您在您的主力博客上尝试该插件的修改和删除功能。

标签：development, my works, plugins, tools, WordPress

Flash Mp3 Player FAQ

Charles — Fri, 13 Mar 2009 04:05:09 +0000

Author of this document: Snowblink

Actually, I'm lazy, and I hate paper work. My dear friend, Snowblink, created this document. Thank her very much!

非常感谢snowblink的辛勤工作，我不知道如何才能用英语表达对你的感谢。所以用中文再说一遍！

If the following answers do not solve your problem, please contact the author via the Contact Form.

Please describe your problem, the PHP and wordpress version you use, and what you have already tried in detail.

Q1: Which version of the PHP do I need to make the flash mp3 player work?

A: This plugin requires PHP version 4 or higher.

Q2: Which version of wordpress does the plugin require?

A: WordPress 2.5 or newer recommended.

Q3: When I use your plugin, I got the following error message:

Warning: domdocument() expects parameter 2 to be long, string given in /home/8099/domains/funkshoppe.com/html/wp-content/plugins/flash-mp3-player/flash-player-widget.php on line 120
Fatal error: Call to undefined function: loadxml() in /home/8099/domains/funkshoppe.com/html/wp-content/plugins/flash-mp3-player/flash-player-widget.php on line 121
My WP version is 2.6. What can I do?
A: This error may result from using PHP prior to version 5. Maybe you could edit the "playllist.xml" by hand. The file is in folder"flash-mp3-player". Now, this plugin support PHP 4.

Q4: I'm not able to see the plugin in the options panel, where I can change the playlist. Although I can configure the widget, I see nothing where I can change the playlist. What can I do? I try already to reinstall it, but nothing changes.

A: Maybe the options panel does not work under PHP prior to version 4.2. But you can edit the playlist manually instead of using options panel. The playlist file is a XML file in the plugin directory called playlist.xml. You can edit it using Notepad or something like that. There are some samples in this file originally.

Q5: I want to get rid of the title "Flash MP3 Player" which appears above the player and the bar that appears below the player. What can I do?

A: To get rid of the title "Flash MP3 Player", you should go to the widgets admin page, find the Flash MP3 Player widget, and edit its title.

I don't know exactly what the bar you talked about. If you mean the playlist part of the player, you can go to the options->MP3 player page, and input the answer "no" to the question "Show play list,yes or no?"

Q6: When I try to change my playlist, it doesn't change in the player. I changed the song titles and locations in the player settings, and those changes were written to the playlist xml file, but the widget in the side bar is still playing the old playlist. I've tried refreshing the webpage and cleared my temporary Internet files and cookies. I've tried it in Firefox 3 and Internet Explored 7. I've removed and replaced the widget. I've deactivated and reactivated the plugin. I just can't get it to update and use the new list. Any suggestions?

A: It seems that you have tried every method I can find to fix this problem. I still think the real problem is that the browser does not download the playlist xml file, but still use the old one. Maybe you could try another version. Its location is at....(此处有附件，没包括）

Q7: Every time I try to put in my own songs and press save, none of the options save. Actually, I cannot change the default options. Please help me.

A: You could try to edit the playlist manually, it is in the /wp-content/fmp_my_playlist directory. If the playlist is not there, maybe you could try to update the plugin. I hope this could help.

Q8: Is it possible to extend the playlist to approx.15 songs? Is there a way to order playlist into albums?

A: If you want to insert more than 10 songs to your playlist, the only way currently is to edit the playlist.xml manually.This file is in directory "wp-content/fmp_my_playlist".
I am sorry that you cannot manage the playlist by albums, since the player itself does not have this feature.

Q9:I've just tried installing your flash player on my WP 2.6 site.
However, I got the following error when turning the plugin on:
Warning: copy(/home/staff_hosting/vgames_beta/public_html/minisites/blogs.vgames.co.il/public_html/h2/wp-content/fmp_my_playlist/playlist.xml) [function.copy]: failed to open stream: No such file or directory in /home/staff_hosting/vgames_beta/public_html/minisites/blogs.vgames.co.il/public_html/h2/wp-content/plugins/flash-mp3-player/flash-player-widget.php on line 49
In addition, when trying edit the player configuration, I got this error:
Fatal error: Class 'DOMDocument' not found in /home/staff_hosting/vgames_beta/public_html/minisites/blogs.vgames.co.il/public_html/h2/wp-content/plugins/flash-mp3-player/flash-player-widget.php on line 147
What to do?

A:It seems that the copy function fails in your site. You could try this:
First, create a directory "fmp_my_playlist" in "/wp-content".
Second, copy the file "playlist.xml" which is under the plugin directory to the new directory.
Third, try to edit the playlist in admin panel again.
If all of the above don't work, you could edit the playlist.xml mannually.

Q10:When accessing the player configuration menu, I get the following error:
Fatal error: Class 'DOMDocument' not found in /home/staff_hosting/vgames_beta/public_html/minisites/blogs.vgames.co.il/public_html/h2/wp-content/plugins/flash-mp3-player/flash-player-widget.php on line 147
I guess this means I won't be able to use the configuration menu?
I tried editing the XML file manually and uploading it via FTP, but it seems to have no effect.
EDIT: It seems my browser was simply displaying the cached version of the site.
This keeps happening whenever I edit the play list - in both IE and FireFox. Any thoughts on how to make it refresh?
I don't want to require the users to clean their cache every time to see the updated play list.

A:It seems that the PHP on your host does not support the DOMDocument class, so you have to edit the playlist manually.
In fact, there is a way to force browsers to download the new version of the playlist:
First, find this line in the source code(line 69)
$datafield = $base_name . '/mp3player.swf?playlist=' . $fmp_listfile_url;
Second, change it to:
$datafield = $base_name . '/mp3player.swf?playlist=' . $fmp_listfile_url . '?' . rand();
This is a little trick. The random query string will tell the browser, "this playlist is not the same one with you have downloaded last time, and you must download it again." (此处有附件，没包括）

Q11:Would it be possible to make track names right-alighned and right-to-left in direction?Does that require a code change or just an addition to the playlist XML?

A:Sorry,you can not make the player right-align the track name through the configure xml file, and me too. I'm not the author of the mp3 player, I'm just the one who make it a WP plugin.

标签：documents, FAQ, plugins, WordPress

Sidebar Widget: Picasaweb Photo Slide

Charles — Mon, 08 Dec 2008 15:09:20 +0000

This plugin is created long time ago.

I built this plugin for one of my friends. But she is now not using it. So I have no reason to improve it.

I put it here and I hope someone will find and like it.

This plugin is just a simple slideshow sidebar widget, the photos it use is in one of your Picasa photo albums.

Ok, you could see the LIVE DEMO here! On the right side, it shows a lot of beauties.

Download Here

If you have any questions, please contact me through the following form:

cforms contact form by delicious:days

标签：my works, plugins, sidebar, widget, WordPress

WordPress Plugin: Embedded Slideshow

Charles — Sun, 07 Dec 2008 15:43:21 +0000

English version is under construction...

If you have any question please use the contact form in this site to send me a email.

此插件用于帮助用户在编辑日志或者页面的时候，轻轻松松插入Picasa相册的幻灯。

具体效果请见官网截图。

下载地址（Download）

标签：my works, plugins

提示：WP Thread Comment插件与WP2.7兼容问题

Charles — Fri, 21 Nov 2008 03:32:22 +0000

Updated:目前该插件的功能已经修复了~~

今天凌晨，Leo提出了给霍霍更换WP2.7，操作完成后，发现WP Thread Comment插件的后台直接评论回复功能失效。

这里特别提醒想要升级到WP2.7并且同时在使用WP Thread Comment插件的朋友，目前的WP Thread Comment插件版本的后台评论回复功能无法正常使用。

除此功能之外，该插件的其他功能尚未发现问题。如果平时就不用后台评论功能的朋友，可以放心。

原因分析

该插件在后台admin_footer部分，插入了一个表单，该表单内部有两个隐藏域，comment_post_ID和comment_reply_ID，还有文本框，其id为comment。大家更新到WP2.7后就会发现，实际上WP2.7在评论系统改进很大，本身就内置了后台评论功能，而这样的功能其实现原理都雷同，恰巧，WP2.7自身也在后台隐藏了一个表单，这个表单里也有两个隐藏域和一个文本框，又恰巧id也是上文提到的那3个。而且这个表单所在的位置比WTC插件插入的表单位置靠前。所以，WTC插入的js代码每次都读到WP2.7自己插入的表单域，这就导致了这个功能的紊乱。

解决方法

手动修改WP Thread Comment插件，将其插入到后台admin_footer部分的表单的隐藏域的id重新命名，如改成wptc_comment_post_ID，将textarea的id重新命名为wptc_comment。

然后将对应的后台评论提交部分代码（其他部分代码，如前台嵌套回复部分的代码不能改）里调用到这两个id的地方改名。

使用建议

没有足够的把握，请不要DIY。

禁用WP Thread Comment插件的后台回复功能，等待其原作者更新插件。

后记

原本以为WP2.7改进评论部分后，将会带来完美的体验，但是实际上，无论是其提供的嵌套评论功能，还是评论分页功能，都不是那么好用的，操作复杂，代码繁杂，定制性有限，极大地增加了主题开发者的负担。

作为用户来说，我本人也不是很想用WP2.7提供的评论系统的。不过，总体来说，我对WP还是有信心的，它的tag功能一开始也是相当地烂，后来也渐渐改好了。我想评论部分也会如此的。

标签：advice, DIY, notice, plugins, usage, WordPress

WordPress插件介绍：cformsII 及其汉化包

Charles — Thu, 20 Nov 2008 09:28:50 +0000

Updated: 终于与插件原作者取得了联系，得到了作者的支持，本文链接已经被列到了官方插件主页上，热情的作者还帮忙制作了标题图片的汉化版本。本文底部的下载也就顺便升级到了9.3版本。

一直以来想给自己的博客添加联系表单功能，但是一直也没有碰到好的插件，直到在后台的最流行插件推荐那里，看到了cformsII，一款强大无匹的表单插件。cforms意思为custom forms，就是自定义表单的意思。

这款插件的主要功能有：

1. 设定自定义表单，允许插入到页面，日志中去；

2. 非常强悍的表单定制功能，支持各种表单域，可添加验证码，Ajax提交；

cforms定制表单的界面

特定表单的属性设定界面

3. 可以取代WP的评论表单；

4. 集成了Tell-A-Friend的功能；

5. 强悍方便的后台管理界面；

丰富的自定义功能

在某个页面或者某篇日志插入表单是很轻松的

6. 无比丰富的文档；

第一次看到在插件内部带有如此详尽的帮助

关于中文包的使用说明：

中文包的目录结构:

plugins-----cforms
    |              |_______cforms-admin.css
    |
    |_______cforms-zh_CN.mo

使用plugins作为跟目录，意思就是想告诉各位，使用的时候要把cforms-zh_CN.mo直接放在wp-content/plugins目录下，而不要放在插件目录内。

特别附加了一个插件目录内的cforms-admin.css，该文件不是必须的，但是用这个文件替换了原来的文件后，会使后台看起来更加舒服一点，因为原来的英文后台字体设定得特别小。

Updated:改插件目前升级到了9.3版，而中文包是针对9.2版本制作，经检查，只增加了一个短小的字符串（Title：标题），所以不对中文包进行更新了。

Updated:插件升级到了9.4版本，字符串基本上没有变化，大家可以继续使用v9.3的汉化包~~

Updated:插件升级到了10.0版本，增加了一个多页表单的功能，字符串更新74处，请升级到新版的同学更换语言包~~

Updated:2009-2-21 15:55:01：插件升级到了10.3版，字符串更新了近30处，请需要更新的同学自行下载~~

标签：my works, plugins, recommend, translate, WordPress

WP插件介绍：让不同页面帖子数不同

Charles — Thu, 20 Nov 2008 05:20:31 +0000

Different Posts per Page

Different Posts per Page的管理页面截图

让不同的页面，显示的帖子数不同。

WordPress博客支持设定每个页面显示的日志数量，但是这个数量是一个统一值，比如我设定成10，则我的首页显示10篇日志，归档页面也显示10篇日志。对于我这样的人来说，这个功能还不够强大。

我希望我的首页显示的帖子数或者说文章数少一些，这样有几个好处，第一，首页显示的日志少，那么首页就会比较短，然后首页的尺寸就会比较小，下载速度就会非常快，第二，我最近更新频率比较低，如果首页显示的帖子比较少，那么我更新一篇文章，相对来说，整个页面变化就比较大。

另一方面，我又希望我的归档页面显示的日志数量能够多一些，我想，朋友们应该有这种感觉，比如使用google的时候，结果页面一页只有10条，老得不停地翻页，如果有50条，可能在第一页就可以找到要的东西。那么我想，如果一个读者如果进入到我的归档页面，那么他可能真的要找东西了，所以，应该尽可能多显示一些，让他快点找到他要的东西。当然，如果数量太多，页面就会变得很长，要用滚动条滚动半天，我的解决办法是用jQuery把归档页面的所有帖子给折叠起来，只漏个标题出来。这样页面就短了。（以后我可能会写篇文章介绍这个方法）

Different Posts per Page插件，就是能够实现我说的功能的插件，不但可以随意的指定不同页面的日志数量（分类页面可以指定不同分类的显示日志数量），还可指定排序方式（按日期升序或者降序）。使用非常简便。不过，值得一提，该插件需要注册，当然注册是免费的。如果讨厌注册步骤，本文最后的链接是我修改的版本，不需要注册。当然，我还是推荐使用注册版本，因为可以使用自动插件升级。

插件页面 | 官方插件目录

http://www.box.net/shared/of0hh10jvr

标签：plugins, recommend, usage, WordPress

本站推出联系表单

Charles — Wed, 05 Nov 2008 15:26:15 +0000

一直以来，想给博客添加一个Contact Me，但是一直都没有付诸行动。上周，这个任务进入到了我的本周必须完成的任务列表里面，所以，昨天晚上我一鼓作气就给搞定了。

以后各位朋友跟我联系就会方便很多了。嘿嘿~~

也因此发现了一款非常强大的插件cformsII，真是不错，我目前正在汉化这个插件，虽然说，官方页面上有一个汉化包提供的，不过我个人觉得那个做得实在很差，很多字符串没有翻译，尤其是帮助部分。我估计那个汉化作者只是个英语专业的人才，对于博客，尤其WordPress，还有对于HTML，CSS等等知识很有限，所以，翻成那个样子也不能太怪他。我决定我自己来翻译一下，就当作是一个锻炼好了。

那个插件里有将近1000个字符串，而且很多都是大段大段的文字，估计我的进度会比较慢了，因为工程真的是非常浩大的。届时，我将会在自己博客上放出，供朋友们玩赏~~

好了，有什么好想法，赶快去Contact页面，给我发个信吧！！

标签：DIY, plugins, usage, WordPress

插件升级：Flash MP3 Player

Charles — Tue, 23 Sep 2008 09:51:03 +0000

插件主页在这里！FAQ

又好久没有写博客了，不过，我确实一直没有离开WP的阵营，每天还在坚持着折腾一下WP，哈哈。由于我又开了一个生活日记类型的博客，所以，这里，我就打算只写些跟WP有关，跟技术有关的东西了。而这些天一直没有更新这个博客的原因，我只能说，有一些与WP相关，但是更加激动人心的事情让我着迷。

终于，又有一个老外朋友碰到了播放器插件不兼容PHP4的问题，让我下定决心把这个问题给解决了。今天，花了好多时间，我终于把这个问题给处理掉了，并且在PHP4.8.8上测试通过了，当然理论上是支持PHP4.3.0以后的版本的。

主要更新：

1. 支持PHP 4.3.0 以后的版本；

2. 将播放列表移动到了wp-content目录下，这么做的原因是，下次再有升级的时候，你原先设定的播放列表不会被覆盖。

更新时间：

3天后吧……

我希望使用这款插件的国内朋友都能看到这个通知，提前备份好自己的播放列表再升级，不然的话，播放列表会被覆盖。外国朋友，唉……，我就照顾不到了，实在抱歉啊~~主保佑你们。

当然，没有看到这个通知的朋友们，主也会保佑你们的……

看到通知，不想等待自动升级的朋友，下载链接：

http://downloads.wordpress.org/plugin/flash-mp3-player.zip

标签：my works, plugins, update, WordPress

关于WKC Clear的简短说明

Charles — Fri, 19 Sep 2008 15:42:33 +0000

升级到WP Kit CN最新版本的朋友可能会看到多出来一个插件，就是WKC Clear。

以前，由于一个我也搞不清楚的原因，WP会把WP Kit CN中的热评文章Widget和高级友链Widget认为是两个单独的插件，导致这两个Widget在加载前，就被WP认为是已经加载了，最后结果就是没法在后台出现。

WKC Clear的作用就是把这两个非法注册到系统，但是实际上又不存在的两个插件给清除掉的工具。按照我原来的设想，这个插件启用后，后台就会出现6个Widget了，可是实际的结果是，启用这个东西后，热评文章和高级友链就肯定出不来了，但是再把WKC Clear禁用掉，6个就会都出现了。也就是说，这个东西的使用方法就是先启用，再禁用。

如果同学们在使用过程中，有什么不一样的情况，可以跟此贴来汇报~希望这个东西能帮大家解决问题。

最后，如果没有出现过Widget神秘失踪的同学，可以无视WKC Clear。下个版本将不会带有这个东西。

标签：my works, notice, plugins, WordPress

WordPress 插件：CSS Cache Buster

Charles — Sat, 13 Sep 2008 08:56:45 +0000

众所周知，浏览器一般会缓存CSS文件，以节省下载量和提高页面显示速度，这种机制就叫做缓存。

但是，缓存也有一定的弊端。如果您的CSS文件已经更改，但是浏览器不知道，而缓存下来的CSS文件也没有过期，浏览器仍旧会使用缓存中的CSS文件，也就是旧的样式。

当然，很多有经验的用户都知道，只要使用Ctrl+F5，强制刷新浏览器，就可以让浏览器下载新的样式表文件了，但是作为一个博客网站，你不可能让你的每个用户都去自己Ctrl+F5一下，很傻是不？

其实，解决这个问题是很简单的，以前，我就在网上看到过，是为了解决js文件的缓存问题的，js也有相同的问题。要说解决之道，到是非常的简单，因为如果请求css文件，或者js文件的链接变化了，也即url变化了，浏览器就会认为，这是完全不同的两个文件，就不会使用缓存中的文件。所以，只要改变url，就可以让浏览器强制更新缓存了，当然，每次换url也很麻烦，我们一般使用的办法是给url添加一个query string，比如，原来申请的是：

和

现在变成：

和

就是在后面跟了一串数字，我的页面用的一个json，因为每次都要重新下载，所以，我在请求的url链接后面，带了一个随机数，这样，每次浏览器都会认为，这是一个全新的文件，都会去下载。

当然，大多数情况下，是不需要每次都下载，也即在站点没有更改自己的css文件和js文件的时候，浏览器要使用缓存，而更改了后，所有浏览的用户就要自动下载。最好的办法，就是用文件修改的日期来做后面那串数字，既保证了用户那边的效果会实时更新，又保证了能够使用缓存这种机制。

前两天看到个小老外，写了篇文章介绍这个东西，WTC竟然也推荐了，原来这个方法竟然如此的不普及啊~~小老外的文章看这里，讲得和我说得是一回事：

Smart cache-busting for your WordPress stylesheet

达人Matt给他提了个建议，让他使用filter来实现这个，这样，每个主题都会因为这个而受益。结果这个小老外就去写了一个插件，叫做CSS Cache Buster（点击链接，查看插件页面，下载插件）。

我本来以为这个小老外这两天迟迟没有动手呢，我就先写了一个，结果发现小老外竟然Updated了，只是我没有看到，赶快把他的插件下回来看了下，发现小老外写的东西用的filter没我好，他不直接，他用了bloginfo_url这个filter，而我直接用了stylesheet_uri这个filter，比他少了一次判断，但是小老外也有优点，就是他考虑了别的插件已经添加过query string的情况，而我没考虑，可见我的经验尚浅，或者说我还是不够勤劳，总之，自我感觉有那么点败给小老外了……

感兴趣或者经常喜欢修改style.css的同学请安装他的插件吧，可以少按很多次Ctrl+F5呢，嘿嘿

下面放上我写的代码，权当是一个纪念吧：

/*
Plugin Name: Smart Cache-busting Stylesheet
Plugin URI: http://sexywp.com/
Description: This plugin will tell the explorer that your stylesheet has been changed and the explorer will redownload the style.css file instead of using the cached one.
Author: Charles Tang
Version: 8.9.13
Author URI: http://sexywp.com/
*/

add_filter('stylesheet_uri','cache_buster_code',9999,1);

function cache_buster_code($stylesheet_uri){
   $pieces = explode('wp-content', $stylesheet_uri);
   $stylesheet_uri = $stylesheet_uri . '?' . filemtime(ABSPATH . '/wp-content' . $pieces[1]);
   return $stylesheet_uri;
}
?>

标签：development, my works, opinion, plugins, WordPress

WordPress插件本土化：秀出你的评论数！

Charles — Thu, 04 Sep 2008 03:27:02 +0000

今天，要介绍给大家的这款插件叫做Liz Comment Counter（点进去吧，去Ozh那里看看美丽的截图，和详尽的介绍，e文滴--b），这是由著名的插件达人Ozh编写的，由著名的篡改达人Charles篡改 -_-## 寒一下~~~（表拍砖）

说白了，效果很简单啦，就是像本站右边栏那样的，看起来有点像FeedSky的统计图标。当然，那个颜色是可以调整的，后面的字也是可以调整的，完全自定义！！这就是Ozh的强大。

我篡改了啥呢？

咦？……为啥你的“评论徽章”上面的字是中文的？（高手当然不会好奇任何东西，飘过飘过吧）

我就是简单本土化了一下。

好，下面放出下载链接：

点击这里

用法是超级简单的，Widget嘛，没什么花头的。里面选项，要注意，如果用了中文，字体选“Simfang”（没错，这个字体我加的，是仿宋，因为体积最小，只有3M，你可以放个好看的雅黑40M或者宋体10M到你的fonts文件夹，在插件目录里面，字体自己去找）。

如果不想使用Widget，想用手动调用（为啥总有小强那么爱找麻烦呢？），可以使用如下template tag：

不过呢，选项设定就烦一点了：

1. 进入Widgets管理页面，添加Liz Comment Counter Widget；

2. 设置选项，保存；

3. 移除Widget，保存；

通过这个动作，你设定好了选项，但是又没有添加Widget，烦吧，如果你的主题正好不支持Widget，那么，是否需要我教你怎么做？？汗……提示一下，先换上一个支持Widget的主题，比如default……………………好冷~

Updated：

发现Jinwen写过这个文章的，唉，慢了一步，还好我汉化了不算啥都没干，大家去看看他的文章吧，很详细。

Smartr.cn：秀秀你的评论数

标签：localization, plugins, WordPress

WordPress插件修改：Share This (jQuery)

Charles — Tue, 02 Sep 2008 12:15:49 +0000

Share This 中文，我很喜欢，看起来效果很好，但是……

建议牛人出来重写sofish改过的那个Share This。

Alex King大大写的Share this基本上没有照顾到中文用户。

后来，经过sofish改写，我们有了非常适合中文博客使用的Share this 中文。

但是，这个插件有三大缺憾：

1. 这么简单的功能，居然动用了prototype，此类库尺寸达128k。

2. 在hook使用方面，没有进行优化，如果一般用户不知道，安装了这个插件会在每一个页面都引用一个prototype进来，汗，实际上只需要在single页面引入，更人性化的做法是根据用户的需求来引入js文件和css文件。

3. 完全应该改个名字重新发布，这并不是说对原作者不尊重，而是现在这个插件的代码看起来和原来的已经差别较大了，而且此插件进入官方目录，使用的是GPL协议，我们可以另立门户，这样使用此插件的用户就不必要收到升级的困扰，上次我误点了升级，直接跳到Alex King的版本上了。

希望能有人接手这个工作！

最后还是要谢谢写出这个插件的Alex King和修改它的sofish。

上面是我在论坛发的帖子，没有人响应我，囧……

其实，说的就是一直以来我想做的事情。

实在不能忍了，于是自己动手了，囧！

那个插件的sofish版本还有一个问题的，当时stephen跟我提出过的，就是点击一个搜藏链接的时候，应该采用打开新页面更加符合中国人的习惯。这次我也一并给改了。

好，我就不多说了，把我改的版本放出来给大家分享下吧。

http://www.box.net/shared/naa6u9oi2j

建议：模板里已经使用了jQuery的人推荐用这个版本。

另外：jQuery也不是必须的，因为基本上没有用到相关度的什么特性，所以，建议使用纯js重写，囧！

有学习js的，jQuery的同学愿意尝试下么？

Updated:2008年9月2日21:28:37

调用方法没有变化，大家去sofish的那个页面看看调用方法吧，我懒得写了

标签：jQuery, my works, plugins, WordPress

WP Kit CN再次更新~

Charles — Sat, 30 Aug 2008 10:36:25 +0000

囧rz

不好意思，老打扰大家~

这次加强了一下recent comments相关的Widget和Template Tag。

可以使用这种格式指定列表项。

%gravatar%%comment_author%: %comment_excerpt%

All the %xxxx% tags you can use are included in the above example.

所有可以使用的变量都在上面的例子里面了，我想他们的含义应该是不言自明的。

如需帮助，再给我留言。

标签：my works, plugins, WordPress

WP Kit CN 更新！

Charles — Wed, 27 Aug 2008 07:03:15 +0000

紧急：好多同学升级到新版以后出现Fatal Error，我还在紧急处理。

如果老版本没有问题的话，建议退回去。

下载地址：

http://downloads.wordpress.org/plugin/wp-kit-cn.8.8.9.zip

现在最新版本已经到了8.8.28，主要改动就是在尝试解决Fatal Error的问题，希望勇敢的小白鼠去测试。我之所以说尝试，是因为我自己没有出现Fatal Error，所以我不知道问题在哪里，我只能猜测。希望看得懂我在说什么的同学，能告诉我灾难出现的方法。十分感谢！

现在已经有一个同学走出了Fatal Error的阴影了，参见 http://www.1sight.cn/?p=167。他文中提到的修改版本，就是目前的8.8.28版。希望出现此问题的同学试试看，有问题再跟我反应，我会保持密切关注这个问题。谢谢~

8.8.27 尝试去解决如下问题，解决的打钩：

1. 评论榜widget添加两个选项before和after——√

2. 摘要算法自定义“按照字数”“按照段落数”“综合控制”——×

3. 调查一下是否与wp-statistics冲突——×

4. 活跃评论者中要过滤掉PB/TB——√

5. 升级后，新的widget无法显示的问题——×

6. 热评文章增加“是否显示评论数”的选项——√

7. 最近留言用户应该可以控制数量——√

8. 允许关闭摘要算法——√

9. 升级后不会自动启用——×

http://wordpress.org/extend/plugins/wp-kit-cn/

标签：my works, plugins, WordPress

WordPress插件开发实例--(02)

Charles — Thu, 21 Aug 2008 03:16:14 +0000

插件源于需求。——Charles

我有一个私人博客，目前使用的WordPress的development version，该版本可以提供WordPress的一键升级。各位WPer应该是有福了，不过呢，这个一键升级，却给我带来一点小麻烦。

我选用了default主题，而这个主题是WP的一部分，所以，每当一键升级的时候，就会使得我自定义的样式被覆盖>.< ，太糟糕了。两次，粗心大意，我于是乎决定，开发个插件，摆平它！

其实很简单的啦。上次，我们使用了一个filter，还记得不，是the_content。这次，正好，我们就用到了一个action。这个action叫做wp_head，是在模板的header.php加载接近结束时候触发的，具体位置视模板不同而有所不同。但是，有一点是确定的，就是wp_head，会在标签之前被触发。

这个action的作用，就是专门在模板中添加插件需要使用的css或者javascript文件的。正好，我利用这个action，将我自己的自定义css文件给插入到当前使用的模板中。

贴点代码吧

/*
Plugin Name: Insert Custom CSS
Plugin URI: http://sexywp.com/insert-custom-css.htm
Description: This plugin will insert a custom css file to your current theme.
Version: 8.8.21
Author: Charles Tang
Author URI: http://sexywp.com/
*/

/*
   Copyright 2008 Charles Tang (email : )

   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License as published by
   the Free Software Foundation; either version 2 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program; if not, write to the Free Software
   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*/

function insert_custom_css(){
   $css_url = WP_CONTENT_URL . '/plugins/insert-custom-css/style.css';
   echo '' . $css_url . '" type="text/css" media="screen" />';
}
add_action('wp_head','insert_custom_css');

?>

很简短吧，真正的代码只有四行噢~~

标签：develop, plugins, WordPress

WordPress Plugin：Flash MP3 Player

Charles — Tue, 12 Aug 2008 00:55:54 +0000

Introduction

Huo is one of my best friends I get acquainted with on the internet. She want a music player which can be put on the sidebar of her blog. She is a newbie in the internet and WordPress. Although to create a XML config file and playlist is very easy, it is still too hard for a green hand like her. That is why I created this plugin—making it easy.

Widget support and user friendly administration interface are the most important two features of this plugin. But the features of the player itself, e.g. shuffle the playlist, are not under my control. The player this plugin used was found on the internet, they are created with flash. This kind of player has the best browser compatibility.

The flash player of the first version(8.x~9.x) of this plugin is like this:

I found this player on the internet and I don’t know who is the author. This player is very simple. You can not change the color scheme and make full control of its dimension. Its advantage is tiny, just 8k bytes.

The flash player of the now version(10.0.x) of this plugin is like this:

This player is the famous JW player(the latest version of it is v4.4). I choose the version 2.3 because it is tiny(9.5k bytes) and it is good enough to be a MP3 player. You can change the color scheme of it, change the background image, set the default volumn, shuffle the playlist and so on. It’s great!

Usage

under 10.x

under construction …

10.x

under construction …

Demo

under construction …

Download


DOWNLOAD the new version 10.0.4	DOWNLOAD the old one 9.3.31

Note: The version 10.x does not support PHP 4.x. If the PHP version on your web server is under 5, you should use 9.x of this plugin.

FAQ

Updated：（2008年9月23日20:08:07）已经修复了不能支持PHP4的问题了，插件的内部结构也做了小小的改动，升级的时候也不会覆盖原来的播放列表了。升级说明看这里。

Updated：（2008年8月19日20:08:07）非常遗憾，此插件目前只支持PHP5及以上版本。这是我考虑不周了。如果是PHP5以下版本的同学想用，可以装上，但是不能在后台编辑播放列表，必须手动编辑playlist.xml文件。

曾几何时，我在一个博客上看到这个播放器，那时候，那个是装在Default主题上的，觉得很别致，很好看，后来，那个博客不知怎么关掉了，所以我就找不到了。

前些日子，由我作为客服支持的博客《双霍记》提出播放音乐的需求，我开始狂找这款播放器，终于给我找到，遗憾的是，竟然不是一个网络服务（我个人比较喜欢网络服务类的），是一个单机的Flash版本MP3播放器。

为了便于伟大的上帝（就是霍霍，客户嘛）使用，我将其Widget化了，播放列表的那个xml文件，也通过后台管理页面来读写了。

这里我上一个后台截图，具体效果可以看~~霍霍博客：《双霍记》~~ 《所谓伊人在何方》。

下载地址：

http://wordpress.org/extend/plugins/flash-mp3-player/

Updated:

A new version is under development, here is a picture to show:

标签：my works, plugins, WordPress

WordPress插件：WP Kit CN

Charles — Sat, 02 Aug 2008 13:55:31 +0000

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

这次我发布的插件，来源于中文WordPress工具箱。

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

正如您所见，这个插件，又是一个对原插件的狗尾续貂。

本博客原先推出过《中文工具箱CT版》，其起因，正是为了朋友的博客出现的问题，而改进原插件。不过，我认为，那点改进并不算是成功，也有朋友在留言中一语中的，说基本没有什么变化，我深表认同。

经过反复思考，我个人感觉，凭我的能力是不能给中文WordPress工具箱带来什么质的飞跃的，但是，我或许可以让这款插件更加地平易近人。这一次，趁着休假的机会，我实现了自己这个由来已久的想法。

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

功能描述：

最新评论输出
最新文章输出
N天内留言最多用户输出
本周或本月内留言最多用户输出
随机文章输出
评论最多的文章输出
最近回响输出
自动摘要算法，更加适合中文使用

特性描述：

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

鸣谢：

桑葚（http://yan.me/dia/），感谢做出这么好的插件！

Yskin （http://yskin.net），摘要算法来自于你的插件！

stephen（http://www.caxblog.com），感谢那么认真的测试！

IZK（http://doublehuo.cn），我直接在你的博客上实验效果！

zEUS （http://zeuscn.net），感谢你的建议！

官方主页&下载：

http://wordpress.org/extend/plugins/wp-kit-cn/

文档：

http://sexywp.com/wp-kit-cn-doc

Updated：

2008年9月19日《关于WKC Clear的简短说明》

2008年8月30日《WP Kit CN再次更新~》

2008年8月27日《WP Kit CN 更新！》

标签：my works, plugins, WordPress

WP Kit CN 需要您！

Charles — Thu, 31 Jul 2008 06:52:43 +0000

新版本的“中文工具箱CT版”的开发已经进入尾声（上个版本的及历史版本见这里），现在还欠缺大量文档，我估计我还要写个一阵子。

新版本特性：

重新搭设了框架，调用模式稳定下来了
又增加了两个Widget支持，使中文工具箱不再有不支持Widget的硬伤
后台管理页面

现在正式更名为WP Kit CN，这个也是为了与国际接轨，由于Plugin Directory迟迟不给我Approve，导致此插件暂时没法进入官方的目录，所以，现在先努力撰写文档。

在这期间，希望借助大家的力量，来测试一下此插件，也希望听听大家的意见。目前，我已经在两个WP 2.6博客上测试，一个是我自己的，另一个是双霍记。

我自己主要是使用了其中的自动摘要功能，大家进入我的分类Archive页面，就可以看到，仍然沿用了Yskin大大的算法，但是已经支持在后台自定义了。

双霍记则启用了三个Widget，分别是最新评论，最活跃用户，和热评文章，大家感兴趣可以去看看效果。

最后，希望有能看懂一些PHP代码的朋友能够踊跃参与测试，愿意测试的请在留言时明确表达参与测试的意愿，并使用真实Email，我将插件打包发给您。

对于现在这个版本，以前的文档已经不再适用，我个人直接提供技术支持，直到测试结束。

测试期间，版本可能会连续变动。

此测试版本与原先版本不兼容。

标签：plugins, WordPress

近况汇报

Charles — Mon, 28 Jul 2008 10:58:04 +0000

哎呀，貌似又有几天没有写博客了是吧，人懒了，实在没得东西写了，系列文章写着太累，慢慢来吧，天干物燥，大家稍稍凉快下，我就不拿技术的狂热温度来给大家升温了，我也凉快凉快。

先来看个好玩的文章吧，这个是google黑板报上的文章，大家想知道Google公司内部是怎么调位置的么？看看就知道了。我都笑得肚子疼了，这种换座位的方式，还真的非常的“Googley”。看来，想进Google公司的话，还有一个条件，就是让自己做事情更加的“Googley”，嘿嘿，我的模板算不算“Googley”呢？我不禁要想了……嘿嘿，充其量是个外表而已，内核可是根本的“WordPressly”啊，无奈……不说废话了，大家欣赏下吧

http://googlechinablog.com/2008/07/blog-post_28.html

一直以来想好好改进中文工具箱的，昨天，奋斗了一天，中文工具箱终于有了管理面板了，然后晚上睡觉的时候，我就又产生了好几个想法了，想往工具箱里加好多东西，我很害怕啊，最后这个东西会不会变成没人要用的怪物呢？嘿嘿，到时候，就我自己来用算了。罗列下改进的地方：

1. 改变了整体目录结构，除了主文件，其他文件都进入到子目录里面了，这样看起来简洁多了；

2. 进行了文件重命名活动，将以前的内容按照更有逻辑的方式进行安排了，这样更加有逻辑性了，这算是重构了吧，嘿嘿；

3. 增添了一个管理面板，这样，下一个版本里面，就不会在插件列表里面看到4个插件了，只会看到一个“中文工具箱”，进入管理面板，可以启用3个内置的widget，而且，上次在“中文工具箱”中增加的摘要算法，也在管理面板中可以定制了，包括截断字数，截断段落数；

4. 规范了模板标签，以后调用方式会大大简化，不必每次都去搞一个对象句柄，我已经进行了封装，这样以后无论内部怎么变化，模板标签都不会变化了。以后使用时候都是wkc_xxxx或者get_wkc_xxxx这种格式，怎么样，很面熟吧，是不是真的有点像template_tags了？

还有很多我想要实现的改变，但都是些大手术，我也不知道我什么时候能够开发完毕，下一个版本，我打算用Plugin Directory来发布了，不在我自己的博客上搞了，呵呵。

其实，昨天还有一个事情，我刚才没说的，就是我体验了一把Plugin Directory，真的很爽哦，哇哈哈，我把字数统计插件放到那里面去了，当然，只是为了体验一下这个东西，果然很好玩。以后都用那个了。

其实SVN还是很好用的，不过，好像我们学校非常诡异的没有开放那个端口，在学校期间，很可能不能使用SVN，那就糟糕咯，说不定只能两周会一次家来更新插件了。

好了，唠叨到这里吧，嘿嘿……

标签：develop, interesting things, plugins, WordPress

让WordPress 2.6正确统计中文字数

Charles — Fri, 25 Jul 2008 15:12:41 +0000

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

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

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

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

中文字数统计插件

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

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

下载链接：

http://wordpress.org/extend/plugins/chinese-word-count/

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

================================

@2008年7月28日14:52:41 Updated：根据Leo的提示，更新了一个目录问题，将插件上传到了插件目录，体验了一把插件目录。不过呢，搞错了一次目录结构（汗），现在已经修正了。

@2008年8月5日13:41:16 Updated：修复了若干的bug，增加了一个Widget，高级友链Widget。此Widget可以自由设定需要显示的链接的分类，显示链接的数量，排列顺序。

@2008年8月9日13:43:25 Updated：增加了卸载功能，可以一次性删除所有已经设定的Options。

标签：plugins, WordPress

您可能也喜欢：
插件开发全攻略（08）---构建一个WordPress插件用户面板	WordPress:插件开发API（Plugin API）	使用NetBeans IDE 6.5作为WordPress的开发环境	WordPress插件开发实例--（01）	插件开发全攻略（04）---WordPress插件的结构
无觅

您可能也喜欢：
插件开发全攻略（08）---构建一个WordPress插件用户面板	使用NetBeans IDE 6.5作为WordPress的开发环境	WordPress插件开发实例--（01）	插件开发全攻略（09）---WordPress插件和数据库交互	WordPress插件：选项查看器
无觅

您可能也喜欢：
WordPress插件开发实例--（01）	使用NetBeans IDE 6.5作为WordPress的开发环境	WordPress:插件开发API（Plugin API）	插件开发全攻略（08）---构建一个WordPress插件用户面板	插件开发全攻略（04）---WordPress插件的结构
无觅

您可能也喜欢：
使用NetBeans IDE 6.5作为WordPress的开发环境	WordPress插件开发实例--（01）	WordPress插件开发实例--(02)	插件开发全攻略（06）---WordPress插件Filter	插件开发全攻略（03）---怎样获得WordPress插件的创意
无觅

您可能也喜欢：
WordPress:插件开发API（Plugin API）	插件开发全攻略（08）---构建一个WordPress插件用户面板	使用NetBeans IDE 6.5作为WordPress的开发环境	插件开发全攻略（06）---WordPress插件Filter	插件开发全攻略（09）---WordPress插件和数据库交互
无觅

您可能也喜欢：
使用Google AJAX Libraries API替换WordPress自带的js库	WordPress备份及灾难恢复	WordPress插件开发实例--(02)	在WordPress中使用统计工具	WordPress插件开发实例--（01）
无觅

您可能也喜欢：
WordPress 开发资源	WordPress:插件开发API（Plugin API）	使用NetBeans IDE 6.5作为WordPress的开发环境	WordPress插件开发实例--(02)	WordPress插件：选项查看器
无觅