编辑“WordPress:Function Reference/register activation hook”

The function <strong>register_activation_hook</strong> (introduced in WordPress 2.0) registers a plugin function to be run [[WordPress:Managing_Plugins#Plugin_Installation|when the plugin is activated]].

函数<strong>register_activation_hook</strong>（在WordPress2.0时引进）注册了一个插件函数，[[WordPress:Managing_Plugins#Plugin_Installation|插件激活时]]，函数就会运行。

This is easier than using the <tt>activate_<var>pluginname</var></tt> action.

这比使用<tt>activate_<var>pluginname</var></tt> action要简单。

== Usage and parameters ==

== 用法和参数 ==

%%% <?php register_activation_hook($file, $function); ?> %%%

%%% <?php register_activation_hook($file, $function); ?> %%%

; <var>$file</var>
; <var>$file</var>
:	(string) Path to the [[WordPress:Writing_a_Plugin#Plugin_Files|main plugin file]] inside the <tt>wp-content/plugins</tt> directory. A full path will work.

:	(string) <tt>wp-content/plugins</tt>目录中[[WordPress:Writing_a_Plugin#Plugin_Files|主要的插件文件]]的路径。全称路径能够运行。

; <var>$function</var>
; <var>$function</var>
:	(callback) The function to be run when the plugin is activated. Any of [http://us2.php.net/manual/en/language.pseudo-types.php#language.types.callback PHP's callback pseudo-types] will work.

:	(callback)插件激活时，将要运行的函数。任何[http://us2.php.net/manual/en/language.pseudo-types.php#language.types.callback PHP's callback pseudo-types]都会运行。

== Examples ==

== 例子 ==

If you have a function called <tt>myplugin_activate()</tt> in the [[WordPress:Writing_a_Plugin#Plugin_Files|main plugin file]] at either 
*	<tt>wp-content/plugins/<var>myplugin</var>.php</tt> or
*	<tt>wp-content/plugins/<var>myplugin</var>/<var>myplugin</var>.php</tt>
use this code:
 register_activation_hook( __FILE__, 'myplugin_activate' );

如果你在*	<tt>wp-content/plugins/<var>myplugin</var>.php</tt> 或者
*	<tt>wp-content/plugins/<var>myplugin</var>/<var>myplugin</var>.php</tt>中的[[WordPress:Writing_a_Plugin#Plugin_Files|主要插件文件]]中有个函数称作<tt>myplugin_activate()</tt>
使用这个代码：
register_activation_hook( __FILE__, 'myplugin_activate' );

This will call the <tt>myplugin_activate()</tt> function on activation of the plugin. This is a more reliable method than using the <tt>activate_<var>pluginname</var></tt> action.

这样插件一激活，就会调用<tt>myplugin_activate()</tt>函数。这个方法比使用<tt>activate_<var>pluginname</var></tt> action更可靠。

See also [[WordPress:Function_Reference/register_deactivation_hook|register_deactivation_hook]]
也看看[[WordPress:Function_Reference/register_deactivation_hook|register_deactivation_hook]]