the_block_editor_meta_boxes()


WordPress関数the_block_editor_meta_boxes()は、ブロックエディターにメタボックスを追加・操作するために使用されます。

構文

the_block_editor_meta_boxes( string $post_type, WP_Post $post );

引数の説明:

  • $post_type(string)—投稿タイプを指定します。
  • $post(WP_Post)—対象の投稿オブジェクト。

例1:メタボックスを追加する

カスタムメタボックスをブロックエディターに追加します。

add_action('add_meta_boxes',function(){the_block_editor_meta_boxes(get_post_type(),get_post());});

例2:特定の投稿タイプにのみメタボックスを表示

「post」投稿タイプでのみメタボックスを表示します。

if('post'===$post_type){the_block_editor_meta_boxes($post_type,$post);}

例3:メタボックスの優先度を変更

メタボックスの表示順序を「high」に設定します。

add_meta_box('custom_box','タイトル','callback','post','side','high');

例4:カスタムコールバック関数を使用

メタボックス内容をカスタマイズするコールバック関数を指定します。

function custom_meta_box_callback($post){echo'<input type="text" name="custom_field">';}

例5:複数のメタボックスを一度に登録

複数のメタボックスをループ処理で追加します。

$boxes=array('box1','box2');foreach($boxes as $box){add_meta_box($box,$box,'callback',$post_type);}

例6:メタボックスの位置を変更

メタボックスの位置を「side」から「normal」に変更します。

add_meta_box('id','タイトル','callback','post','normal');

例7:非表示にするメタボックスを指定

特定のメタボックスを非表示にします。

remove_meta_box('postcustom','post','normal');

注意点

  • この関数はブロックエディター(Gutenberg)専用です。
  • フックの優先順位に注意してください。
  • セキュリティ対策としてnonceフィールドを使用します。

関連機能：