unregister_block_pattern_category()


WordPressのunregister_block_pattern_category()関数は、登録済みのブロックパターンカテゴリーを解除するために使用されます。

構文

unregister_block_pattern_category( string $category_name );
  • $category_name (string) — 解除するカテゴリー名

例1: 基本的なカテゴリー解除

「my-category」という名前のカテゴリーを解除します。

unregister_block_pattern_category( 'my-category' );

例2: プラグインで登録したカテゴリーを解除

プラグインが登録した「plugin-category」を解除します。

unregister_block_pattern_category( 'plugin-category' );

例3: 子テーマで親テーマのカテゴリーを解除

親テーマの「parent-theme-category」を子テーマで解除します。

unregister_block_pattern_category( 'parent-theme-category' );

例4: 複数カテゴリーを個別に解除

複数のカテゴリーを個別に解除します。

unregister_block_pattern_category( 'category-one' );unregister_block_pattern_category( 'category-two' );

例5: 条件付きでカテゴリーを解除

特定の条件下でのみカテゴリーを解除します。

if( get_theme_mod( 'remove_patterns' ) ) { unregister_block_pattern_category( 'conditional-category' ); }

例6: フックを使用して解除

initフックでカテゴリーを解除します。

add_action( 'init', function() { unregister_block_pattern_category( 'hooked-category' ); } );

例7: 存在確認後に解除

カテゴリーが存在する場合のみ解除します。

if( in_array( 'unwanted-category', array_keys( WP_Block_Pattern_Categories_Registry::get_instance()->get_all_registered() ) ) ) { unregister_block_pattern_category( 'unwanted-category' ); }

注意事項

  • この関数はinitフック以降で使用する必要があります
  • 解除前にカテゴリーが登録されていることを確認してください
  • コアパターンカテゴリーは解除できません

関連機能：