有三个不同的钩子。它们在以下情况下触发：
如何在场景中安全触发功能
下面显示了正确挂钩在上述操作期间触发的回调函数的正确方法。
因为您可以在使用以下代码的插件中使用此代码
我将展示三个不同的演示插件，您可以检查它们，然后在自己的插件中实施代码。
提前重要提示！
由于该主题非常困难且非常详细，并且有十几个极端案例，因此该答案永远不会是完美的。我会随着时间的推移不断改进它，因此请定期检查。
（1）激活/停用/卸载插件。
插件设置回调由core触发，您对core的执行方式没有影响。有一些事情要记住：
echo/print在安装回调过程中，从不，任何（！）。这将导致出现headers already sent消息，核心将建议停用并删除您的插件...不要问：我知道...- 您将看不到任何视觉输出。但是我
exit()在所有不同的回调中添加了语句，以便您可以了解实际发生的情况。只需取消注释即可看到工作正常。
- 检查是否
__FILE__ != WP_PLUGIN_INSTALL和（如果不是：中止！）以查看是否确实在卸载插件，这一点非常重要。我建议仅on_deactivation()在开发过程中触发回调，这样可以节省您将所有内容恢复原状的时间。至少这是我要做的。
- 我也做一些安全工作。有些也是由核心完成的，但是，嘿！安全胜过遗憾！。
- 首先，当内核未加载时，我不允许直接文件访问：
defined( 'ABSPATH' ) OR exit;
- 然后检查是否允许当前用户执行此任务。
- 作为最后一项任务，我检查引荐来源。注意：当您收到错误消息时，可能会出现意外的结果，
wp_die()要求您提供适当权限的屏幕（如果要再次尝试... 是的，请确保）。这种情况为核心您重定向，设置当前$GLOBALS['wp_list_table']->current_action();要error_scrape，然后检查引荐的check_admin_referer('plugin-activation-error_' . $plugin);，这里$plugin是$_REQUEST['plugin']。因此，重定向发生在页面加载量的一半时，您将获得此有线滚动条，并且die屏幕会看到黄色的管理员通知/消息框。如果发生这种情况：请保持冷静，并通过一些exit()逐步调试来查找错误。
（A）普通功能插件
请记住，如果在函数定义之前挂接了回调，这可能不起作用。
<?php
defined( 'ABSPATH' ) OR exit;
/**
* Plugin Name: (WCM) Activate/Deactivate/Uninstall - Functions
* Description: Example Plugin to show activation/deactivation/uninstall callbacks for plain functions.
* Author: Franz Josef Kaiser/wecodemore
* Author URL: http://unserkaiser.com
* Plugin URL: http://wordpress.stackexchange.com/questions/25910/uninstall-activate-deactivate-a-plugin-typical-features-how-to/25979#25979
*/
function WCM_Setup_Demo_on_activation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "activate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
function WCM_Setup_Demo_on_deactivation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "deactivate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
function WCM_Setup_Demo_on_uninstall()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
check_admin_referer( 'bulk-plugins' );
// Important: Check if the file is the one
// that was registered during the uninstall hook.
if ( __FILE__ != WP_UNINSTALL_PLUGIN )
return;
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
register_activation_hook( __FILE__, 'WCM_Setup_Demo_on_activation' );
register_deactivation_hook( __FILE__, 'WCM_Setup_Demo_on_deactivation' );
register_uninstall_hook( __FILE__, 'WCM_Setup_Demo_on_uninstall' );
（B）基于类/ OOP架构
这是当今插件中最常见的示例。
<?php
defined( 'ABSPATH' ) OR exit;
/**
* Plugin Name: (WCM) Activate/Deactivate/Uninstall - CLASS
* Description: Example Plugin to show activation/deactivation/uninstall callbacks for classes/objects.
* Author: Franz Josef Kaiser/wecodemore
* Author URL: http://unserkaiser.com
* Plugin URL: http://wordpress.stackexchange.com/questions/25910/uninstall-activate-deactivate-a-plugin-typical-features-how-to/25979#25979
*/
register_activation_hook( __FILE__, array( 'WCM_Setup_Demo_Class', 'on_activation' ) );
register_deactivation_hook( __FILE__, array( 'WCM_Setup_Demo_Class', 'on_deactivation' ) );
register_uninstall_hook( __FILE__, array( 'WCM_Setup_Demo_Class', 'on_uninstall' ) );
add_action( 'plugins_loaded', array( 'WCM_Setup_Demo_Class', 'init' ) );
class WCM_Setup_Demo_Class
{
protected static $instance;
public static function init()
{
is_null( self::$instance ) AND self::$instance = new self;
return self::$instance;
}
public static function on_activation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "activate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public static function on_deactivation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "deactivate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public static function on_uninstall()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
check_admin_referer( 'bulk-plugins' );
// Important: Check if the file is the one
// that was registered during the uninstall hook.
if ( __FILE__ != WP_UNINSTALL_PLUGIN )
return;
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public function __construct()
{
# INIT the plugin: Hook your callbacks
}
}
（C）具有外部设置对象的基于类/ OOP的体系结构
此方案假定你有一个主要的插件文件并命名第二个文件setup.php中指定的插件的子目录inc：~/wp-content/plugins/your_plugin/inc/setup.php。当plugin文件夹不在默认WP文件夹结构之外时，这也将起作用，当内容目录被重命名时，或者在您的安装文件被命名为不同的情况下，这也将起作用。inc相对于插件根目录，仅该文件夹必须具有相同的名称和位置。
注意：您可以简单地使用这三个register_*_hook()*函数和类并将它们放入插件中。
主插件文件：
<?php
defined( 'ABSPATH' ) OR exit;
/**
* Plugin Name: (WCM) Activate/Deactivate/Uninstall - FILE/CLASS
* Description: Example Plugin
* Author: Franz Josef Kaiser/wecodemore
* Author URL: http://unserkaiser.com
* Plugin URL: http://wordpress.stackexchange.com/questions/25910/uninstall-activate-deactivate-a-plugin-typical-features-how-to/25979#25979
*/
register_activation_hook( __FILE__, array( 'WCM_Setup_Demo_File_Inc', 'on_activation' ) );
register_deactivation_hook( __FILE__, array( 'WCM_Setup_Demo_File_Inc', 'on_deactivation' ) );
register_uninstall_hook( __FILE__, array( 'WCM_Setup_Demo_File_Inc', 'on_uninstall' ) );
add_action( 'plugins_loaded', array( 'WCM_Setup_Demo_File', 'init' ) );
class WCM_Setup_Demo_File
{
protected static $instance;
public static function init()
{
is_null( self::$instance ) AND self::$instance = new self;
return self::$instance;
}
public function __construct()
{
add_action( current_filter(), array( $this, 'load_files' ), 30 );
}
public function load_files()
{
foreach ( glob( plugin_dir_path( __FILE__ ).'inc/*.php' ) as $file )
include_once $file;
}
}
设置文件：
<?php
defined( 'ABSPATH' ) OR exit;
class WCM_Setup_Demo_File_Inc
{
public static function on_activation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "activate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public static function on_deactivation()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
$plugin = isset( $_REQUEST['plugin'] ) ? $_REQUEST['plugin'] : '';
check_admin_referer( "deactivate-plugin_{$plugin}" );
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
public static function on_uninstall()
{
if ( ! current_user_can( 'activate_plugins' ) )
return;
check_admin_referer( 'bulk-plugins' );
// Important: Check if the file is the one
// that was registered during the uninstall hook.
if ( __FILE__ != WP_UNINSTALL_PLUGIN )
return;
# Uncomment the following line to see the function in action
# exit( var_dump( $_GET ) );
}
}
（2）插件更新
如果编写的插件具有自己的数据库表或选项，则在某些情况下可能需要更改或升级。
遗憾的是，到目前为止，无法在插件/主题安装或更新/升级上运行某些东西。很高兴有一个解决方法：将自定义函数挂接到自定义选项（是的，这很la脚-但它可以工作）。
function prefix_upgrade_plugin()
{
$v = 'plugin_db_version';
$update_option = null;
// Upgrade to version 2
if ( 2 !== get_option( $v ) )
{
if ( 2 < get_option( $v ) )
{
// Callback function must return true on success
$update_option = custom_upgrade_cb_fn_v3();
// Only update option if it was an success
if ( $update_option )
update_option( $v, 2 );
}
}
// Upgrade to version 3, runs just after upgrade to version 2
if ( 3 !== get_option( $v ) )
{
// re-run from beginning if previous update failed
if ( 2 < get_option( $v ) )
return prefix_upgrade_plugin();
if ( 3 < get_option( $v ) )
{
// Callback function must return true on success
$update_option = custom_upgrade_cb_fn_v3();
// Only update option if it was an success
if ( $update_option )
update_option( $v, 3 );
}
}
// Return the result from the update cb fn, so we can test for success/fail/error
if ( $update_option )
return $update_option;
return false;
}
add_action('admin_init', 'prefix_upgrade_plugin' );
资源
此更新功能不是一个很好/写得很好的示例，但是如前所述：这是一个示例，该技术效果很好。在以后的更新中将对此进行改进。
