wp_dropdown_users の who が authors の時 user_level が 0 以上じゃないと表示されない

この記事は 2020年 10月 14日に書かれた記事です。

この記事は WordPress Version 5.5.1 の時の記事です。

user_level はもう使われていないと思ったらまだ使っているところがありました

wp_dropdown_users に追加したユーザが表示されずに原因がわかるまでに無駄に時間を使ってしまいました

メンバー紹介ページを作りたいと思いまして
カスタム投稿だけにアクセスできるユーザーを作って
そのユーザは自分の投稿だけを修正できるようにしたいと考えました

調べたら多少古い記事でしたが良さげな情報でしたので

カスタム投稿タイプと専用のユーザー権限（完結編） | Gatespace's Blogを参考にさせていただきました。
https://gatespace.jp/2012/05/24/custom-post-type-and-user-role-fix/

カスタム投稿タイプとカスタム役割の作成

参考サイトを元にサクッと作成します

カスタム投稿タイプ

カスタム投稿タイプを作る際の注意点としては

'capability_type'     => POST_TYPE,
'map_meta_cap'        => true,

の 2点です

最初 map_meta_cap を設定していなくて正しく権限を割り振れなかったので注意が必要です

関数リファレンス/register post type - WordPress Codex 日本語版
https://wpdocs.osdn.jp/%E9%96%A2%E6%95%B0%E3%83%AA%E3%83%95%E3%82%A1%E3%83%AC%E3%83%B3%E3%82%B9/register_post_type

カスタム役割

こちらに関しては参考サイトのコードを少しカスタマイズして使いました

ここでは注意する点は特にないかと思います

wp_dropdown_users の who が authors の時

カスタム投稿タイプとカスタム役割を作成しましたが
管理ページの投稿者のプルダウンに追加したユーザーが表示されていないことに気が付きました

これでは対象の投稿を割り振ることができません

wp_dropdown_users

まずは /wp-admin/edit.php のソースコードを読んで
投稿者のプルダウンは wp_dropdown_users を呼び出していることがわかりました

なので wp_dropdown_users について調べました

wp_dropdown_users() | Function | WordPress Developer Resources
https://developer.wordpress.org/reference/functions/wp_dropdown_users/

get_users でデータを取得していることがわかりました

get_users

今度は get_users を調べてみます

get_users() | Function | WordPress Developer Resources
https://developer.wordpress.org/reference/functions/get_users/

WP_User_Query でデータを取得していることがわかりました

WP_User_Query

さらに WP_User_Query を調べてみます

WP_User_Query | Class | WordPress Developer Resources
https://developer.wordpress.org/reference/classes/wp_user_query/

ここで DBからデータを取得していることがわかりました

who が authors の時は何をしてるか

WP_User_Query の Who Parameter に以下の様に絞り込んでいる事がわかりました

$args = array(
	'meta_key'     => 'user_level',
	'meta_value'   => '0',
	'meta_compare' => '!=',
	'blog_id'      => 0
)
$user_query = new WP_User_Query( $args );

user_level を設定する

wp_dropdown_users の who が authors の時でも
user_level が 0 以外であれば表示されることがわかったので
user_level を設定しようと思います

user_level

まずは user_level について調べてみました

ユーザーの種類と権限 - WordPress Codex 日本語版
https://wpdocs.osdn.jp/%E3%83%A6%E3%83%BC%E3%82%B6%E3%83%BC%E3%81%AE%E7%A8%AE%E9%A1%9E%E3%81%A8%E6%A8%A9%E9%99%90#.E3.83.A6.E3.83.BC.E3.82.B6.E3.83.BC.E3.83.AC.E3.83.99.E3.83.AB

ユーザーレベルは最終的に、バージョン3.0で非推奨となりました。 と書いてありましたがどうやらまだ使われている所はあるみたいです

update_user_level_from_caps

user_level はどの様に設定するのか調べていたらどうやら update_user_level_from_caps で設定できることがわかりました

WP_User::update_user_level_from_caps() | Method | WordPress Developer Resources
https://developer.wordpress.org/reference/classes/wp_user/update_user_level_from_caps/

なのでまずは add_role した後 add_cap で level_2 等を足してあげます

add_role( ROLE_TYPE, __( 'Member', 'translation' ) );

$role = get_role( ROLE_TYPE );

$role->add_cap( 'level_2' );
$role->add_cap( 'level_1' );
$role->add_cap( 'level_0' );

その後 update_user_level_from_caps をしてあげます

$users = get_users();

foreach( $users as $user ) {
  if( in_array( ROLE_TYPE, $user->roles ) ) {
    $user->update_user_level_from_caps();
  }
}

この方法であっているかわかりませんが
これで管理ページの投稿者のプルダウンから選択できるようになりました