WordPress「よく使われているタグから選択」が「-1」表示になった

WordPressにそんなに慣れていない状態の人間がハマった表題の問題と、その対応についてです。

背景

WordPressのfunctions.phpでカスタム投稿タイプに紐づけたカスタム分類を設定したところ、
管理画面->該当のカスタム投稿画面「よく使われているタグから選択」をクリックした時に「-1」が表示される事案が発生しました。

環境

WordPress4.7.5
User Role Editor プラグインを使います
カスタム投稿タイプ(Custom Post Type)、カスタム分類(Custom taxonomy)はプラグインを使わず、functions.phpへ追記する形で追加します

原因

functions.phpへ追記をするときに、
カスタム分類(タグ) の capability(権限) 設定で, assign_terms => edit_post_hoge とし、
カスタム投稿の capability_type(メタ権限コンストラクタ文字列) 設定で post_hoge とした設定が原因でした。

register_taxonomy() - codex.wordpress.org
register_post_type() - codex.wordpress.org

正しくなかった設定(サンプル)

      register_taxonomy( 'hoge_tag', array( 'hoge' ), array(
                'hierarchical' => false,
                'label' => 'タグ',
                'public' => true,
                'show_ui' => true,
                'query_var' => true,
                'rewrite' => array('with_front' => false,'slug' => 'hoge/hogetag'),
                'capabilities' => array( 'assign_terms' => 'edit_post_hoge',
                                         'manage_terms' => 'manage_hoge',
                                         'edit_terms' => 'manage_hoge',
                                         'delete_terms' => 'manage_hoge' )
        ));

        $hoge_labels = array(
                'name' => "HOGE",
                'singular_name' => "HOGE",
                'add_new' => "新規追加",
                'add_new_item' => "新規HOGE追加",
                'edit_item' => "HOGEを編集",
                'new_item' => "新規HOGE",
                'view_item' => "表示",
                'search_items' => "HOGEを検索",
                'not_found' => "見つかりません",
                'not_found_in_trash' =>"ゴミ箱にはありません",
                'parent_item_colon' => '親',
                'menu_name' => 'HOGE'
        );
        $hoge_args = array(
                'labels' => $hoge_labels,
                'public' => true,
                'publicly_queryable' => true,
                'show_ui' => true,
                'show_in_menu' => true,
                'query_var' => true,
                'rewrite' => array('with_front' => false),
                'capability_type' => 'post_hoge',
                'has_archive' => true,
                'hierarchical' => false,
                'menu_position' => 5,
                'map_meta_cap' => true,
                'supports' => array( 'title', 'author', 'thumbnail' ),
                'taxonomies' => array( 'hoge_cat' , 'hoge_tag' )
        );
        register_post_type( 'hoge', $hoge_args );

原因(深追い)

WordPressのコアのコードに踏み込み、一つ一つ原因を追っていきます。

もしかすると、WordPressに慣れている方は上のだめな設定例をみただけで、原因の見当がついているかもしれません。そんな方はこれ以降読む必要ないかもしれません。

投稿画面「よく使われているタグから選択」クリックで、タグクラウドから情報を引っ張ってくる処理を行える権限は、wp-admin/includes/ajax-actions.php の wp_ajax_get_tagcloud() にあるとおり、assign_terms という権限です。ここでこけていて「-1」を返していました。

wp_ajax_get_tagcloud - developer.wordpress.org

        if ( ! current_user_can( $tax->cap->assign_terms ) ) {
                wp_die( -1 );
        }

今回、このカスタム分類の assign_terms という権限に指定したのは edit_post_hoge でした。
ところでこの edit_post_hoge は edit + post_hoge であり
edit + カスタム投稿のcapability_typeで指定した文字列 です。

実は(codex > register_post_type の capability_typeの項をよく見ると) カスタム投稿のcapability_typeで指定した文字列 は、以下の3パターンで「メタ権限」として、WordPress側で自動的にマッピングされる仕様になっていました。

edit + capability_type => edit_post
read + capability_type => read_post
delete + capability_type => delete_post

メタ権限のマッピングで、 edit_post_hoge は edit_post 権限に自動で紐づけられていたため、 wp-includes/capabilities.php の map_meta_caps で、 edit_post_hoge は edit_post と読み替えられてしまい、

本来タグクラウド取得処理で必要だった、 assign_terms の権限とは合致しなかったのが元凶でした。

current_user_can() - developer.wordpress.org
map_meta_cap() - developer.wordpress.org

メタ権限は以下の変数に格納されているようでした。

global $post_type_meta_caps

dumpするとこんな感じでした。

Array
(
    [edit_post] => edit_post,
    [read_post] => read_post,
    [delete_post] => delete_post,
    [edit_page] => edit_post,
    [read_page] => read_post,
    [delete_page] => delete_post,
    [customize] => delete_post,
    [edit_post_hoge] => edit_post,
    [read_post_hoge] => read_post,
    [delete_post_hoge] => delete_post
)

この関数でも取れそうです。

_post_type_meta_capabilities() - developer.wordpress.org