Home

update_usermeta

February 12, 2011 by Thorsten 0 Comments

Definition:
function update_usermeta( $user_id, $meta_key, $meta_value ) {}

Update metadata of user.
There is no need to serialize values, they will be serialized if it is needed. The metadata key can only be a string with underscores. All else will be removed.

Parameters

  • int $user_id: User ID
  • string $meta_key: Metadata key.
  • mixed $meta_value: Metadata value.

Return values

returns:True on successful update, false on failure.

Defined actions

  • update_usermeta
    do_action( 'update_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );
  • added_usermeta
    do_action( 'added_usermeta', $wpdb->insert_id, $user_id, $meta_key, $meta_value );
  • updated_usermeta
    do_action( 'updated_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );

Source code

function update_usermeta( $user_id, $meta_key, $meta_value ) {

	_deprecated_function( __FUNCTION__, '3.0', 'update_user_meta()' );

	global $wpdb;

	if ( !is_numeric( $user_id ) )

		return false;

	$meta_key = preg_replace('|[^a-z0-9_]|i', '', $meta_key);



	/** @todo Might need fix because usermeta data is assumed to be already escaped */

	if ( is_string($meta_value) )

		$meta_value = stripslashes($meta_value);

	$meta_value = maybe_serialize($meta_value);



	if (empty($meta_value)) {

		return delete_usermeta($user_id, $meta_key);

	}



	$cur = $wpdb->get_row( $wpdb->prepare("SELECT * FROM $wpdb->usermeta WHERE user_id = %d AND meta_key = %s", $user_id, $meta_key) );



	if ( $cur )

		do_action( 'update_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );



	if ( !$cur )

		$wpdb->insert($wpdb->usermeta, compact('user_id', 'meta_key', 'meta_value') );

	else if ( $cur->meta_value != $meta_value )

		$wpdb->update($wpdb->usermeta, compact('meta_value'), compact('user_id', 'meta_key') );

	else

		return false;



	clean_user_cache( $user_id );

	wp_cache_delete( $user_id, 'user_meta' );



	if ( !$cur )

		do_action( 'added_usermeta', $wpdb->insert_id, $user_id, $meta_key, $meta_value );

	else

		do_action( 'updated_usermeta', $cur->umeta_id, $user_id, $meta_key, $meta_value );



	return true;

}

3209

/wp-includes/deprecated.php, Actions, Actions by letter a, Actions by letter u, Documentation, Files, Functions, Functions by letter u
, , ,

update_term_cache

February 12, 2011 by Thorsten 0 Comments

Definition:
function update_term_cache($terms, $taxonomy = '') {}

Updates Terms to Taxonomy in cache.

Parameters

  • array $terms: List of Term objects to change
  • string $taxonomy: Optional. Update Term to this taxonomy in cache

Source code

function update_term_cache($terms, $taxonomy = '') {

	foreach ( (array) $terms as $term ) {

		$term_taxonomy = $taxonomy;

		if ( empty($term_taxonomy) )

			$term_taxonomy = $term->taxonomy;



		wp_cache_add($term->term_id, $term, $term_taxonomy);

	}

}

3207

/wp-includes/taxonomy.php, Documentation, Files, Functions, Functions by letter u
,

update_site_option

February 12, 2011 by Thorsten 0 Comments

Definition:
function update_site_option( $option, $value ) {}

Update the value of a site option that was already added.

Parameters

  • string $option: Name of option. Expected to not be SQL-escaped.
  • mixed $value: Option value. Expected to not be SQL-escaped.

Return values

returns:False if value was not updated and true if value was updated.

Defined filters

  • pre_update_site_option_$option
    apply_filters( 'pre_update_site_option_' . $option, $value, $oldvalue )

Source code

function update_site_option( $option, $value ) {

	global $wpdb;



	$oldvalue = get_site_option( $option );

	$value = apply_filters( 'pre_update_site_option_' . $option, $value, $oldvalue );



	if ( $value === $oldvalue )

		return false;



	if ( false === $oldvalue )

		return add_site_option( $option, $value );



	if ( !is_multisite() ) {

		$result = update_option( $option, $value );

	} else {

		$value = sanitize_option( $option, $value );

		$cache_key = "{$wpdb->siteid}:$option";

		wp_cache_set( $cache_key, $value, 'site-options' );



		$_value = $value;

		$value = maybe_serialize( $value );

		$result = $wpdb->update( $wpdb->sitemeta, array( 'meta_value' => $value ), array( 'site_id' => $wpdb->siteid, 'meta_key' => $option ) );

		$value = $_value;

	}

3205

/wp-includes/functions.php, Documentation, Files, Filters, Filters by letter p, Functions, Functions by letter u
, ,

update_right_now_message

February 12, 2011 by Thorsten 0 Comments

Definition:
function update_right_now_message() {}

Source code

function update_right_now_message() {

	if ( is_multisite() && !current_user_can('update_core') )

		return false;



	$cur = get_preferred_from_update_core();



	$msg = sprintf( __('You are using <span class="b">WordPress %s</span>.'), $GLOBALS['wp_version'] );



	if ( isset( $cur->response ) && $cur->response == 'upgrade' && current_user_can('update_core') ) {

		$msg .= " <a href='" . network_admin_url( 'update-core.php' ) . "' class='button'>" . sprintf( __('Update to %s'), $cur->current ? $cur->current : __( 'Latest' ) ) . '</a>';

	}



	echo "<span id='wp-version-message'>$msg</span>";

}

3203

/wp-admin/includes/update.php, Documentation, Files, Functions, Functions by letter u
,

update_recently_edited

February 12, 2011 by Thorsten 0 Comments

Definition:
function update_recently_edited( $file ) {}

Parameters

  • unknown_type $file

Source code

function update_recently_edited( $file ) {

	$oldfiles = (array ) get_option( 'recently_edited' );

	if ( $oldfiles ) {

		$oldfiles = array_reverse( $oldfiles );

		$oldfiles[] = $file;

		$oldfiles = array_reverse( $oldfiles );

		$oldfiles = array_unique( $oldfiles );

		if ( 5 < count( $oldfiles ))

			array_pop( $oldfiles );

	} else {

		$oldfiles[] = $file;

	}

	update_option( 'recently_edited', $oldfiles );

}

3201

/wp-admin/includes/misc.php, Documentation, Files, Functions, Functions by letter u
,
Newer Entries
Older Entries