GCCFeli.cn » 插件 http://gccfeli.cn Thu, 14 Jul 2011 08:18:00 +0000 en hourly 1 http://wordpress.org/?v=3.1 解析 WordPress 插件机制http://gccfeli.cn/2009/03/wordpress-plugin-principle.html http://gccfeli.cn/2009/03/wordpress-plugin-principle.html#comments Mon, 16 Mar 2009 09:45:15 +0000 Felicia http://www.gccfeli.cn/?p=313 转载自：http://hpyer.cn/dissect-wordpress-plugin.html

一直对软件的组件、插件架构非常感兴趣，我认为现在开发任何应用程序，一定要有一个架构良好的插件机制，这样可以吸引其他人来开发插件，极大的扩充系统的功能。Eclipse就是一个非常棒的例子，几乎你想什么功能，都可以从社区中找到相应的第三方插件。Firefox也同样如此，它的插件机制非常灵活（尤其是相对IE而言），因此Firefox社区中可以找到各种各样的插件。
阅读全文（2395字）]]> 转载自：http://hpyer.cn/dissect-wordpress-plugin.html

一直对软件的组件、插件架构非常感兴趣，我认为现在开发任何应用程序，一定要有一个架构良好的插件机制，这样可以吸引其他人来开发插件，极大的扩充系统的功能。Eclipse就是一个非常棒的例子，几乎你想什么功能，都可以从社区中找到相应的第三方插件。Firefox也同样如此，它的插件机制非常灵活（尤其是相对IE而言），因此Firefox社区中可以找到各种各样的插件。

1)WordPress读取所有可用的插件

在文件“/wp-admin/includes/plugin.php” 中，函数 get_plugins() 用来从文件系统得到所有的插件。原理很简单，就是读取“wp-content/plugins”目录下的所有PHP文件。这个函数允许一级的子文件夹，也就是说在’wp-content/plugins’下面的PHP文件，以及所以在此目录下的一级子文件夹内部的PHP文件被列作插件的候选，用下面的函数去进一步提取插件信息。这样的好处是方便用户利用文件夹来对插件进行管理和组织。

而函数 get_plugin_data() 则用来得到插件的描述（Plugin Descriptor），主要包括插件的版本、名称、作者，等信息，而这些其实是以注释的方式存在的。用WordPress中自带的Hello插件来举例：

<?php
/*
Plugin Name: Hello Dolly
Plugin URI: http://wordpress.org/#
Description: This is not just a plugin, it symbolizes the hope and enthusiasm of an entire generation summed up in two words sung most famously by Louis Armstrong: Hello, Dolly. When activated you will randomly see a lyric from <cite>Hello, Dolly</cite> in the upper right of your admin screen on every page.
Author: Matt Mullenweg
Version: 1.5
Author URI: http://ma.tt/
*/
?>

这样，在get_plugin_data函数中，就可以来得到插件的详细信息。

<?php
function get_plugin_data( $plugin_file ) {
    $plugin_data = implode( '', file( $plugin_file ));
    preg_match( '|Plugin Name:(.*)$|mi', $plugin_data, $plugin_name );
    preg_match( '|Plugin URI:(.*)$|mi', $plugin_data, $plugin_uri );
    preg_match( '|Description:(.*)$|mi', $plugin_data, $description );
    preg_match( '|Author:(.*)$|mi', $plugin_data, $author_name );
    preg_match( '|Author URI:(.*)$|mi', $plugin_data, $author_uri );
 
    if ( preg_match( "|Version:(.*)|i", $plugin_data, $version ))
        $version = trim( $version[1] );
    else
        $version = '';
    
    $description = wptexturize( trim( $description[1] ));
 
    $name = $plugin_name[1];
    $name = trim( $name );
    $plugin = $name;
    if ('' != trim($plugin_uri[1]) && '' != $name ) {
        $plugin = '<a href="' . trim( $plugin_uri[1] ) . '" title="'.__( 'Visit plugin homepage' ).'">'.$plugin.'</a>';
    }
 
    if ('' == $author_uri[1] ) {
        $author = trim( $author_name[1] );
    } else {
        $author = '<a href="' . trim( $author_uri[1] ) . '" title="'.__( 'Visit author homepage' ).'">' . trim( $author_name[1] ) . '</a>';
    }
        return array('Name' => $name, 'Title' => $plugin, 'Description' => $description, 'Author' => $author, 'Version' => $version);
    }
?>

2)启用 & 禁用插件

启用（禁用）插件的操作都在Plugins.php中，比如我要Deactive “Hello”这个插件，最后的URL其实是这个样子：

