阿德日志 » 插件 http://blog.delai.me 我的自留地 Thu, 29 Dec 2011 03:33:58 +0000 en hourly 1 http://wordpress.org/?v=3.3.1 WordPress运行原理学习笔记之二：插件机制初探 http://blog.delai.me/2008/07/plugins.html http://blog.delai.me/2008/07/plugins.html#comments Tue, 15 Jul 2008 12:18:21 +0000 阿德 http://www.soulward.cn/?p=234 WordPress运行原理学习笔记之一：主题机制初探

WordPress运行原理学习笔记之二：插件机制初探

WordPress的插件机制使得开发者可以方便地向系统添加自己需要的功能，而这是使得Wordpress得以在全世界流行的重要原因。一个 WordPress插件是一个程序,或者是用PHP脚本语言写出的一个或一些函数的集合，用来往WordPress Webblog 里增加一些特定的特征和服务，它们可以通过WordPress的 Plugin Application Program Interface (API) 提供的接入点和函数无缝的集成到Webblog里.

插件机制的实现主要依靠wp-includes目录下的plugin.php文件，该文件中包含了与插件机制相关的几个函数。在 wordpress内核运行时设立了一些标记(tag)，当遇到这些标记时，wordpess会自动调用挂载到 (hook to)这个标记上的所有函数，该功能是通过数组来实现的，其过程可以直观的表示为下图：

插件hook原理

用户可以通过plugin API方便的将自定义的功能添加到系统相应的位置。需要指出的是：wordpress定义了两种类型的插件API，行为(actions)和过滤器 (filters)：

Actions: Actions are the hooks that the core launches at specific points during execution, or when specific events occur. Your plugin can specify that one or more of its PHP functions are executed at these points, using the Action API.

Actions 是由WordPress内核在执行过程中的特定的点或者特定的事件发生时调用的. 使用这些Action API,你的plugin可以指定在这些点去执行一个或者多个PHP函数.

Filters: Filters are the hooks that WordPress launches to modify text of various types before adding it to the database or sending it to the browser screen. Your plugin can specify that one or more of its PHP functions is executed to modify specific types of text at these times, using the Filter API.

Filters是一种hooks,由WordPress调用,针对于各种形式的文本,让它们在进入数据或发送到浏览器之前得到调整. 使用Filter API,你的插件可以指定在某个时间执行一个或者多个PHP函数来修改特定类型的文本.

一、一个最简单的插件的开发过程

下面以阿德弄的一个a_simple_song插件(其实跟自带的那个插件是一样的，只是修改了歌词而已)为例简述整个过程三个步骤：编写插件要执行的代码，添加add_action()，进入后台激活它。
该插件的功能是：在WordPress后台左上角随机显示《一首简单的歌》这首歌的歌词。
1．在wordpress目录/wp-content/plugins/下新建一个文件：a_simple_song。
2．用文本编辑工具打开它，输入<?php    ?>，接下来的工作就是在这里面填写相应PHP代码。
3．首先按一定的格式编写本插件的一些信息，WordPress读取它用于在后台显示，方便用户查看：

/*
Plugin Name: 一首简单的歌
Plugin URI: http://blog.shidelai.cn/#
Description: 这个插件会在后台随机显示《一首简单的歌》的歌词。
Author: 施德来
Version: 1.0
Author URI: http://blog.shidelai.cn
*/

4．编写要执行的操作：
$lyrics = “一首简单的歌    //定义了一个字符串数组用于存储歌词
这世界很复杂
………
你是我最珍贵的财富”;
$lyrics = explode(“\n”, $lyrics);
//explode()是PHP内置函数，功能就是分割字符串成字符数组
$chosen = wptexturize( $lyrics[ mt_rand(0, count($lyrics) - 1) ] );
/*
给chosen赋一条随机的歌词
wptexturize()在wp-includes\functions-formatting.php定义，功能：把某些特殊符号给自动转换化成标准码格式。
mt_rand()函数返回它2个参数之间的随机值
count()返回数组大小
*/
function a_simple_song() {
global $chosen;
echo “<p id=’dolly’>$chosen</p>”;
}
//dolly样式表由后面定义。
//显示歌词
5．添加add_action()，将a_simple_song函数hook到main_foot tag的队列中
add_action(‘admin_footer’, ‘a_simple_song’);
//admin_footer.php被调用时执行这个函数
add_action(‘admin_head’, ‘dolly_css’);
//admin_head.php被调用时执行dolly_css()
具体经过请参考下面的从源码解读a_simple_song插件的调用过程。

