Брайан Мессенленер , Джейсон Коулман - Разработка веб-приложений на WordPress

администратора. Однако если вам потребуется
создать пользователей в своем программном коде или обновить метаданные о них,
то будут полезны функции, описанные в следующем разделе.

Функции в каталоге /wp-includes/...
Эти функции находятся в файлах /wp-include/pluggable.php и /wp-includes/user.php.
♦ wp_insert_user ($userdata) — создает нового пользователя в базе данных. Эту
функцию также можно задействовать для обновления пользователя, если иден­
тификатор пользователя передается вместе с $user_data. $userdata — обязатель­
ный массив имен и значений полей. Поля, которые нужно передать, следующие:

•

id— целое число, которое будет использоваться для обновления сущест­
вующего пользователя;

• user pass — строка, содержащая простой текстовый пароль пользователя;

• user login — строка, содержащая имя пользователя для входа в систему;
• user nicename — строка, содержащая удобное для пользователя имя пользова­
теля. По умолчанию совпадает с username пользователя;
• user uri — строка, содержащая URL-адрес веб-сайта пользователя;
• user email — строка, содержащая адрес электронной почты пользователя;
52

|

Гпава 2

• display name — строка, которая будет показана на сайте. По умолчанию сов­
падает с именем пользователя. Вполне вероятно, что вы захотите изменить
его, чтобы все отображалось красиво;
• nickname— псевдоним пользователя. По умолчанию совпадает С username
пользователя;

•

first name — имя пользователя;

•

last name — фамилия пользователя;

• description — строка, содержащая информацию о пользователе;
•

rich editing — строка активации визуального редактора. Значение false, если
не пуста;

• user registered — Дата, КОГДа пользователь зарегистрировался. Формат: Y-m-d
Н: i: s;
•

role — строка, используемая для установки роли пользователя.

♦ wp_create_user ($ username, $ password, $ email) — Эта функция ИСПОЛЬЗует
предыдущую функцию wp insert user () и облегчает добавление нового пользо­
вателя на основе обязательных столбцов:

•

$username — обязательная строка имени пользователя/логина нового пользо­
вателя;

•

$password — обязательная строка пароля нового пользователя;

•

$emaii — обязательная строка адреса электронной почты нового пользователя.

♦ wp update user ($userdata) — функция ДЛЯ обновления любого ПОЛЯ В таблицах
wp users и wp—Usermeta (рассматривается далее), связанных с конкретным пользо­
вателем. Обратите внимание, что если пароль пользователя обновляется, все его
cookie будут удалены, произойдет выход из его аккаунта WordPress:

•

$userdata — обязательный массив имен полей и значений, id и хотя бы одно
другое поле обязательны для заполнения. Эти поля те же, что приняты в
функции wp_insert_post ().

♦ get user by($field, $value) — Эта функция возвращает объект WP User в случае
успеха и false — в противном случае. Класс WordPress user находится в файле
/wp-includes/capabilities.php и в основном делает запросы в таблицу wp user сле­
дующим образом: SELECT * FROM wp_users WHERE $field = $value.

Класс wp user кэширует результаты, чтобы избежать запросов к базе данных ка­
ждый раз, когда он вызывается. Класс также использует роли и возможности
конкретного пользователя, о чем мы более подробно расскажем в главе 6:
•

$fieid— обязательная строка поля, по которой вы хотите запросить данные
пользователя. Эта строка может быть только id, slug, email или login;

•

$ value — обязательное целое число или строка — значение для данного иден­
тификатора, описания, адреса электронной почты или имени.
Основы WordPress

|

53

♦ get—Userdata ($userid) — эта функция фактически вызывает предыдущую функ­
цию get user by () и возвращает тот же объект wp user:

•

$userid — обязательное целое число — идентификатор пользователя, для ко­
торого вы хотите получить данные.

♦ wpdeleteuser ($id, $reassign = ’novalue') — Эта функция удаляет пользовате­
ля, а также может переназначать любые его сообщения или ссылки другому
пользователю:

•

$id — обязательное целое число — идентификатор пользователя, которого вы
хотите удалить;

•

$ reassign — необязательное целое число — идентификатор пользователя, на
которого вы хотите переназначить любой пост или ссылку удаленного поль­
зователя.

В листинге 2.2 продемонстрированы некоторые основные функции для взаимодей­
ствия С таблицей wp_users.

--">