WordPress: Function Reference/register activation hook：修订间差异

来自站长百科
跳转至： 导航、​ 搜索
无编辑摘要
无编辑摘要
 
第1行： 第1行：
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|插件激活时]]，函数就会运行。
函数<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要简单。
这比使用<tt>activate_<var>pluginname</var></tt> action要简单。
== Usage and parameters ==


== 用法和参数 ==
== 用法和参数 ==
%%% <?php register_activation_hook($file, $function); ?> %%%


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


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


; <var>$function</var>
; <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]都会运行。
: (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>.php</tt> 或者
* <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>
* <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' );
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更可靠。
这样插件一激活，就会调用<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]]
也看看[[WordPress:Function_Reference/register_deactivation_hook|register_deactivation_hook]]

2008年7月26日 (六) 17:14的最新版本

函数register_activation_hook（在WordPress2.0时引进）注册了一个插件函数，插件激活时，函数就会运行。

这比使用activate_pluginname action要简单。

用法和参数[ ]

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

$file
(string) wp-content/plugins目录中主要的插件文件的路径。全称路径能够运行。
$function
(callback)插件激活时，将要运行的函数。任何PHP's callback pseudo-types都会运行。

例子[ ]

如果你在下面

  • wp-content/plugins/myplugin.php 或者
  • wp-content/plugins/myplugin/myplugin.php中的主要插件文件中有个函数称作myplugin_activate()

使用这个代码： register_activation_hook( __FILE__, 'myplugin_activate' );

这样插件一激活，就会调用myplugin_activate()函数。这个方法比使用activate_pluginname action更可靠。

也看看register_deactivation_hook

取自“https://www.zzbaike.com/wiki/index.php?title=WordPress:Function_Reference/register_activation_hook&oldid=7172”