unregister_block_pattern()


WordPressのunregister_block_pattern()関数は、登録されているブロックパターンを解除するために使用されます。

構文

unregister_block_pattern( string $pattern_name );
  • $pattern_name (string) — 解除するブロックパターンの名前

例1: 基本的なパターンの解除

登録済みのブロックパターン”my-custom-pattern”を解除します。

unregister_block_pattern('my-custom-pattern');

例2: テーマのパターンを解除

テーマが提供するパターン”theme-slug/featured-posts”を解除します。

unregister_block_pattern('theme-slug/featured-posts');

例3: プラグインのパターンを解除

プラグインが登録したパターン”plugin-slug/gallery-grid”を解除します。

unregister_block_pattern('plugin-slug/gallery-grid');

例4: コアパターンの解除

WordPressコアのパターン”core/query-standard-posts”を解除します。

unregister_block_pattern('core/query-standard-posts');

例5: 複数パターンの解除

複数のパターンを個別に解除します。

unregister_block_pattern('pattern-one');unregister_block_pattern('pattern-two');

例6: initフックでの使用

initフック内でパターンを解除します。

add_action('init',function(){unregister_block_pattern('old-pattern');});

例7: 条件付きでパターンを解除

特定の条件下でのみパターンを解除します。

if(!current_user_can('edit_posts')){unregister_block_pattern('premium-pattern');}

注意事項

  • パターン名は正確に指定する必要があります
  • 解除前にパターンが登録されていることを確認してください
  • 子テーマで親テーマのパターンを解除できます

関連機能：