wp_normalize_remote_block_pattern()


WordPressのwp_normalize_remote_block_pattern()関数は、リモートから取得したブロックパターンのデータを正規化するために使用されます。この関数は、パターンのデータが適切な形式であることを保証し、テーマやプラグインで安全に利用できるようにします。

構文

wp_normalize_remote_block_pattern( array $pattern );
  • $pattern(array) — 正規化するブロックパターンのデータを含む配列。

例1: リモートパターンの正規化

リモートから取得したブロックパターンを正規化する基本的な例です。

$pattern = array('title' => 'My Pattern', 'content' => '<!-- wp:paragraph --><p>Hello World</p><!-- /wp:paragraph -->'); $normalized_pattern = wp_normalize_remote_block_pattern($pattern);

例2: 正規化されたパターンの利用

正規化されたパターンを利用して、ブロックエディタに表示します。

$pattern = array('title' => 'My Pattern', 'content' => '<!-- wp:paragraph --><p>Hello World</p><!-- /wp:paragraph -->'); $normalized_pattern = wp_normalize_remote_block_pattern($pattern); register_block_pattern('my-pattern', $normalized_pattern);

例3: パターンのタイトルを変更

リモートパターンのタイトルを変更して正規化します。

$pattern = array('title' => 'New Title', 'content' => '<!-- wp:paragraph --><p>Hello World</p><!-- /wp:paragraph -->'); $normalized_pattern = wp_normalize_remote_block_pattern($pattern);

例4: パターンのコンテンツをフィルタリング

パターンのコンテンツをフィルタリングして正規化します。

$pattern = array('title' => 'My Pattern', 'content' => apply_filters('my_pattern_content', '<!-- wp:paragraph --><p>Hello World</p><!-- /wp:paragraph -->')); $normalized_pattern = wp_normalize_remote_block_pattern($pattern);

例5: パターンのスラッグを追加

正規化する際にパターンのスラッグを追加します。

$pattern = array('title' => 'My Pattern', 'content' => '<!-- wp:paragraph --><p>Hello World</p><!-- /wp:paragraph -->', 'slug' => 'my-pattern'); $normalized_pattern = wp_normalize_remote_block_pattern($pattern);

例6: パターンのカテゴリーを指定

正規化する際にパターンのカテゴリーを指定します。

$pattern = array('title' => 'My Pattern', 'content' => '<!-- wp:paragraph --><p>Hello World</p><!-- /wp:paragraph -->', 'categories' => array('text')); $normalized_pattern = wp_normalize_remote_block_pattern($pattern);

例7: パターンの説明を追加

正規化する際にパターンの説明を追加します。

$pattern = array('title' => 'My Pattern', 'content' => '<!-- wp:paragraph --><p>Hello World</p><!-- /wp:paragraph -->', 'description' => 'This is a sample pattern.'); $normalized_pattern = wp_normalize_remote_block_pattern($pattern);

注意点

  • リモートから取得したパターンのデータは、信頼できるソースからのみ使用してください。
  • 正規化されたパターンは、必ずregister_block_pattern()で登録してから使用します。

関連機能：