block_core_navigation_set_ignored_hooked_blocks_metadata()


WordPressのblock_core_navigation_set_ignored_hooked_blocks_metadata()関数は、ナビゲーションブロックにフックされたブロックのメタデータを無視するために使用されます。

構文

block_core_navigation_set_ignored_hooked_blocks_metadata( array $metadata );
  • $metadata(array) — 無視するブロックのメタデータを含む配列。

例1: ナビゲーションブロックにフックされたブロックのメタデータを無視する

この例では、特定のブロックのメタデータを無視するように設定します。

block_core_navigation_set_ignored_hooked_blocks_metadata( array( 'core/paragraph' ) );

例2: 複数のブロックのメタデータを無視する

複数のブロックのメタデータを無視する例です。

block_core_navigation_set_ignored_hooked_blocks_metadata( array( 'core/paragraph', 'core/image' ) );

例3: カスタムブロックのメタデータを無視する

カスタムブロックのメタデータを無視する例です。

block_core_navigation_set_ignored_hooked_blocks_metadata( array( 'my-plugin/custom-block' ) );

例4: ナビゲーションブロックのメタデータを無視する

ナビゲーションブロック自体のメタデータを無視する例です。

block_core_navigation_set_ignored_hooked_blocks_metadata( array( 'core/navigation' ) );

例5: 無視するブロックのメタデータを動的に設定する

条件に基づいて無視するブロックのメタデータを動的に設定する例です。

$ignored_blocks = is_front_page() ? array( 'core/paragraph' ) : array( 'core/image' );
block_core_navigation_set_ignored_hooked_blocks_metadata( $ignored_blocks );

例6: 無視するブロックのメタデータをフィルタリングする

無視するブロックのメタデータをフィルタリングする例です。

add_filter( 'block_core_navigation_ignored_hooked_blocks', function( $metadata ) {
    return array_merge( $metadata, array( 'core/quote' ) );
} );

例7: 無視するブロックのメタデータをリセットする

無視するブロックのメタデータをリセットする例です。

block_core_navigation_set_ignored_hooked_blocks_metadata( array() );

例8: 無視するブロックのメタデータを取得する

現在無視されているブロックのメタデータを取得する例です。

$ignored_metadata = apply_filters( 'block_core_navigation_ignored_hooked_blocks', array() );

注意点:

  • この関数は、ナビゲーションブロックにフックされたブロックのメタデータを無視するために使用されますが、他のブロックには影響しません。
  • 無視するブロックのメタデータを設定する際は、適切なブロック名を指定する必要があります。

関連機能：