unregister_block_type()


WordPressのunregister_block_type()関数は、登録済みのブロックタイプを解除するために使用されます。Gutenbergエディターで不要なブロックを削除する場合に便利です。

構文

unregister_block_type( string $block_name );
  • $block_name (string) — 解除するブロックの名前（例: ‘core/paragraph’）

例1: 基本的なブロックの解除

コアの段落ブロックを解除します。

unregister_block_type( 'core/paragraph' );

例2: カスタムブロックの解除

プラグインで登録されたカスタムブロックを解除します。

unregister_block_type( 'my-plugin/my-custom-block' );

例3: 複数のブロックを解除

複数のブロックを一度に解除します。

unregister_block_type( 'core/image' ); unregister_block_type( 'core/quote' );

例4: 条件付きでブロックを解除

特定の条件下でのみブロックを解除します。

if ( ! current_user_can( 'edit_posts' ) ) { unregister_block_type( 'core/audio' ); }

例5: プラグイン無効化時にブロックを解除

プラグインが無効化されたときにブロックを解除します。

register_deactivation_hook( __FILE__, function() { unregister_block_type( 'my-plugin/block' ); } );

例6: テーマでブロックを解除

テーマのfunctions.phpでブロックを解除します。

add_action( 'init', function() { unregister_block_type( 'core/verse' ); } );

例7: 動的にブロック名を指定して解除

変数を使用してブロックを解除します。

$block_to_remove = 'core/table'; unregister_block_type( $block_to_remove );

注意点

  • この関数はinitフック以降で使用する必要があります。
  • 解除したブロックはエディターから完全に削除されます。
  • 解除前にブロックが登録されていることを確認してください。

関連機能：