Eine auf WordPress spezialiserte Suchmaschine für Entwickler und Theme-Autoren

update_site_meta ›

update_site_meta ( $site_id, $meta_key, $meta_value, $prev_value = '' )
Parameter: (4)
  • (int) $site_id Site ID.
    Erforderlich: Ja
  • (string) $meta_key Metadata key.
    Erforderlich: Ja
  • (mixed) $meta_value Metadata value. Must be serializable if non-scalar.
    Erforderlich: Ja
  • (mixed) $prev_value Optional. Previous value to check before removing. Default empty.
    Erforderlich: Nein
    Standard: (leer)
Gibt zurück:
  • (int|bool) Meta ID if the key didn't exist, true on successful update, false on failure.
Definiert in:

Updates metadata for a site.

Use the $prev_value parameter to differentiate between meta fields with the same key and site ID.

If the meta field for the site does not exist, it will be added.


function update_site_meta( $site_id, $meta_key, $meta_value, $prev_value = '' ) {
	// Bail if site meta table is not installed.
	if ( ! is_site_meta_supported() ) {
		/* translators: %s: database table name */
		_doing_it_wrong( __FUNCTION__, sprintf( __( 'The %s table is not installed. Please run the network database upgrade.' ), $GLOBALS['wpdb']->blogmeta ), '5.0.0' );
		return false;

	$updated = update_metadata( 'blog', $site_id, $meta_key, $meta_value, $prev_value );

	// Bust site query cache.
	if ( $updated ) {
		wp_cache_set( 'last_changed', microtime(), 'sites' );

	return $updated;