描述
注册卸载钩子,当用户单击调用插件卸载自身的卸载链接时将调用该挂钩。除非插件钩住动作,否则链接不会激活。
注册卸载挂钩时,插件不应在函数之外运行任意代码。为了使用钩子运行,插件必须包含在内,这意味着在卸载过程中,任何放置在函数外部的代码都将运行。插件不应妨碍卸载过程。
如果没有在插件中运行代码就无法编写插件,那么插件应该创建一个名为“uninstall.php”的文件。在基本插件文件夹中。如果该文件存在,则在卸载过程中将绕过卸载挂钩调用该文件。当插件使用“uninstall.php”时,在执行之前应始终检查‘WP_UNINSTALL_PLUGIN’常量。
参数
- $file
-
(string)(必填) 插件文件。
- $callback
-
(callable)(必填) 调用挂钩时要运行的回调。必须是静态方法或函数。
源码
更新日志
版本 | 描述 |
---|---|
2.7.0 | 开始引入 |
使用示例
在register_activation_hook内执行卸载挂钩
function your_prefix_activate(){ register_uninstall_hook( __FILE__, 'your_prefix_uninstall' ); } register_activation_hook( __FILE__, 'your_prefix_activate' ); // And here goes the uninstallation function: function your_prefix_uninstall(){ // codes to perform during unistallation }