メタボックスをクラシックエディターのみで表示する

説明

投稿画面向けにメタボックスを使ったプラグインがあり、それがブロックエディターで意図した通りに機能しなかった。この対処方法を考える過程でエディタータイプに応じてメタボックスを出し分けできる方法が見つかったので紹介したい。

add_meta_box関数の第7パラメータ

投稿画面のメタボックス(ウィジェット)にはブロックエディターではうまく機能しないものや不要なものがある。メタボックスは従来通りの指定では両エディターで表示されるが、エディタータイプに応じて表示が切り替え可能になっていた(「Meta Box Compatibility Flags」)。

メタボックスは add_meta_box関数で表示する。まずは関数の定義部分をおさらい。

void add_meta_box( string $id, string $title, string $callback, string $page [, string $context = 'advanced' [, string $priority = 'default' [, array $callback_args = null ] ] ] )

ポイントとなるのは第7パラメータ$callback_argsで、ここに次に示す連想配列を指定することでクラシックエディターのみで表示させることができる。

add_meta_box( 'meta_box_test', 'meta box test', 'meta_box_test_callback',
	 'post', 'side', 'default',
	array(
//		'__block_editor_compatible_meta_box'	=> false,
		'__back_compat_meta_box' 				=> true,
	) );

キー'__back_compat_meta_box'の値にtrueを指定することで、メタボックスはクラシックエディターのみで表示される。コメント化しているキー'__block_editor_compatible_meta_box'はメタボックスがブロックエディターに対応しているかどうかを示すもの。現在のバージョン5.0.3ではここをコメント化してもクラッシックエディターのみで表示できた。

なお、試した限りではブロックエディターのみで表示する指定は見つからなかった。このパラメータについては将来のバージョンで変更される可能性が示唆されているので、リクエストしだいでは仕様が変更されるかもしれない。


最終更新 : 2019年01月15日 11:21


お勧め

restore_previous_locale(2018年11月21日 更新)

string | bool restore_previous_locale()
直前のロケールへ戻す。

is_email(2017年11月28日 更新)

mixed is_email( string $email [, bool $deprecated = false ] )
文字列がメールアドレス形式か調べる。

is_rtl(2015年8月26日 更新)

bool is_rtl( )
現在のロケールが右書き(文字を右から左へ書き進めること)か調べる。

get_parent_theme_file_path(2018年5月27日 更新)

string get_parent_theme_file_path( string $file = '' )
親テーマ内にあるファイルのパス名を取得する。

is_page(2018年7月4日 更新)

bool is_page( [ mixed $page = '' ] )
要求されているページが、ページか調べる。