Codex tools: Log in
Languages: English • 日本語 • Русский • 中文(简体) • (Add your language)
Contents |
允许你对WordPress博客进行修改,自定义,和加强. 不必修改WordPress的核心程序, 直接用插件的形式增加功能。下面是对WordPress插件的基本定义：
WordPress Plugin:WordPress插件是用PHP 语言写成的一只或者一组程序。这些程序可以为Wordpress增加某些原来没有的功能，这样使用者看起来仿佛就是这个博客固有的功能。 Plugin Application Program Interface (API).
想为你的博客添加功能吗？那么最简单的方法就是搜搜看有没有现成的插件。如果很不幸——没有，那么这篇文章会指导你自己开发一个。
本文假设你已经把该会的全学会了——比如HTML，比如PHP之类的。
这个部分告诉你怎么把开发插件的理想变为现实。
你得先想一个名字，并且努力让它独一无二。在 Plugins 或者其他宝贝地方——Google或者百度先验证一下这个名字到底是不是独一无二的。另外你的名字得让别人明白你的插件是干什么的。
下一步是创建一个PHP文件。按照原文奇怪的逻辑，你得先想好名字。这个名字还得是从插件名衍生过来的（其实是为你自己辨认的）。举个例子吧，比如说你的插件名字叫 "Fabulous Functionality",你的PHP名字可能是 fabfunc.php。另外不要用汉语拼音（这也是我加的），还要避免重名。人民群众会把你的插件安装到一个你也知道的叫wp-content/plugins/的地方,如果名字冲突岂不要悲剧了。
你也可以选择把插件分割成几个文件。 显而易见一个php文件是必需的，同时还需要图片、CSS、JavaScript、语言（当然也可以没有）。如果有很多文件，命名一个php和一个文件夹，例如 fabfunc and fabfunc.php。把你所有插件文件放到文件夹里，然后让你的用户相信只要把你的整个压缩包解压到 wp-content/plugins/就能正常使用你的劳动成果。
In the rest of this article, "the Plugin PHP file" refers to the main Plugin PHP file, whether in wp-content/plugins/ or a sub-directory.
如果你想将你的插件发布到http://wordpress.org/extend/plugins/, 你必须在插件包中建立一个标准格式readme.txt文件. 文件格式参见http://wordpress.org/extend/plugins/about/readme.txt.
最好为插件建立一个主页，以介绍插件的功能、安装方法、使用说明、适用的WordPress版本、插件更新信息等。
现在开始吧，首先让我们从向PHP主文件中加入一些信息
插件的主文件顶部必须包括一个标准插件信息头。WordPress通过标准信息头识别插件的存在，并把她加入到控制面板的插件管理页面，这样插件才能激活，载入插件，并运行里面的函数；如果没有信息头，插件将无法激活和使用。标准信息插件头的格式为：
<?php /* Plugin Name: 插件名称 Plugin URI: http://URI_Of_Page_Describing_Plugin_and_Updates Description: 插件的简单卖哦是 Version: 插件版本号, 例如: 1.0 Author: 插件作者 Author URI: http://URI_Of_The_Plugin_Author作者地址 */ ?>
标准信息头至少要包括插件名称，这样WordPress才能识别你的插件。其他信息将显示在控制面板插件管理页面中。标准插件信息对各行顺序没有要求。
通常我们还要在标准信息头中加入插件的许可证信息。大多数插件使用GPL或GPLCompatibleLicenses许可。如果使用GPL许可，要求插件中包含以下信息：
<?php
/* Copyright 年份 作者名 (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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
?>
现在是时候让你的插件能干些什么了。这部分内容包括插件开发的一般思路，而且介绍了开发插件需要做哪些工作。
许多WordPress插件通过连接一个或多个WordPress插件钩子来完成他们的功能。插件钩子的运行机理是，当WordPress运行到不同阶段，WordPress会检查当前阶段是否注册了插件函数，如果是，那么函数将被执行。通过执行插件函数改变了WordPress的默认功能。
例如，在WordPress将日志标题和post发送到浏览器前，会检查是否有插件函数注册了名为“the_title”的“filter”钩子。如果是，标题文本将会传送到注册函数中，注册函数返回值将会传送到浏览器。所以，如果要在日志标题中加入一些信息，可以通过这种方式实现。
另一个例子是名为“wp_footer”的“action”钩子。在WordPress的HTML页脚创建之前，会检查是否有插件注册了名为“wp_footer”的“action”钩子，如果是依次执行她们。
在Plugin API了解更多如何注册“filter”和“action”类型的钩子函数，及WordPress提供了那些插件钩子。如果你发现WordPress没有提供自己想要的钩子，你可以建议WordPress加入这个钩子，很多建议WordPress都会采纳。具体方法参考Reporting Bugs。
另一个通过插件加入新功能的方法是建立自定义的模版标签Template Tags。如果有人想用你的插件，可以在他们的主题中添加这些标签，边栏，文章内容段，或者任意的只要是适合这插件的地方。例如，一个给文章添加地理位置的插件可能定义了一个模板标签函数geotag_list_states()放在边栏上，这里列表了所有在文章中关联的州的名称，并且还带有插件提供的到这些州的文档页的链接。
定义一个自定义模板标签，仅需要写一个PHP函数，并且在你插件主页或者插件的主PHP文件中声明一下。声明函数的时候，为这个函数提供一个示例来明确如果想要应用这个函数需要加主题中加些什么文件是个相当棒的主意。
大多数WordPress插件需要站点的所有者或者是博客的用户输入信息，然后在对话过程中保存起来，以便过滤器函数(filter)、动作函数(action)或者模板函数(Template)使用。这些信息必须保存在WordPress的数据库中，以便下次使用。这里有两种基本的方法用于保存插件的信息到数据库里面。
1.使用WordPress的"option"机制（稍后会有介绍）。这种方法适合于保存一些相对小数量的静态命名类数据--这类数据通常只需要网站的所有者在首次建立插件的时候输入，以后很少改动。
2.文章属性post meta(a.k.a. Custom Fields)，适用于那些只和个人文章、页面或者附件有关的数据。
参看post_meta Function Examples, add_post_meta(), 以及与文章相关函数属性post.fuction meta (a.k.a. Custom Fields).
在数据库中创建一个新的自定义数据表。这种方法适合于与个人文章、页面、附件或者评论相关的数据，这类数据会随着时间越来越多，它们也没有专有名称。参看Creating Tables with Plugins来了解更多这类信息处理方法。
参看 Creating Options Pages 得到更多如何创建会自动保存你选项数据的页面。
WordPress拥有一个机制来保存，更新和检索WordPress数据库中专用，名称类数据(即"options"机制)。选项值可以是字符，数组或PHP对象(他们会被"序列化"，或在存储前转换为字符，并在被检索时解开序列)。选项名称是字符，并且它们必须是独一无二的，这样就不会与其它的WordPress插件相冲突。
这里是你的插件应用WordPress option功能的主要函数。
add_option($name, $value, $deprecated, $autoload);
get_option($option);
update_option($option_name, $newvalue);
假定你的插件有一些选项(option)存储于WordPress的数据库中(参看上一节),你可能会想要一个主控面板来允许你的插件用户查看和编辑选项值。实现这一目标的方法阐述于Adding Administration Menus。
Once you have the programming for your Plugin done, another consideration (assuming you are planning on distributing your Plugin) is internationalization. Internationalization is the process of setting up software so that it can be localized; localization is the process of translating text displayed by the software into different languages. WordPress is used all around the world, so it has internationalization and localization built into its structure, including localization of Plugins.
It is highly recommended that you internationalize your Plugin, so that users from different countries can localize it. There is a comprehensive reference on internationalization, including a section describing how to internationalize your plugin, at I18n for WordPress Developers.
This last section contains some random suggestions regarding Plugin development.