http://localhost/blog/wp-admin/plugins.php?action=deactivate&plugin=hello.php

其中，“Action”表示动作，值为“active”或者“deactivate”，而“Plugin”表示动作的对象插件，此处为“hello.php”。得到动作指令后，首先从数据库中取出当前已经激活的插件。

<?php $current = get_settings('active_plugins'); ?>

然后根据动作，重新生成已激活插件数组，存入数据库，并重新加载此页。加载的时候就需要考虑这些已经激活的插件是怎么工作的了。
BTW：附上数据库的Options表中0插件和只有1个插件的值：
没有插件：
a:1:{i:0;s:0:”";}

只有Hello插件：
a:2:{i:0;s:0:”";i:1;s:9:”hello.php”;}

3)如何加载启用的插件到系统中

WordPress中的每页都会包含“wp-config.php”文件，而“wp-config.php”中也会自动加载“wp-settings.php”文件。在“wp-settings.php”文件中，可以找到以下与插件相关的代码片断：

<?php
if ( get_option('active_plugins') ) {
    $current_plugins = get_option('active_plugins');
    if ( is_array($current_plugins) ) {
        foreach ($current_plugins as $plugin) {
            if ( '' != $plugin && 0 == validate_file($plugin) && file_exists(WP_PLUGIN_DIR . '/' . $plugin) )
                include_once(WP_PLUGIN_DIR . '/' . $plugin);
        }
    }
}
?>

可见，这段代码会取出系统中所有启用的插件，并包含进来。所以在每页加载的时候，都会首先包含这些插件代码。那么，这些插件自己在加载的时候都做了什么呢？

4)插件的加载

插件的加载其实最重要的一个部分就是插件的事件注册机制，WordPress插件中的事件注册其实和Eclipse中的扩展点（Extension-Point）机制非常相像，而这种类似“插销”、“插销座”的软件插拔方式也成为了最近软件组件架构方面应用最多的实践。
事件注册过程中比较重要的几个函数分别是：do_action、add_action、add_filter。WordPress中默认定义了很多扩展点（也可以叫做“钩子”），或者说注册了很多系统事件（WP中的正规叫法应该是“Action Tag”），比如“admin_head”表示Admin页面的Head输出事件，“publish_post”表示发布一篇帖子的事件等等。而插件要做的就是扩展这些扩展点，或者说挂接这些钩子，从而实现系统的扩展功能。add_action就是通常插件扩展某个扩展点用到的函数，而do_action 是扩展点本身开始执行的函数。
刚才说过WordPress中的每一页执行前都会Include所有Active的插件代码，而这些代码通常都会用“add_action”来将自己的函数注册到系统的扩展点中。这样，在扩展点执行的时候，就会找到系统中所有已经挂接到这个扩展点上的插件的函数来执行之，从而扩充系统的功能。
WordPress中的很多功能也都是通过这种插件结构来实现的，默认注册了很多系统事件，都在’default-filter.php’中。比如：

<?php add_action('publish_post', 'generic_ping'); ?>

这个是用来在发布每篇帖子的时候发送XML-RPC Ping的。再比如：

<?php add_filter('the_content', 'convert_smilies'); ?>

用来将正文（content）中的笑脸符号转换为图像。
还是举“Hello”插件来说。Hello插件会随机的在Admin Page的右上角显示一段话，它的工作原理是这样的：
在每一个Admin page的前面都有

<?php require_once('admin-header.php'); ?>

而在“admin-head.php”中将会执行扩展点“admin-head”的所有扩展：

<?php do_action('admin_head', ''); ?>

这样，就会执行所有挂接到admin_head的函数，Admin Page 的 Footer 部分也是类似。

5)如果插件中涉及UI

其实是一样的。以WordPress FeedBurner Plugin中添加菜单为例。
如果想添加一个菜单，就需要注册“admin_menu”这个Action Tag（系统事件）即可：

插件中的这个函数为：

<?php
function ol_add_feedburner_options_page() {
    if (function_exists('add_options_page')) {
        add_options_page('FeedBurner', 'FeedBurner', 8, basename(__FILE__), 'ol_feedburner_options_subpanel');
    }
}
?>

“add_options_page”这个函数就会在系统的“Options”菜单中添加“FeedBurner”这样一个子菜单。

6)其它

