• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「関数リファレンス/wp update user」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(関連情報)
(未翻訳部分の翻訳)
7行目: 7行目:
 
この関数は、データベース内の1つのユーザーを更新します。このアップデートでは、配列としてユーザメタデータの複数の部分を含めることができます。
 
この関数は、データベース内の1つのユーザーを更新します。このアップデートでは、配列としてユーザメタデータの複数の部分を含めることができます。
  
To update a single piece of user metadata, use [[Function_Reference/update_user_meta|update_user_meta()]] instead.
+
ユーザメタ情報の一部を更新する場合は、代わりに [[関数リファレンス/update_user_meta|update_user_meta()]] を使用してください。
  
To create a ''new'' user, use [[Function_Reference/wp_insert_user|wp_insert_user()]] instead.
+
新規ユーザを作成する場合は、代わりに [[関数リファレンス/wp_insert_user|wp_insert_user()]] を使用してください。
  
  
注: If current user's password is being updated, then the cookies will be cleared!
+
注: 現在ログインしているユーザのパスワードが更新された場合、Cookieはクリアされます。
  
 
===特記事項===
 
===特記事項===
30行目: 30行目:
 
== パラメータ ==
 
== パラメータ ==
 
</div>
 
</div>
{{Parameter|$userdata|mixed|An array of user data, stdClass or [[Class_Reference/WP_User|WP_User]] object.}}
+
{{Parameter|$userdata|配列|オブジェクト|ユーザー情報の配列または stdClass、または[[クラスリファレンス/WP_User|WP_User]] オブジェクト。}}
  
 
<div id="Return_Values">
 
<div id="Return_Values">
36行目: 36行目:
 
== 戻り値 ==
 
== 戻り値 ==
 
</div>
 
</div>
; <tt>(mixed)</tt> : If successful, returns the user_id, otherwise returns a [[Class_Reference/WP_Error|WP_Error]] object.
+
; <tt>(整数|オブジェクト)</tt> : 更新に成功するとユーザIDを、失敗すると [[クラスリファレンス/WP_Error|WP_Error]] オブジェクトを返します。
 
<div id="Examples">
 
<div id="Examples">
  
42行目: 42行目:
 
</div>
 
</div>
 
<!-- Need creative examples. Feel free to link to external examples. -->
 
<!-- Need creative examples. Feel free to link to external examples. -->
Below is an example showing how to update a user's Website profile field
+
以下の例は、ユーザプロフィール項目の「ウェブサイト」を更新する方法を表しています。
 
<pre>
 
<pre>
 
<?php
 
