wp_get_current_user

説明

WP_User wp_get_current_user( )
現在のユーザ情報を取得する。

パラメータ

パラメータはありません。

返り値

現在のユーザ情報としてWP_Userのオブジェクト(グローバル変数$current_user)を返す。ユーザ情報のプロパティは次の通り。
プロパティ名データ型意味
dataObject基本データ
IDintユーザID
capsArray所有するロールの連想配列(キー名がロール名)。管理者の場合はキー名'administrator'の値が1を含む。
cap_keystringロールのキー名
rolesArray所有するロールの配列(値がロール名)。管理者の場合は'administrator'を含む。
allcapsArray所有する権限の連想配列(キー名が権限名)
filterstringフィルター

なお、以下のプロパティについては、少なくとも3.3では無くなっている。
プロパティ名データ型意味
idintユーザID
first_namestring名前
last_namestring名字
user_loginstringログイン名
user_passstring暗号化されたパスワード
user_nicenamestringナイスネーム
user_emailstringメールアドレス
user_urlstringウェブサイト
user_registeredstring登録日時(書式はyyyy-mm-dd hh:mm:ss)
user_activation_keystringアクティベーションキー
user_statusintステータス
display_namestringブログ上の表示名
spamintスパム
deletedint削除状態
nicknamestringニックネーム
descriptionstringプロフィール情報
rich_editingboolビジュアルリッチエディターの状況
comment_shortcutsboolキーボードショートカットの状況
admin_colorstring管理画面の配色
use_sslintSSL使用
aimstringAIM
yimstringYahoo IM
jabberstringJabber / Google Talk
wp_capabilitiesArray所有するロールの連想配列
wp_user_levelintユーザレベル
wp_dashboard_quick_press_last_post_idintクイック編集用の投稿ID
wp_usersettingsstringユーザ設定内容
wp_usersettingstimeintユーザ設定更新時間(秒数)
source_domainstringドメイン名
primary_blogintブログID
closedpostboxes_postArrayクローズされている編集パーツの配列
metaboxhidden_postArray非表示の編集パーツの配列
metaboxorder_postArray編集パーツの並び順(キー名は'side'、'normal'、'advanced')
screen_layout_postintスクリーンレイアウト(列の数)
managenavmenuscolumnshiddenArray非表示のナビゲーションメニュー項目
metaboxhidden_navmenusArray非表示のナビゲーションメニュー編集パーツ
user_levelintユーザレベル
user_firstnamestring名前
user_lastnamestring名字
user_descriptionstringプロフィール情報

注意

この関数の内部では、 get_currentuserinfo関数を呼び出し、バージョン4.5.0以降はプライベート関数_wp_get_current_userを呼び出し、グローバル変数$current_userを更新する。

プライベート関数_wp_get_current_userでは、グローバル変数$current_userが未設定の場合、'determine_current_user'フィルターを呼び出し、認証クッキーを検証して認証されたユーザーをグローバル変数$current_userに適用する。

本関数は'init'アクション直前に実行される$wpのinitメソッド内で呼び出されており、通常では遅くともこの時点で認証されたユーザーが確定している。


使用例

  • 現在のユーザ情報を取得する。
    <?php $userinfo = wp_get_current_user( ); >

フィルター

実行するフィルターはありません。

アクション

実行するアクションはありません。

ソースファイル

/wp-includes/pluggable.php

最終更新 : 2024年02月21日 11:36



お勧め

5.3の新機能:クエリーログに任意の項目を追加できる新フィルター(2019年10月23日 更新)

5.3 RC2」が公開され、正式リリースまであと20日。公式ディレクトリにプラグインを公開していることもあり、5.3に関する開発者向けの情報「Miscellaneous Developer Focused Changes in 5.3」を読んでいる。

個人データのエクスポートメール向けに追加された新フィルター(2020年4月2日 更新)

先週「WordPress 5.4 RC3」が公開され、正式リリースまであと1週間。ブロックエディターの機能強化が目立つわけですが、地味な変更点もちらほらと。今回はその中の1つ、「個人データのエクスポート」機能に関連するフィルターを紹介する。

投稿内容に応じてwpautopを制御する(2013年8月13日 更新)

投稿内容を表示する the_content関数では、 wpautop関数がフィルターの1つとして呼び出され、改行をbrタグに変換したり、pタグで調整したりする。この機能自体は便利なのだが、きちんとデザインされたHTMLソースを流し込んだ場合はこの機能は好ましくない。そんなわけで、記事内容に応じてwpautop関数を制御できないか考えてみた。

新「WordPress Events and News」ウィジェットが興味深い(2018年5月27日 更新)

4.8のベータ版ですぐに新機能とわかるのが管理者ダッシュボードの新「WordPress Events and News」ウィジェット。ユーザーが指定した地域近隣で開催されるイベント情報を表示してくれるウィジェットで、この中のフォームがちょっと興味深かった。なおこの記事はWordPress 4.8 beta-2をもとにしており、以降のバージョンで変更される可能性があることをあらかじめ断っておく。

各種リンクを取得する関数一覧(2014年6月12日 更新)

サイト設計において、ページ間の相互リンクは重要である。WordPressでは各種ページのリンク(パーマリンク)を取得する関数を用意しており、それらを一通り把握しておくべきだろう。