do_action( 'add_site_option', string $option, mixed $value, int $network_id )
操作挂钩:在成功添加网络选项后激发。
Action Hook: Fires after a network option has been successfully added.
目录锚点:#参数#源码
参数 | 类型 | 说明 |
$option |
(string) |
网络选项的名称。 |
$value |
(mixed) |
网络选项的值。 |
$network_id |
(int) |
网络的ID。 |
/**
* Add a new site option.
*
* Existing options will not be updated. Note that prior to 3.3 this wasn't the case.
*
* @since 2.8.0
*
* @see add_option()
*
* @global wpdb $wpdb
*
* @param string $option Name of option to add. Expected to not be SQL-escaped.
* @param mixed $value Optional. Option value, can be anything. Expected to not be SQL-escaped.
* @return bool False if option was not added and true if option was added.
*/
function add_site_option( $option, $value ) {
global $wpdb;
wp_protect_special_option( $option );
/**
* Filter the value of a specific site option before it is added.
*
* The dynamic portion of the hook name, `$option`, refers to the option name.
*
* @since 2.9.0 As 'pre_add_site_option_' . $key
* @since 3.0.0
*
* @param mixed $value Value of site option.
*/
$value = apply_filters( 'pre_add_site_option_' . $option, $value );
$notoptions_key = "{$wpdb->siteid}:notoptions";
if ( !is_multisite() ) {
$result = add_option( $option, $value );
} else {
$cache_key = "{$wpdb->siteid}:$option";
// Make sure the option doesn't already exist. We can check the 'notoptions' cache before we ask for a db query
$notoptions = wp_cache_get( $notoptions_key, 'site-options' );
if ( ! is_array( $notoptions ) || ! isset( $notoptions[$option] ) )
if ( false !== get_site_option( $option ) )
return false;
$value = sanitize_option( $option, $value );
$serialized_value = maybe_serialize( $value );
$result = $wpdb->insert( $wpdb->sitemeta, array('site_id' => $wpdb->siteid, 'meta_key' => $option, 'meta_value' => $serialized_value ) );
if ( ! $result )
return false;
wp_cache_set( $cache_key, $value, 'site-options' );
// This option exists now
$notoptions = wp_cache_get( $notoptions_key, 'site-options' ); // yes, again... we need it to be fresh
if ( is_array( $notoptions ) && isset( $notoptions[$option] ) ) {
unset( $notoptions[$option] );
wp_cache_set( $notoptions_key, $notoptions, 'site-options' );
}
}
if ( $result ) {
/**
* Fires after a specific site option has been successfully added.
*
* The dynamic portion of the hook name, `$option`, refers to the option name.
*
* @since 2.9.0 As "add_site_option_{$key}"
* @since 3.0.0
*
* @param string $option Name of site option.
* @param mixed $value Value of site option.
*/
do_action( "add_site_option_{$option}", $option, $value );
/**
* Fires after a site option has been successfully added.
*
* @since 3.0.0
*
* @param string $option Name of site option.
* @param mixed $value Value of site option.
*/
do_action( "add_site_option", $option, $value );
return true;
}
return false;
}
更新版本 |
源码位置 |
使用 |
被使用 |
4.7.0 |
wp-includes/option.php:1454 |
1 |
0 |
do_action( 'activated_plugin', string $plugin, bool $network_wide )动作钩子::插件激活后激发。Action Hook: Fires after a plugin has been activated.目录锚点:#说明#参数#源码#笔记说明(Description)如果插件被静默激活(例如在更新期间),则不会触发此挂钩。参数(Parameters)参数类型说明 $plugin ...
日期:2020-07-26 13:19:04
浏览:541
do_action( 'activate_blog', string $id )动作钩子::在网络站点激活后激发。Action Hook: Fires after a network site is activated.目录锚点:#参数#源码参数(Parameters)参数类型说明 $id (string) 激活站点的ID。 源码(Source)更新版本源码位置使用被使用MU (3.0.0) w...
日期:2020-07-26 13:19:03
浏览:790
do_action( 'activate_header' )操作挂钩:在加载网站激活页之前激发。Action Hook: Fires before the Site Activation page is loaded.目录锚点:#源码#笔记源码(Source)更新版本源码位置使用被使用3.0.0 wp-activate.php:7900笔记(Notes)在wp中定义了activate_header hook-激活.php包含主题的文件header.php文件但不是函数.php文件。因此,如果在主题的函数.p...
日期:2020-07-26 13:19:04
浏览:736
do_action( 'activate_wp_head' )操作挂钩:在加载网站激活页之前激发。Action Hook: Fires before the Site Activation page is loaded.目录锚点:#说明#源码说明(Description)对“wp_head”动作开火。源码(Source)更新版本源码位置使用被使用3.0.0 wp-activate.php:9610...
日期:2020-07-26 13:19:04
浏览:940
do_action( "activate_{$plugin}", bool $network_wide )动作钩子::当一个特定的插件被激活时触发。Action Hook: Fires as a specific plugin is being activated.目录锚点:#说明#参数#源码说明(Description)这个钩子是register_activation_hook()内部使用的“activation”钩子。钩子名$plugin的动态部分引用了plugin basename。参数(Param...
日期:2020-07-26 13:19:03
浏览:891
do_action( 'activity_box_end' )动作钩子::在“一目了然”仪表板小部件的末尾触发。Action Hook: Fires at the end of the ‘At a Glance’ dashboard widget.目录锚点:#说明#源码说明(Description)在3.8.0之前,小部件被命名为“立即”。源码(Source)更新版本源码位置使用被使用2.0.0 wp-admin/includes/dashboard.php:40110...
日期:2020-07-26 13:19:04
浏览:508
do_action( 'added_existing_user', int $user_id, true|WP_Error $result )操作挂钩:在现有用户添加到站点后立即激发。Action Hook: Fires immediately after an existing user is added to a site.目录锚点:#参数#源码参数(Parameters)参数类型说明 $user_id (int) ...
日期:2020-09-02 17:44:23
浏览:516
do_action( 'added_option', string $option, mixed $value )动作钩子::在添加选项后激发。Action Hook: Fires after an option has been added.目录锚点:#参数#源码参数(Parameters)参数类型说明 $option (string) 添加的选项的名称。 ...
日期:2020-08-29 11:56:53
浏览:698
do_action( 'added_term_relationship', int $object_id, int $tt_id, string $taxonomy )动作钩子::在添加对象项关系后立即激发。Action Hook: Fires immediately after an object-term relationship is added.目录锚点:#参数#源码参数(Parameters)参数类型说明 $object_id ...
日期:2020-09-02 17:44:14
浏览:712
do_action( 'added_usermeta' )动作钩:Action Hook: 目录锚点:#源码源码(Source)更新版本源码位置使用被使用 wp-includes/deprecated.php:240800...
日期:2020-09-02 17:44:27
浏览:729