Aggiorna il valore di un'opzione di rete già aggiunta.

Descrizione

Vedere anche

  • update_option()

Parametri

$network_id

(int)(Richiesto)ID della rete. Può essere nullo per impostare l'ID della rete corrente.

$opzione

(stringa)(Richiesto)Nome dell'opzione. Si suppone che non sia in formato SQL.

$valore

(misto)(Richiesto)Valore dell'opzione. Si prevede che non sia SQL-escaped.

Ritorno

(bool) Vero se il valore è stato aggiornato, falso altrimenti.

Fonte

File: wp-includes/option.php

functionupdate_network_option($network_id,$option,$value){global$wpdb;if($network_id&&!is_numeric($network_id)){returnfalse;}$network_id=(int)$network_id;// Fallback to the current network if a network ID is not specified.if(!$network_id){$network_id=get_current_network_id();}wp_protect_special_option($option);$old_value=get_network_option($network_id,$option,false);/**
	 * Filters a specific network option before its value is updated.
	 *
	 * The dynamic portion of the hook name, `$option`, refers to the option name.
	 *
	 * @since 2.9.0 As 'pre_update_site_option_' . $key
	 * @since 3.0.0
	 * @since 4.4.0 The `$option` parameter was added.
	 * @since 4.7.0 The `$network_id` parameter was added.
	 *
	 * @param mixed  $value      New value of the network option.
	 * @param mixed  $old_value  Old value of the network option.
	 * @param string $option     Option name.
	 * @param int    $network_id ID of the network.
	 */$value=apply_filters("pre_update_site_option_{$option}",$value,$old_value,$option,$network_id);/*
	 * If the new and old values are the same, no need to update.
	 *
	 * Unserialized values will be adequate in most cases. If the unserialized
	 * data differs, the (maybe) serialized data is checked to avoid
	 * unnecessary database calls for otherwise identical object instances.
	 *
	 * See https://core.trac.wordpress.org/ticket/44956
	 */if($value===$old_value||maybe_serialize($value)===maybe_serialize($old_value)){returnfalse;}if(false===$old_value){returnadd_network_option($network_id,$option,$value);}$notoptions_key="$network_id:notoptions";$notoptions=wp_cache_get($notoptions_key,'site-options');if(is_array($notoptions)&&isset($notoptions[$option])){unset($notoptions[$option]);wp_cache_set($notoptions_key,$notoptions,'site-options');}if(!is_multisite()){$result=update_option($option,$value,'no');}else{$value=sanitize_option($option,$value);$serialized_value=maybe_serialize($value);$result=$wpdb->update($wpdb->sitemeta,array('meta_value'=>$serialized_value),array('site_id'=>$network_id,'meta_key'=>$option,));if($result){$cache_key="$network_id:$option";wp_cache_set($cache_key,$value,'site-options');}}if($result){/**
		 * Fires after the value of a specific network option has been successfully updated.
		 *
		 * The dynamic portion of the hook name, `$option`, refers to the option name.
		 *
		 * @since 2.9.0 As "update_site_option_{$key}"
		 * @since 3.0.0
		 * @since 4.7.0 The `$network_id` parameter was added.
		 *
		 * @param string $option     Name of the network option.
		 * @param mixed  $value      Current value of the network option.
		 * @param mixed  $old_value  Old value of the network option.
		 * @param int    $network_id ID of the network.
		 */do_action("update_site_option_{$option}",$option,$value,$old_value,$network_id);/**
		 * Fires after the value of a network option has been successfully updated.
		 *
		 * @since 3.0.0
		 * @since 4.7.0 The `$network_id` parameter was added.
		 *
		 * @param string $option     Name of the network option.
		 * @param mixed  $value      Current value of the network option.
		 * @param mixed  $old_value  Old value of the network option.
		 * @param int    $network_id ID of the network.
		 */do_action('update_site_option',$option,$value,$old_value,$network_id);returntrue;}returnfalse;}

Correlato

Utilizzi

Usi Descrizione
wp-includes/load.php: get_current_network_id()

Recupera l'ID della rete corrente.

wp-includes/option.php: add_network_option()

Aggiunge una nuova opzione di rete.

wp-includes/option.php: get_network_option()

Recupera il valore dell'opzione di una rete in base al nome dell'opzione.

wp-includes/cache.php: wp_cache_get()

Recupera il contenuto della cache per chiave e gruppo.

wp-includes/cache.php: wp_cache_set()

Salva i dati nella cache.

wp-includes/formatting.php: sanitize_option()

Sanifica i valori di varie opzioni in base alla natura dell'opzione.

wp-includes/load.php: is_multisite()

Se Multisito è abilitato.

wp-includes/functions.php: maybe_serialize()

Serializza i dati, se necessario.

wp-includes/plugin.php: applica_filtri()

Richiama le funzioni di callback che sono state aggiunte a un gancio per filtri.

wp-includes/plugin.php: do_action()

Esegue le funzioni agganciate a un gancio di azione specifico.

wp-includes/option.php: pre_update_site_option_{$option}

Filtra una specifica opzione di rete prima che il suo valore sia aggiornato.

wp-includes/option.php: update_site_option_{$option}

Si attiva dopo che il valore di una specifica opzione di rete è stato aggiornato con successo.

wp-includes/option.php: aggiornamento_sito_opzione

Si attiva dopo che il valore di un'opzione di rete è stato aggiornato con successo.

wp-includes/option.php: update_option()

Aggiorna il valore di un'opzione già aggiunta.

wp-includes/option.php: wp_protect_special_option()

Protegge l'opzione speciale di WordPress dalla modifica.

wp-includes/wp-db.php: wpdb::update()

Aggiorna una riga nella tabella.

Utilizzato da

Usato da Descrizione
wp-includes/class-wp-application-passwords.php: WP_Application_Passwords::create_new_application_password()

Crea una nuova password di applicazione.

wp-includes/functions.php: is_site_meta_supported()

Determina se i meta del sito sono abilitati.

wp-includes/option.php: update_site_option()

Aggiorna il valore di un'opzione già aggiunta per la rete corrente.

wp-includes/ms-functions.php: wp_update_network_site_counts()

Aggiorna il conteggio dei siti della rete.

wp-includes/ms-functions.php: wp_update_network_user_counts()

Aggiorna il conteggio degli utenti della rete.

Changelog

Versione Descrizione
4.4.0 Introdotto.