还有一些简单的插件就是只提供一些API函数。比如Most_Commented Plugin，它提供一个API “mdv_most_commented”：通过数据库查询得到评论最多的文章，并加以显示。因为这个插件已经被Include过，所以可以用这个API来进行显示。

]]> http://gccfeli.cn/2009/03/wordpress-plugin-principle.html/feed 2 Topcoder Arena 插件使用方法http://gccfeli.cn/2009/02/topcoder-arena-plugin.html http://gccfeli.cn/2009/02/topcoder-arena-plugin.html#comments Wed, 11 Feb 2009 02:26:08 +0000 Felicia http://www.gccfeli.cn/?p=296 TopCoder是一个优秀的网上编程竞赛平台。网站上同时提供了不少辅助性的插件，大部分是参赛者所贡献的。这些插件可以根据题目描述自动生成代码模版以及测试用例，便于在比赛中节约时间，以最高的效率解决问题。

插件下载

阅读全文（1795字）]]> TopCoder是一个优秀的网上编程竞赛平台。网站上同时提供了不少辅助性的插件，大部分是参赛者所贡献的。这些插件可以根据题目描述自动生成代码模版以及测试用例，便于在比赛中节约时间，以最高的效率解决问题。

插件下载

以CodeProcessor+FileEdit+TZTester为例介绍一下插件组合的安装方法： 策略设置

首先要修改系统的安全设置，找到java plugin所用的策略文件，一般是Program FilesJavajre1.5.0_02libsecurityjava.policy，在其中加入如下几行

grant codeBase "http://www.topcoder.com/-" {
    permission java.lang.RuntimePermission "setSecurityManager";
    permission java.lang.RuntimePermission "createSecurityManager";
};

这一步可能需要重新启动系统才能生效。 安装插件

  1. 下载插件
  2. 启动TCApplet并登陆
  3. 在option中选择Editor
  4. 点ADD
  5. name可以随便取一个，如CodeProcessor
  6. EntryPoint填：codeprocessor.EntryPoint，注意区分大小写
  7. classpath一栏，反复使用Browse加入CodeProcessor.jar，FileEdit.jar，TZTester.jar等，也可以手动输入，多个类之间以”;”隔开，可以使用相对路径。
  8. 如果设置正确，在点ok后，列表中就会多出一项
  9. 选择CodeProcessor，点Configure
    1. 在Editor EntryPoint里输入fileedit.EntryPoint，Configure可以对Editor进行详细的配置
    2. 在Processor Class里输入tangentz.TZTester，Verify可以校验输入是否正确
    3. 配置fileedit，将模版文件修改成TZTester提供的形式，
#include <functional>
#include <algorithm>
#include <stdexcept>
#include <iostream>
#include <sstream>
#include <fstream>
#include <numeric>
#include <iomanip>
#include <cstdlib>
#include <cstring>
#include <utility>
#include <cctype>
#include <vector>
#include <string>
#include <bitset>
#include <cmath>
#include <queue>
#include <stack>
#include <ctime>
#include <list>
#include <map>
#include <set>
 
using namespace std;
 
#define PB push_back
#define MP make_pair
 
typedef vector<int> VI;
typedef vector<string> VS;
typedef vector<double> VD;
typedef pair<int,int> PII;
typedef long long LL;
typedef unsigned long long ULL;
 
class $CLASSNAME$ {
public:
$RC$ $METHODNAME$($METHODPARMS$) {
    
}
$TESTCODE$
};
 
// BEGIN CUT HERE
int main() {
    $CLASSNAME$ ___test;
    ___test.run_test(-1);
}
// END CUT HERE

使用方法

打开题目，fileedit便会将解析题目得到的代码模版保存到本地文件中，TCApplet的编辑框中则输出提示信息。在竞赛过程中，可以选择将模版保存到指定的文件中，这样可以不用反复在IDE中手动加载；练习过程中，则可以选择保存到与类名相同的文件中，便于归档。TZTester会自动往代 码中加入测试用例，这些代码用自定义标记隔开，在提交系统进行编译测试的过程时候会被自动过滤。

在使用fileedit生成代码的时候可能会出现缩进不整齐的情况，可以用Astyle格式化。

与fileedit同类的还有KawigiEdit和PopsEdit等，这两个是独立的编辑器，不需要外部软件和IDE。各种Editor都可以脱离CodeProcessor使用，对于简单的应用已经足够。PopsEdit甚至还支持java代码的调试

TZTester生成的测试代码中，每个测试用例被写在同一行内。可读性比较差。而ExampleBuilder生成的代码则比较繁琐，并且在头部加入了一堆辅助函数。

其他几个插件还没有尝试，网页上也提供了插件编写的API，可以创建自己的插件

]]> http://gccfeli.cn/2009/02/topcoder-arena-plugin.html/feed 0