register_block_core_media_text()


WordPressのregister_block_core_media_text()関数は、メディアとテキストを組み合わせたブロックを登録するために使用されます。このブロックは、画像や動画などのメディアとテキストを並べて表示するためのものです。

構文

register_block_core_media_text( array $args );

引数の説明:

  • $args(array) — ブロックの設定を定義する配列。以下のキーを含むことができます。
    • 'name'(string) — ブロックの名前。
    • 'title'(string) — ブロックのタイトル。
    • 'description'(string) — ブロックの説明。
    • 'category'(string) — ブロックが属するカテゴリー。
    • 'icon'(string) — ブロックのアイコン。
    • 'keywords'(array) — ブロックの検索キーワード。

例1: 基本的なメディアとテキストブロックの登録

この例では、シンプルなメディアとテキストブロックを登録します。

register_block_core_media_text( array( 'name' => 'core/media-text', 'title' => 'メディアとテキスト', 'category' => 'common', 'icon' => 'format-image' ) );

例2: カスタムアイコンを使用したブロック登録

カスタムアイコンを指定してブロックを登録します。

register_block_core_media_text( array( 'name' => 'core/media-text', 'title' => 'カスタムメディアブロック', 'icon' => 'smiley' ) );

例3: カテゴリーとキーワードを指定したブロック登録

カテゴリーとキーワードを指定してブロックを登録します。

register_block_core_media_text( array( 'name' => 'core/media-text', 'title' => 'メディアブロック', 'category' => 'widgets', 'keywords' => array( '画像', 'テキスト', 'メディア' ) ) );

例4: ブロックの説明を追加

ブロックの説明を追加して登録します。

register_block_core_media_text( array( 'name' => 'core/media-text', 'title' => 'メディアとテキスト', 'description' => '画像や動画とテキストを並べて表示するブロックです。' ) );

例5: 複数のキーワードを指定

複数のキーワードを指定してブロックを登録します。

register_block_core_media_text( array( 'name' => 'core/media-text', 'title' => 'メディアブロック', 'keywords' => array( '画像', '動画', 'テキスト', 'レイアウト' ) ) );

例6: カスタムカテゴリーを使用

カスタムカテゴリーを指定してブロックを登録します。

register_block_core_media_text( array( 'name' => 'core/media-text', 'title' => 'メディアとテキスト', 'category' => 'custom-category' ) );

注意点

  • ブロックを登録する際は、initアクションフック内で行う必要があります。
  • ブロックの名前は一意である必要があります。
  • カテゴリーやアイコンは、既存のものを使用するか、カスタムで定義することができます。

関連機能：