Actualice el metacampo del usuario según el ID de usuario.

Descripción

Utilice el parámetro $ prev_value para diferenciar entre metacampos con el mismo key e ID de usuario.

Si el metacampo para el usuario no existe, se agregará.

Parámetros

$ user_id

(En t)(Requerido)ID de usuario.

$ meta_key

(string)(Requerido)Metadatos key.

$ meta_valor

(mixed)(Requerido)Valor de los metadatos. Debe ser serializable si no es escalar.

$ prev_value

(mixed)(Opcional) Valor anterior para comprobar antes de actualizar. Si se especifica, solo actualice las entradas de metadatos existentes con este valor. De lo contrario, actualice todas las entradas.

Valor por defecto: ”

Regreso

(int |bool) Meta ID si el key no existía, true en una actualización exitosa, false en caso de falla o si el valor pasado a la función es el mismo que el que ya está en la base de datos.

Más información

Cambios en el comportamiento del update_usermeta ahora obsoleto:

Update_user_meta no elimina el meta si el nuevo valor está vacío.

Las acciones son diferentes.

Fuente

Expediente: wp-includes / user.php

functionupdate_user_meta($user_id,$meta_key,$meta_value,$prev_value='')returnupdate_metadata('user',$user_id,$meta_key,$meta_value,$prev_value);

Relacionado

Usos

Usos Descripción
wp-includes / meta.php:update_metadata ()

Actualiza los metadatos del objeto especificado. Si ya no existe ningún valor para el ID de objeto y los metadatos especificados key, se agregarán los metadatos.

Usado por

Usado por Descripción
wp-includes / class-wp-application-passwords.php:WP_Application_Passwords :: set_user_application_passwords ()

Establece las contraseñas de la aplicación de un usuario.
wp-includes / ms-site.php:wp_initialize_site ()

Ejecuta la rutina de inicialización para un sitio determinado.
wp-admin / includes / class-wp-screen.php:WP_Screen :: render_meta_boxes_preferences ()

Renderice las preferencias de los metaboxes.
wp-admin / includes / ajax-actions.php:wp_ajax_save_wporg_username ()

Controlador Ajax para guardar el nombre de usuario de WordPress.org del usuario.
wp-includes / class-wp-user-meta-session-tokens.php:WP_User_Meta_Session_Tokens :: update_sessions ()

Actualiza las sesiones del usuario en la tabla usermeta.
wp-admin / incluye / ms.php:choose_primary_blog ()

Maneja la visualización de la elección del sitio principal de un usuario.
wp-includes / user.php:send_confirmation_on_profile_email ()

Envíe un correo electrónico de solicitud de confirmación cuando se intente cambiar la dirección de correo electrónico del usuario.
wp-admin / includes / misc.php:set_screen_options ()

Guarda la opción para el número de filas al enumerar publicaciones, páginas, comentarios, etc.
wp-admin / incluye / schema.php:red_población ()

Complete la configuración de red.
wp-admin / includes / upgrade.php:wp_install_defaults ()

Crea el contenido inicial para un sitio recién instalado.
wp-admin / includes / class-wp-plugin-install-list-table.php:WP_Plugin_Install_List_Table :: prepare_items ()
wp-admin / includes / ajax-actions.php:wp_ajax_save_user_color_scheme ()

Controlador Ajax para guardar automáticamente el esquema de color seleccionado para el propio perfil de un usuario.
wp-admin / includes / ajax-actions.php:wp_ajax_dismiss_wp_pointer ()

Controlador Ajax para descartar un puntero de WordPress.
wp-admin / includes / ajax-actions.php:wp_ajax_update_welcome_panel ()

Controlador Ajax para actualizar si se muestra el panel de bienvenida.
wp-includes / class-wp-user.php:WP_User :: update_user_level_from_caps ()

Actualice el nivel de usuario máximo para el usuario.
wp-includes / class-wp-user.php:WP_User :: add_cap ()

Agregue capacidad y otorgue o niegue el acceso a la capacidad.
wp-includes / class-wp-user.php:WP_User :: remove_cap ()

Eliminar capacidad del usuario.
wp-includes / class-wp-user.php:WP_User :: add_role ()

Agregar rol al usuario.
wp-includes / class-wp-user.php:WP_User :: remove_role ()

Eliminar el rol del usuario.
wp-includes / class-wp-user.php:WP_User :: set_role ()

Establezca el rol del usuario.
wp-includes / user.php:wp_insert_user ()

Inserta un usuario en la base de datos.
wp-includes / user.php:update_user_option ()

Actualización de la opción de usuario con capacidad de blog global.
wp-includes / ms-functions.php:add_new_user_to_blog ()

Agrega un usuario recién creado al blog apropiado
wp-includes / ms-functions.php:get_active_blog_for_user ()

Obtener uno de los blogs activos de un usuario
wp-includes / ms-functions.php:add_user_to_blog ()

Agrega un usuario a un blog, además de especificar el rol del usuario.
wp-includes / ms-functions.php:remove_user_from_blog ()

Eliminar a un usuario de un blog.

Registro de cambios

Versión Descripción
3.0.0 Introducido.