这样，保存为.php文件方到plugins文件夹下面，再到后台激活就可以了。效果如图

二、WordPress对所有可用的插件的读取

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

foreach($plugins as $plugin_file => $plugin_data) {
…..
$plugin_data['Title']       = wp_kses($plugin_data['Title'], $plugins_allowedtags);
$plugin_data['Version']     = wp_kses($plugin_data['Version'], $plugins_allowedtags);
$plugin_data['Description'] = wp_kses($plugin_data['Description'], $plugins_allowedtags);
$plugin_data['Author']      = wp_kses($plugin_data['Author'], $plugins_allowedtags);
$author = ( empty($plugin_data['Author']) ) ? ” :  ‘ <cite>’ . sprintf( __(‘By %s’), $plugin_data['Author'] ) . ‘.</cite>’;
….
}

用于从插件的头部注释中获取插件的版本、名称、作者，等信息。

三、Active & Deactive Plugin（插件的激活与注销）

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

http://localhost/wordpress/wp-admin/plugins.php?action=deactivate&plugin=a_simple_song.php&_wpnonce=242c8cc3e5

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

$active = get_option(‘active_plugins’);

然后根据动作，重新生成已激活插件数组，和theme一样存入数据库，并重新加载此页。加载的时候就需要考虑这些已经激活的插件是怎么工作的了。

四、插件的加载过程

WordPress中的每页都会包含”wp-config.php”文件，而在”wp-config.php”的最后有这样一句：

<?php require_once(ABSPATH.’wp-settings.php’); ?>

在”wp-settings.php”文件中，可以找到以下与插件相关的代码片断：

if ( get_option(‘active_plugins’) ) {
$current_plugins = get_option(‘active_plugins’);
if ( is_array($current_plugins) ) {
foreach ($current_plugins as $plugin) {
if (” != $plugin && file_exists(ABSPATH . PLUGINDIR . ‘/’ . $plugin))
include_once(ABSPATH . PLUGINDIR . ‘/’ . $plugin);
}
}
}

可见，这段代码会取出系统中所有Actived的插件，并Include进来。所以在每页加载的时候，都会首先Include这些插件代码。这也就是为什么在主题模板里面可以直接调用插件的函数。

五、WordPress通过插件机制注册系统事件

WordPress中的很多功能也都是通过这种插件结构来实现的，WordPress默认注册的系统事件保存在default-filter.php中。比如：
<?php add_filter(‘the_content’, ‘convert_smilies’); ?>
用来将正文（content）中的笑脸符号转换为图像。
add_filter(‘comment_text’, ‘wptexturize’);
用来将从数据库提取的正文中的特殊符号转化成标准格式的。

六、从源码解读a_simple_song插件的调用过程

在每一个wordpress/wp-admin/下面的文件（也就是后台显示需要的文件）的前面都有

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

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

<?php  do_action(‘admin_head’, ”); ?>

这样，就会执行所有hook到admin_head上的函数
Admin Page的Footer部分同样如此，

<?php do_action(‘admin_footer’, ”); ?>

这样，就会执行所有挂接到admin_footer的函数

a_simple_song里面有这么2行代码：

add_action(‘admin_footer’, ‘a_simple_song’);
add_action(‘admin_head’, ‘dolly_css’);

将控制形式和内容2个函数挂到不同的tag上，控制文字显示位置和样式的dolly_css是先被调用，然后admin_foot.php被调用一次，a_simplesong()也就被调用一次，来显示歌词。

Comments

Related posts:

[原文链接：http://blog.delai.me/2008/07/plugins.html] ]]> http://blog.delai.me/2008/07/plugins.html/feed 7 flickrRSS高阶使用三部曲之二：在WordPress博客中显示与文章内容相关的Flickr图片 http://blog.delai.me/2008/06/essay-photo.html http://blog.delai.me/2008/06/essay-photo.html#comments Sat, 14 Jun 2008 06:55:56 +0000 阿德 http://www.soulward.cn/?p=214 在WordPress插件：显示flickr上的图片－flickrRSS使用详解中我介绍了flickrRSS插件的简单应用，也列举了如何在留言框下面显示flickr上最新发布的标签为：hangzhou的图片。但阿德总感觉这样太单调了，可不可以在这个位置显示与这篇文章内容相关的图片呢？如果可以岂不是太爽了？答案当然是肯定的！要不就不会有这篇博文了，呵呵。:cool:

方法

1. 在打开主题文件夹下的single.php，在

<div class=”post” id=”post-<?php the_ID(); ?>”>

……….

</div><!–/post –>

之间添加如下代码：

<?php
$tags = explode(“, “, get_the_tag_list(”,’, ‘,”));
$first_tag=preg_replace(‘|<a\s.*?>(.*?)</a>|i’,   ‘\1′,   $tags[0]);
?>

2. 将flickrRSS使用详解里面提到的

<div id=”related-pic”>
<?php get_(8, “community”, “$first_tag”, “square”, “&nbsp;”, “&nbsp;”); ?>
</div>

修改为：

<div id=”related-pic”>
<?php get_flickrRSS(8, “community”, “$first_tag”, “square”, “&nbsp;”, “&nbsp;”); ?>
</div>

这段代码在新的flickr5.0版本中不适用了，具体解决方法看这里flickrRSS高阶应用三部曲之新版本flickrRss 5.0补录

另外你可以参考不同浏览器里图片大小不同的解决方法

就是显示flickr上标签与文章第一个标签相同的图片，但是注意：文章的第一个标签并不是你在编辑时候输入的第一个标签，而是按照字母排序的第一个标签。

当然你也可以再这设置个$second_tag让它显示包含头2个标签的图片。不过我发现这样会很少有符合条件的图片，很多情况下一张都没有（主要是因为flickr上的标签英文居多，我们博客的标签中文居多）。

Advanced

发挥你的想象力，get_flickrRSS()真的是很好很强大阿，它一共可以设置7个参数，下面的参数介绍你或许用得着。

  1. $num_items – how many photos you want to appear   显示多少图片
  2. $type – specify user, set, favorite, group or community photosream    设置是在用户的所有图片，还是用户的收藏，还是。。。。中搜索
  3. $tags – a comma separated list of tags (with no spaces)  标签
  4. $imagesize – square, thumbnail, medium or large  图片大小
  5. $before_image – html appearing before each photo  插入每张图片之前的html代码
  6. $after_image – html appearing after each photo   插入每张图片之后的html代码
  7. $id_number – specify a user id (or group name)   在特定的用户或者组中搜索
  8. $set_id – specify the set id (found in set url)

Comments

Related posts:

[原文链接：http://blog.delai.me/2008/06/essay-photo.html] ]]> http://blog.delai.me/2008/06/essay-photo.html/feed 7 flickrRSS高阶使用三部曲之一：显示flickr上的图片 http://blog.delai.me/2008/06/how-to-flickrrss.html http://blog.delai.me/2008/06/how-to-flickrrss.html#comments Fri, 13 Jun 2008 07:30:32 +0000 阿德 http://www.soulward.cn/?p=209 通过flickrRSS你不仅仅是可以显示你自己flickr帐号上的图片，你也可以在WordPress博客中任何你想要的位置显示你所设定的flickr上的图片。比如：本网页留言框下面显示的是flickr上Tag为杭州的最新上传的图片，侧边栏上“养眼美图”部分就是flickrRSS的Widget，通过后台添加即可。

下载＆安装

flickrRSS 4.0 — for WP 2.5
flickrRSS 3.5 — for WP 2.3

解压缩后复制到plugins目录下即可，然后后台激活。

注意：由于flickr是国外网站，速度会比较慢，如果需要将图片在本地缓存，你需要新建一个可写的目录用于缓存图片。这样，图片第一次被浏览时候会下载到改目录下，下次就直接从该目录读取图片了。

比如在wp-content目录下新建一个文件夹命名为cache。

设置


进入setting（设置）下的flickrRSS设置页面，这里设置的是默认情况下flickrRSS输出的内容（用于侧边栏的Widget和<?php get_(); ?>）以及缓存文件夹的路径。

1. 点击ID Number后面的 idGettr 输入一个Photostream Address（形如：http://www..com/photos/delai，就是每个flickr用户主页的网址，你可以找个自己比较喜欢的用户的主页地址）。将获得的ID填入ID Number后面的文本框。

2. Display设置的是显示该用户的哪些图片，以什么方式显示，如图片大小，显示多少张等等。

在侧边栏中添加flickrRSS的Wigdet，应该可以显示图片了。

3. 如果要使用本地缓存功能，勾上Enable the image cache，然后设置下路径：

URL： http://blog.shidelai.cn/wp-content/cache/

Full Path：/home/yourname/domains/soulward.cn/public_html/wp-content/cache

你可以参照一下我的进行设置，如果你装过Gravatar2的话那么打开它的设置面板就可以很容易知道Full Path里面该填什么了。

使用

前面提到，出了能在侧边栏显示图片之外，我们还可以在主题中插入代码使得可以在博客的任意位置显示符合各种要求设定的flickr图片。阿德只简单地在留言框下面显示最新上传的flickr上Tag为’hangzhou’的图片，并且点击图片后是在新窗口打开对应的flickr页面，而不是默认地在本地窗口打开，咱不能让flickr抢了生意不是？。

方法：

1. 在single.php中最后一个</div>前面添加

<ul>
<div class=”flickrtag”>
<li><h3 class=”sidebartitle”>Flickr上的杭州</h3>
<?php get_flickrRSS(9, “community”, “hangzhou”,”square”); ?>
</li>
</div>
<ul>

如有疑问可以参看下我的single.php源码

2. 在style.css中添加

.flickrtag a:active{
text:expression(target=”_blank”);
}

测试下吧，呵呵

当然，你可以发挥自己的想象力，比如最新上传的tag为艳照门的图片阿什么的。关于get_flickrRSS函数的参数和使用例子作者的网站上以及有了，可以参考一下。

Comments

Related posts:

[原文链接：http://blog.delai.me/2008/06/how-to-flickrrss.html] ]]> http://blog.delai.me/2008/06/how-to-flickrrss.html/feed 6 关于本站 http://blog.delai.me/about http://blog.delai.me/about#comments Tue, 06 May 2008 13:29:50 +0000 阿德 http://localhost/wordpress/?page_id=6 基本情况

本站是我的个人博客，于2008年5月创建，目前使用的是wordpress博客系统和Dreamhost主机，关注时事、生活、IT。

自我介绍

施德来，男，浙江温州瑞安人氏，目前是浙江大学计算机学院研二学生。

E-mail：

G-Talk：

MSN：

QQ：84378265

My Google Profile：http://www.google.com/profiles/shidelai

My photostream：http://www.flickr.com/photos/delai

友情链接

本博客渴望与任何合法的网站交换友情链接，请在网站上做好友情链接后在本页面留意或者发E-mail与我联系。

我的链接样式：

名称：阿德日志

网址：http://www.soulward.cn

描述：施德来的个人博客，关注时事、IT、生活、Linux、。

版权声明

无特别说明，本站内容全部为原创，遵循署名-非商业性使用-相同方式共享 2.5的创作共用协议，转载文章请注明 : 阿德日志(htpp://www.soulward.cn)。

Comments

  • 2008-05-24, 徐伟宏 writes: SB
  • 2008-06-10, 朱笑 writes: 不知道留什么~晚安~~
  • 2008-06-13, 刘敏 writes: 未来挨踢就是和我们普通人不一样 是比较高级点~~~~~~~~~~~~~飘过 加油 :lol:
  • 2008-06-13, ade.阿德 writes: 求踢～～
  • 2008-06-15, 星爷 writes: :?: 偶像！ :roll: 坚持
  • 2008-07-1, wang jian writes: :mrgreen: 博客很不错哦,其实你在高一的时候我就知道你是未来挨踢! :smile:
  • 2008-07-2, 阿德.idea writes: :cool: 混口饭吃那，不喜欢也不讨厌。
  • 2008-07-12, 当当 writes: 不支持firefox留言么，在友情链接板块好像提交不上去。。 www.dangdangbook.org 当当网博客
  • 2008-07-15, 阿德.idea writes: 源码出了点问题，在解决当中。不是浏览器问题，已经添加到友情链接了，呵呵。
  • 2008-08-11, Apple writes: 发觉以前对你的了解，有些是错误的。。。
  • 2008-08-25, 毛玉书 writes: :neutral: 来看看 :razz:
  • 2008-08-25, 毛玉书 writes: :neutral:
  • 2008-09-12, 我就不行我搞不定你 | 杂货铺在线 writes: [...] 关于本站 [...]
  • 2008-11-15, HUHU writes: 学计算机的，博客就是不一样，透着一股子专业。
  • 2008-11-17, 阿德Delai writes: 都用WordPress的，有机会可以交流交流 :mrgreen:
  • 2009-01-7, Dan writes: hehe. i work in shanghai liyang crazy english training center now. and i love it. :mrgreen:
  • 2009-01-7, 阿德 writes: U are Niubility！
  • 2009-01-8, Dan writes: thx, man you are awesome, too. you know, i have always wanted to go to zhejiang university and study there. anyway, i still have my dream.
  • 2009-01-8, 阿德 writes: 大哥，饶了我吧， 我英语不行啊～～！
  • 2009-02-10, 7 writes: :eek:
  • 2009-02-12, 硫酸铜小陈 writes: 我想和你交换一下友情链接，我已经把你的博客链接放在首页了，如果你加了的话就邮件回复我吧。 链接样式：硫酸铜小陈 url：http://www.cuso4cym.com gmail：liusuantong@gmail.com qq：385669070@qq.com
  • 2009-02-13, 阿德 writes: :smile: Done
  • 2009-04-18, 乔帮主 writes: 博主你好，申请个友情链接，你的已经做好 :mrgreen: 谢了
  • 2009-04-18, 阿德 writes: Done :mrgreen:
  • 2009-05-2, 乔帮主 writes: :twisted: 我看你也是，很多天不来，啥也不写，然后一来就人品大爆发，一大堆啊，呵呵
  • 2009-05-2, 阿德 writes: 忙啊, 世界各地发生了那么多事情, 伊拉克、伊朗、朝鲜都有一大堆事情要处理。
  • 2009-05-3, 乔帮主 writes: =_=!...
  • 2009-05-15, 乔帮主 writes: Hey，你那校友那事现在情况怎样了?那个富二代有没有被抓起来啊？看着俺就来气 :evil:
  • 2009-05-19, 阿德 writes: 呵呵，应该会被判个几年吧。不过老实说富二代学好的还是比学坏的多的。好事不出门坏事传千里嘛。
  • 2009-07-31, Eli writes: I was not finding ur email address anymore, so I try your blog, very well design I should say, which soft did u use, I hope u get this message and send me ur email so that we can have a real talk.
  • 2009-08-1, 阿德 writes: my email http://blog.shidelai.cn/wp-content/uploads//2008/07/gmail.png I will mail u
  • 2010-01-27, Jire writes: 学长，我的verse-o-matic插件总是出错，没法添加新的语录，网上说要自己改代码的，你是怎么弄滴？？
  • 2010-02-16, 阿德 writes: 直接改数据库，添加几条空记录，要用的时候改成语录就行了
  • 2010-02-25, ecy writes: 呵呵，我是恨少，这几天一直在学习使用WordPress搭建自己的博客，从你这儿学到不少东西 :mrgreen:
  • 2010-02-26, 阿德 writes: 哈哈 :smile: 已经很久没折腾了，多交流~~
  • 2010-04-30, ecy writes: Hi，我是恨少，我想知道你的侧边栏的Flickr相册用的是什么插件，我也想以这样大的图片展示Filckr里面的相片 ^_^
  • 2010-05-5, 阿德 writes:
  • 2010-05-22, appshare writes: 校友，交换一个链接：www.appshare.cn 儿童早教App大全，已经给你做好友情链接了。
  • 2010-06-8, 阿德 writes: Done Thanks for your attention :idea:
  • 2010-07-16, mz writes: 能和你交换友链吗？同样是个人博客 ps.FCCTT 康老大好像也退出了…… http://mengzhuo.org/blog/
  • 2010-07-17, 阿德 writes: Done！他我有印象，我那会儿感觉新进来的人水平越来越差，给我校对的译文真是让人看了很崩溃，加上学校事情多起来也所以就退出了。
  • 2010-09-15, 翎羽志 writes: 不错哟，收藏了。
  • 2010-09-26, Moker writes: 网站挺不错的，风格很喜欢。能换了链接交个朋友不？ 墨客草屋：http://www.meiwenzhang.com/blog
  • 2010-10-30, 澄清 writes: 友情链接的点着点着就碰到校友了，俺10年本科软件工程毕业的。 :mrgreen:
  • 2010-11-3, 阿德 writes: :lol:
  • 2010-11-5, 阿德 writes: 已经做好了~~~ :lol:
  • 2011-07-15, youttiao writes: 校友啊！ 我09CS
  • 2011-10-4, 阿德 writes: ^_^~~
[原文链接：http://blog.delai.me/about] ]]> http://blog.delai.me/about/feed 48