编辑“WordPress:Writing a Plugin”（章节）

== 规划你的插件 ==

现在是该让你的插件做些什么的时候了。这个部分包含了一些一般的关于插件开发的思想，描述了如何完成你的插件需要完成的几个任务。

=== WordPress 插件 Hooks ===

很多插件通过连接一个或者多个的WordPress 插件 "hooks"来完成它们的目标。 插件hooks的工作方式是在WordPress运行的时候，在各个不同的时候，WordPress检查是否有插件在那时有注册过的函数在此刻运行，如果有的话，函数运行。三个函数更改WordPress的默认行为。

例如，在WordPress添加文章标题到浏览器输出的时候，首先检查是否有任何插件为"filter"hook注册了一个函数叫做"the_title"。如果有，标题文字会被每个注册函数按顺序传递，最终结果就是打印出来的结果。这样，如果你的插件需要添加一些信息到打印标题，它可以注册一个"the_title" filter函数.

另一个例子是"action" hook，叫做"wp_footer"。在WordPress生成的HTML页面的底部，它检查看是否某个插件已经为 "wp_footer" action hook注册函数，然后依次运行。

你可以了解更多关于如何为filter 和 action hooks注册函数，什么插件hooks在WordPress和在[[WordPress:Plugin API|插件API]]中可用。如果你在WordPress代码中发现一个你想使用action或者filter的地方，但是WordPress没有，你可以建议使用新的hooks (建议通常都会被采纳); 如何建议参见[[WordPress:Reporting Bugs|提交错误]]。

=== 模板标签 ===

另外一种用插件添加WordPress功能的方法是通过建立自定义 [[WordPress:Template Tags|模板标签]]。有人想使用你的插件添加这些 "标签"到他们的主题，边栏，文章目录或者其他任何合适的地方。例如，添加地理标签到文章中的插件，可以为边栏定义一个叫做<tt>geotag_list_states()</tt>的模板标签函数，列出所有的有关国家，并带有国家归档页面的链接。

想要定义一个模板标签，需要简单的写一个PHP 函数并为插件用户在插件主页或者是插件PHP主文件中写下资料说明。在给函数做资料说明时，给出一个具体需要加入什么到主题文件中以使用函数的例子是个不错的想法包括 <tt><?php</tt> 和 <tt>?></tt>.

===保持插件数据到数据库===

大多数插件需要从站长或者blog用户得到一些信息并保存在sessions中，为了在它的filter 函数, action 函数和模板函数中使用。这个信息必须保存在WordPress 数据库中，为了在sessions中可以持久稳定。有两种基本方法可以保存插件数据到数据库中:
# 使用WordPress "操作"机制(下有描述)。这个方法适合储存相关的小量静态的指定的数据 – 那种你希望在第一次设置插件时站长输入的，今后几乎不会更改的数据。
# 创建一个新的自定义的数据库表格。这种方法适合联合单独的文章，页面，附件或者评论的数据—一种随着时间而增加的，没有单独的名字的数据。参见 [[WordPress:Creating Tables with Plugins|创建插件表格]].

=== WordPress 操作机制===

参见[[WordPress:Creating Options Pages|创建操作页面]] 得到关于如何创建自动为你保存操作的页面的信息。

WordPress有一个保存，更新，重新得到个体， 制定的数据("操作")机制，在 WordPress 数据库中。操作值可以是字符串，数组或者是PHP对象(它们将被 "连载"，或者在存储前转变为字符串，在重新得到个体时反连载)。操作名字是字符串，它们必须是唯一的，这样它们不会与其他 WordPress或者是插件起冲突。

这里是你的插件可以用来进入WordPress操作的主要函数。

<pre>
add_option($name, $value, $description, $autoload);
</pre>
: 创建一个新选项;如果选项存在就什么都不做
;$name: Required (string). 将被添加的选项名字
;$value: Optional (string), 默认为空的字符串。 将被存储的选项值
;$description: Optional (string), 默认为空的字符串。选项的描述，被放在wordpress数据库中以防某些人浏览数据库去看选项在哪。
;$autoload: 选项，默认为'yes' (enum: 'yes' or 'no').如果设置为'yes',那么设置被<tt>get_alloptions</tt>函数自动检索。
<pre>
get_option($option);
</pre>
: 从数据库中检索一个选项值
;$option: Required (string).  你想要返回的选项值的选项的名称。你能够找到被安装在[[WordPress:Option Reference|相关选项]]中的一列默认选项
<pre>
update_option($option_name, $newvalue);
</pre>
: 在数据库里更新或者创建一个选项值（注：如果你不想使用<tt>$description</tt> 或者 <tt>$autoload</tt>参数，<tt>add_option</tt>就没必要被访问。)
;$option_name: Required (string). 选项名称更新。
;$newvalue: Required.  为选项赋予新的值。

=== 管理面板 ===

假设你的插件有一些操作存储在WordPress数据库中 (参见上面的部分)，你也许希望有一个管理面板，允许你的插件用户来查看和编辑操作。方法可以在 [[WordPress:Adding Administration Menus|添加管理目录]]中找到。
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*