wp user create în WordPress

Creează un utilizator WordPress nou, cu rol, nume și parolă, direct din terminal.

Sintaxă
wp user create <user-login> <user-email> [--role=<role>] [--user_pass=<password>] [--display_name=<name>] [--first_name=<first_name>] [--last_name=<last_name>] [--send-email] [--porcelain]

Ce face wp user create

wp user create primește două argumente obligatorii: numele de autentificare (login) și adresa de e-mail. Rolul se alege cu --role (administrator, editor, author, contributor, subscriber); fără el, utilizatorul primește rolul implicit din Setări → General (de obicei subscriber).

Dacă nu dai --user_pass, WP-CLI generează o parolă aleatorie de 24 de caractere și o afișează o singură dată, sub mesajul Success: Created user N.. Cu --porcelain se afișează doar ID-ul noului utilizator, util în scripturi.

Implicit nu se trimite niciun e-mail. Cu --send-email, utilizatorul primește un e-mail cu datele noului cont.

Parametri

Parametru Descriere
<user-login> Numele de autentificare al utilizatorului.
<user-email> Adresa de e-mail.
--role=<role> Rolul: administrator, editor, author, contributor, subscriber (sau un rol personalizat). Implicit, rolul implicit al site-ului.
--user_pass=<password> Parola. Implicit, una generată aleatoriu.
--display_name=<name> Numele afișat public.
--first_name=<first_name> Prenumele.
--last_name=<last_name> Numele de familie.
--user_registered=<yyyy-mm-dd-hh-ii-ss> Data înregistrării. Implicit, data curentă.
--send-email Trimite utilizatorului un e-mail cu datele contului.
--porcelain Afișează doar ID-ul utilizatorului nou.

Exemple

Exemplul 1: Un editor nou, cu parolă generată

Parola apare o singură dată; transmite-o pe un canal sigur sau cere-i Anei să și-o schimbe la prima autentificare.

wp user create ana ana@exemplu.ro --role=editor --first_name=Ana --last_name=Popescu --display_name="Ana Popescu"

Ieșire în terminal

Success: Created user 2.
Password: kQ7#mZ2v!Lp9@xR4^tW8&nB3

Exemplul 2: ID-ul utilizatorului folosit mai departe într-un script

Cu --porcelain se afișează doar ID-ul, care poate fi salvat într-o variabilă și folosit, de exemplu, ca autor al unui articol.

ID=$(wp user create mihai mihai@exemplu.ro --role=author --porcelain)
echo "Mihai are ID-ul $ID"

Ieșire în terminal

Mihai are ID-ul 3

Greșeli frecvente

  • Un login deja folosit: comanda se oprește cu Error: The 'ana' username is already registered.. Verifică întâi cu wp user list.
  • Parola scrisă în comandă (--user_pass=...) rămâne în istoricul shell-ului. Las-o generată sau citește-o cu --prompt=user_pass.
  • Un rol scris greșit sau tradus (--role=editor-sef, --role=autor): rolurile au nume interne în engleză, iar unul inexistent oprește comanda cu eroare.

Comenzi înrudite

  • wp user list: Afișează utilizatorii site-ului, cu ID, login, nume, e-mail, data înregistrării și rol, filtrabili după rol.
  • wp post create: Creează un articol, o pagină sau alt tip de conținut, cu titlu, conținut, stare și autor dați ca opțiuni.
  • wp core install: Creează tabelele WordPress și contul de administrator: „instalarea în 5 minute” făcută dintr-o singură comandă.