register_activation_hook( string $file, callable $function )

为插件设置激活挂钩。
Set the activation hook for a plugin.

说明（Description）

当插件被激活时，将调用activate_PLUGINNAME钩子。在这个钩子的名称中，plugin name被替换为插件的名称，包括可选的子目录。例如，当插件位于wp content/plugins/sampleplugin中时/示例.php，则此钩子的名称将变为“activateu sampleplugin”/示例.php’.

当插件只包含一个文件并且（默认情况下）位于wp content/plugins时/示例.php这个钩子的名字是'activate_示例.php’.

参数（Parameters）

返回（Return）

源码（Source）

/**
 * Set the activation hook for a plugin.
 *
 * When a plugin is activated, the action 'activate_PLUGINNAME' hook is
 * called. In the name of this hook, PLUGINNAME is replaced with the name
 * of the plugin, including the optional subdirectory. For example, when the
 * plugin is located in wp-content/plugins/sampleplugin/sample.php, then
 * the name of this hook will become 'activate_sampleplugin/sample.php'.
 *
 * When the plugin consists of only one file and is (as by default) located at
 * wp-content/plugins/sample.php the name of this hook will be
 * 'activate_sample.php'.
 *
 * @since 2.0.0
 *
 * @param string   $file     The filename of the plugin including the path.
 * @param callback $function The function hooked to the 'activate_PLUGIN' action.
 */
function register_activation_hook($file, $function) {
	$file = plugin_basename($file);
	add_action('activate_' . $file, $function);
}

笔记（Notes）