<?php
74行目: 74行目:
  
 
{| border="0" cellspacing="5" summary="User data array fields."
 
{| border="0" cellspacing="5" summary="User data array fields."
|+ The <tt>$userdata</tt> array can contain the following fields
+
|+ <tt>$userdata</tt>配列には次の項目を含めることができます。
 
|-
 
|-
! style="font-weight:bold" | Field Name
+
! style="font-weight:bold" | 項目名
! Description
+
! 項目内容
! [[Plugin_API/Filter_Reference#Database_Writes_4|Associated Filter]]
+
! [[プラグイン_API/フィルターフック一覧#.E3.83.87.E3.83.BC.E3.82.BF.E3.83.99.E3.83.BC.E3.82.B9.E6.9B.B8.E3.81.8D.E8.BE.BC.E3.81.BF_4|関連フィルタ]]
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | ID
 
| style="font-weight:bold" | ID
| An integer that will be used for updating an existing user.
+
| 更新するユーザのユーザID
 
| (none)
 
| (none)
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | user_pass
 
| style="font-weight:bold" | user_pass
| A string that contains the plain text password for the user.
+
| プレーンテキストパスワード
 
| <tt>pre_user_pass</tt>
 
| <tt>pre_user_pass</tt>
 
|-valign="top"
 
|-valign="top"
93行目: 93行目:
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | user_nicename
 
| style="font-weight:bold" | user_nicename
| A string that contains a URL-friendly name for the user. The default is the user's username.
+
| URLに含まれる文字列。デフォルトは'user_login'の値
 
| <tt>pre_user_nicename</tt>
 
| <tt>pre_user_nicename</tt>
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | user_url
 
| style="font-weight:bold" | user_url
| A string containing the user's URL for the user's web site.
+
| WebサイトのURL
 
| <tt>pre_user_url</tt>
 
| <tt>pre_user_url</tt>
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | user_email
 
| style="font-weight:bold" | user_email
| A string containing the user's email address.
+
| メールアドレス
 
| <tt>pre_user_email</tt>
 
| <tt>pre_user_email</tt>
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | display_name
 
| style="font-weight:bold" | display_name
| A string that will be shown on the site. Defaults to user's username. It is likely that you will want to change this, for both appearance and security through obscurity (that is if you dont use and delete the default admin user).
+
| サイトに表示される文字列。デフォルトは'user_login'の値
 
| <tt>pre_user_display_name</tt>
 
| <tt>pre_user_display_name</tt>
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | nickname
 
| style="font-weight:bold" | nickname
| The user's nickname, defaults to the user's username.
+
| ニックネーム。デフォルトは'user_login'の値
 
| <tt>pre_user_nickname</tt>
 
| <tt>pre_user_nickname</tt>
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | first_name
 
| style="font-weight:bold" | first_name
| The user's first name.
+
|
 
| <tt>pre_user_first_name</tt>
 
| <tt>pre_user_first_name</tt>
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | last_name
 
| style="font-weight:bold" | last_name
| The user's last name.
+
|
 
| <tt>pre_user_last_name</tt>
 
| <tt>pre_user_last_name</tt>
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | description
 
| style="font-weight:bold" | description
| A string containing content about the user.
+
| ユーザに関する説明
 
| <tt>pre_user_description</tt>
 
| <tt>pre_user_description</tt>
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | rich_editing
 
| style="font-weight:bold" | rich_editing
| A string for whether to enable the rich editor or not. False if not empty.
+
| リッチエディタ使用の有効・無効を設定。空でない場合はFalse
 
| (none)
 
| (none)
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | user_registered
 
| style="font-weight:bold" | user_registered
| The date the user registered. Format is Y-m-d H:i:s.
+
| ユーザ情報の登録日時(形式:Y-m-d H:i:s)
 
| (none)
 
| (none)
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | role
 
| style="font-weight:bold" | role
| A string used to set the user's role.
+
| ユーザ権限を設定するための文字列
 
| (none)
 
| (none)
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | jabber
 
| style="font-weight:bold" | jabber
| User's Jabber account.
+
| Jabber アカウント
 
| (none)
 
| (none)
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | aim
 
| style="font-weight:bold" | aim
| User's AOL IM account.
+
| AOL IM アカウント
 
| (none)
 
| (none)
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | yim
 
| style="font-weight:bold" | yim
| User's Yahoo IM account.
+
| Yahoo IM アカウント
 
| (none)
 
| (none)
 
|-valign="top"
 
|-valign="top"
 
| style="font-weight:bold" | show_admin_bar_front
 
| style="font-weight:bold" | show_admin_bar_front
| Show the WP admin bar on the front-end.
+
| フロントエンドに管理バーを表示する
 
| (none)
 
| (none)
 
|}
 
|}
  
Remember, <tt>user_pass</tt> should be the plain text password as it will be automatically hashed by WordPress.
+
注: <tt>user_pass</tt> はWordPressにより自動的にハッシュ化されるため、プレーンテキストである必要があります。
  
  

2015年6月7日 (日) 16:35時点における版

このページ「関数リファレンス/wp update user」は未翻訳です。和訳や日本語情報を加筆してくださる協力者を求めています

データベースのユーザーを更新します。

この関数は、データベース内の1つのユーザーを更新します。このアップデートでは、配列としてユーザメタデータの複数の部分を含めることができます。

ユーザメタ情報の一部を更新する場合は、代わりに update_user_meta() を使用してください。

新規ユーザを作成する場合は、代わりに wp_insert_user() を使用してください。


注: 現在ログインしているユーザのパスワードが更新された場合、Cookieはクリアされます。

特記事項

If $userdata does not contain an 'ID' key, then a new user will be created and the new user's ID will be returned. Since version 3.6 this is no longer the case, but this behavior may be restored in the future. See ticket #16731.


使い方

<?php wp_update_user( $userdata ) ?>

パラメータ

$userdata
配列|オブジェクト) (必須) ユーザー情報の配列または stdClass、またはWP_User オブジェクト。
初期値: なし

戻り値

(整数|オブジェクト) 
更新に成功するとユーザIDを、失敗すると WP_Error オブジェクトを返します。

用例

以下の例は、ユーザプロフィール項目の「ウェブサイト」を更新する方法を表しています。

<?php

$user_id = 1;
$website = 'http://wordpress.org';

$user_id = wp_update_user( array( 'ID' => $user_id, 'user_url' => $website ) );

if ( is_wp_error( $user_id ) ) {
	// There was an error, probably that user doesn't exist.
} else {
	// Success!
}		


以下は内部で使用している関数です。


$userdata配列には次の項目を含めることができます。
項目名 項目内容 関連フィルタ
ID 更新するユーザのユーザID (none)
user_pass プレーンテキストパスワード pre_user_pass
user_login A string that contains the user's username for logging in. Please note that the function cannot alter this field, since WordPress does not allow usernames to be changed. pre_user_login
user_nicename URLに含まれる文字列。デフォルトは'user_login'の値 pre_user_nicename
user_url WebサイトのURL pre_user_url
user_email メールアドレス pre_user_email
display_name サイトに表示される文字列。デフォルトは'user_login'の値 pre_user_display_name
nickname ニックネーム。デフォルトは'user_login'の値 pre_user_nickname
first_name pre_user_first_name
last_name pre_user_last_name
description ユーザに関する説明 pre_user_description
rich_editing リッチエディタ使用の有効・無効を設定。空でない場合はFalse (none)
user_registered ユーザ情報の登録日時(形式:Y-m-d H:i:s) (none)
role ユーザ権限を設定するための文字列 (none)
jabber Jabber アカウント (none)
aim AOL IM アカウント (none)
yim Yahoo IM アカウント (none)
show_admin_bar_front フロントエンドに管理バーを表示する (none)

注: user_pass はWordPressにより自動的にハッシュ化されるため、プレーンテキストである必要があります。


改訂履歴

2.0.0: 導入されました。 3.5.0: stdClassまたはWP_Userオブジェクトを受け取ります。

ソースファイル

wp_update_user()wp-includes/registration.phpにあります。

カレントユーザー関数: get_current_user_id()/ en, get_currentuserinfo(), wp_get_current_user()/ en, wp_set_current_user(), current_user_can(), current_user_can_for_blog()/ en


最新英語版: WordPress Codex » Function_Reference/wp_update_user最新版との差分