Crea una nuova password per l'applicazione.

Parametri

$id_utente

(int)(Richiesto)ID utente.

$args

(array)(Opzionale)Informazioni sulla password dell'applicazione.

Valore predefinito: array()

Ritorno

(array|WP_Error) La prima chiave dell'array è la nuova password, la seconda è la sua informazione dettagliata. In caso di errore viene restituita un'istanza WP_Error.

Fonte

File: wp-includes/class-wp-application-passwords.php

publicstaticfunctioncreate_new_application_password($user_id,$args=array()){if(!empty($args['name'])){$args['name']=sanitize_text_field($args['name']);}if(empty($args['name'])){returnnewWP_Error('application_password_empty_name',__('An application name is required to create an application password.'),array('status'=>400));}if(self::application_name_exists_for_user($user_id,$args['name'])){returnnewWP_Error('application_password_duplicate_name',__('Each application name should be unique.'),array('status'=>409));}$new_password=wp_generate_password(static::PW_LENGTH,false);$hashed_password=wp_hash_password($new_password);$new_item=array('uuid'=>wp_generate_uuid4(),'app_id'=>empty($args['app_id'])?'':$args['app_id'],'name'=>$args['name'],'password'=>$hashed_password,'created'=>time(),'last_used'=>null,'last_ip'=>null,);$passwords=static::get_user_application_passwords($user_id);$passwords[]=$new_item;$saved=static::set_user_application_passwords($user_id,$passwords);if(!$saved){returnnewWP_Error('db_error',__('Could not save application password.'));}$network_id=get_main_network_id();if(!get_network_option($network_id,self::OPTION_KEY_IN_USE)){update_network_option($network_id,self::OPTION_KEY_IN_USE,true);}/**
		 * Fires when an application password is created.
		 *
		 * @since 5.6.0
		 *
		 * @param int    $user_id      The user ID.
		 * @param array  $new_item     The details about the created password.
		 * @param string $new_password The unhashed generated app password.
		 * @param array  $args         Information used to create the application password.
		 */do_action('wp_create_application_password',$user_id,$new_item,$new_password,$args);returnarray($new_password,$new_item);}

Correlato

Utilizzi

Usi Descrizione
wp-includes/class-wp-application-passwords.php: WP_Application_Passwords::application_name_exists_for_user()

Controlla se il nome dell'applicazione esiste per questo utente.

wp-includes/class-wp-application-passwords.php: wp_create_application_password

Si attiva quando viene creata la password di un'applicazione.

wp-includes/functions.php: wp_generate_uuid4()

Genera un UUID casuale (versione 4).

wp-includes/option.php: update_network_option()

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

wp-includes/option.php: get_network_option()

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

wp-includes/functions.php: get_main_network_id()

Ottiene l'ID della rete principale.

wp-includes/l10n.php: __()

Recupera la traduzione di $testo.

wp-includes/formatting.php: sanitizza_campo_testo()

Sanifica una stringa dall'input dell'utente o dal database.

wp-includes/pluggable.php: wp_generate_password()

Genera una password casuale, estratta dall'insieme di caratteri definito.

wp-includes/pluggable.php: wp_hash_password()

Crea un hash (crittografia) di una password in chiaro.

wp-includes/plugin.php: do_action()

Esegue funzioni agganciate a un gancio di azione specifico.

wp-includes/class-wp-error.php: WP_Error::__construct()

Inizializza l'errore.

Utilizzato da

Usato da Descrizione
wp-includes/rest-api/endpoints/class-wp-rest-application-passwords-controller.php: WP_REST_Application_Passwords_Controller::create_item()

Crea una password dell'applicazione.

Changelog

Versione Descrizione
5.7.0 Restituisce WP_Error se il nome dell'applicazione esiste già.
5.6.0 Introdotto.