Ver código-fonte no GitHub
João Paulo Cercal

Software Engineer na Spectrm em Berlim, Alemanha

  • 412 palavras
  • 2 min de leitura
  • Outros

Inserindo usuários no WordPress com wp_insert_user

A função wp_insert_user insere um usuário na base de dados do WordPress. Com ela também é possível atualizar um usuário se a chave ID estiver presente no array passado para a função como parâmetro.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
<?php

/**
 * Insere um usuário na base de dados do WordPress
 *
 * @param $userdata mixed Um array com os dados do usuário, stdClass ou um objeto WP_User
 *
 * @return mixed Se sucesso, retorna o ID do usuário que acaba de ser criado,
 *               do contrário retorna um objeto WP_Error
 */
wp_insert_user($userdata);

O array $userdata deve conter os seguintes campos:

  • ID  um inteiro, será utilizado para atualizar um usuário existente.
  • user_pass  uma string, contém uma senha que será utilizada pelo usuário.
  • user_login  uma string, contém um nome de usuário que será utilizado durante o login.
  • user_nicename  uma string, contém uma URL amigavel para o nome do usuário, o default para este campo é o nome do usuário.
  • user_url  uma string, contém a URL do perfil do usuário.
  • user_email  uma string, contém o endereço de email do usuário.
  • display_name  uma string, será utilizada para exibir o nome do usuário dentro do site. O valor padrão é o nome do usuário.
  • nickname  uma string, o nickname do usuário, o valor default para este campo é o nome do usuário.
  • first_name  uma string, o primeiro nome do usuário.
  • last_name  uma string, o sobrenome do usuário.
  • description  uma string, contém uma breve descrição sobre o usuário.
  • rich_editing  uma string, permite habilitar ou desabilitar o editor de textos.
  • user_registered a data em que o usuário foi registrado, o formato utilizado é o seguinte: Y-m-d H:i:s.
  • role  uma string, as regras que o usuário irá possuir. Por padrão o wordpress traz as seguintes regras: administrator, editor, author, contributor e subscriber.
  • jabber  uma string, a conta Jabber de um usuário.
  • aim uma string, a conta AOL IM de um usuário.
  • yim uma string, a conta Yahoo IM de um usuário.Agora um exemplo de utilização desta função:
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
<?php

$userdata = array(
  'user_pass'    => '123',
  'user_login'   => 'johndoe',
  'user_url'     => 'https://jpcercal.com',
  'user_email'   => '[email protected]',
  'display_name' => 'John Doe',
  'nickname'     => 'JD',
  'first_name'   => 'John',
  'last_name'    => 'Doe',
  'role'         => 'author',
);

$userId = wp_insert_user($userdata);

No exemplo acima vimos como é fácil inserir um usuário na base de dados do WordPress.

E aí, você ainda tem alguma dúvida? Não deixe de comentar.