wp_use_widgets_block_editor()


WordPressのwp_use_widgets_block_editor()関数は、ウィジェットブロックエディタを使用するかどうかを制御するために使用されます。この関数は、テーマやプラグインでウィジェット管理画面の挙動をカスタマイズする際に役立ちます。

構文

wp_use_widgets_block_editor( bool $use_block_editor );
  • $use_block_editor(bool) — ウィジェットブロックエディタを使用する場合はtrue、使用しない場合はfalseを指定します。

例1: ウィジェットブロックエディタを無効にする

ウィジェットブロックエディタを無効にするには、以下のコードを使用します。

add_filter('wp_use_widgets_block_editor', '__return_false');

例2: ウィジェットブロックエディタを有効にする

ウィジェットブロックエディタを有効にするには、以下のコードを使用します。

add_filter('wp_use_widgets_block_editor', '__return_true');

例3: 条件付きでウィジェットブロックエディタを無効にする

特定の条件下でウィジェットブロックエディタを無効にする例です。

function disable_widgets_block_editor($use_block_editor) { return is_admin() ? false : $use_block_editor; } add_filter('wp_use_widgets_block_editor', 'disable_widgets_block_editor');

例4: カスタムロジックでウィジェットブロックエディタを制御する

カスタムロジックを使用してウィジェットブロックエディタを制御する例です。

function custom_widgets_block_editor_control($use_block_editor) { return current_user_can('edit_posts') ? true : false; } add_filter('wp_use_widgets_block_editor', 'custom_widgets_block_editor_control');

例5: ウィジェットブロックエディタを特定のユーザーロールでのみ有効にする

管理者ロールのユーザーのみウィジェットブロックエディタを有効にする例です。

function enable_widgets_block_editor_for_admin($use_block_editor) { return current_user_can('manage_options') ? true : $use_block_editor; } add_filter('wp_use_widgets_block_editor', 'enable_widgets_block_editor_for_admin');

例6: ウィジェットブロックエディタを特定のページでのみ無効にする

特定のページIDでウィジェットブロックエディタを無効にする例です。

function disable_widgets_block_editor_on_specific_page($use_block_editor) { return is_page( get_the_ID() ) ? false : $use_block_editor; } add_filter('wp_use_widgets_block_editor', 'disable_widgets_block_editor_on_specific_page');

例7: ウィジェットブロックエディタを特定のテーマでのみ無効にする

特定のテーマがアクティブな場合にウィジェットブロックエディタを無効にする例です。

function disable_widgets_block_editor_for_specific_theme($use_block_editor) { return get_template() === 'twentytwenty' ? false : $use_block_editor; } add_filter('wp_use_widgets_block_editor', 'disable_widgets_block_editor_for_specific_theme');

注意点

  • この関数は、WordPress 5.8以降で使用可能です。
  • ウィジェットブロックエディタを無効にすると、従来のウィジェット管理画面が表示されます。
  • カスタマイズを行う際は、テーマやプラグインの互換性に注意してください。

関連機能：