register_block_core_gallery()


WordPressのregister_block_core_gallery()関数は、ギャラリーブロックを登録するために使用されます。この関数を使うことで、カスタムギャラリーブロックを簡単に作成し、管理画面やフロントエンドで利用することができます。

構文

register_block_core_gallery( string $block_type, array $args = array() );

引数の説明:

  • $block_type(string) — 登録するブロックのタイプ名。
  • $args(array) — ブロックの設定オプションを含む配列。

例1: 基本的なギャラリーブロックの登録

この例では、シンプルなギャラリーブロックを登録します。

register_block_core_gallery( 'my-plugin/my-gallery', array( 'title' => 'マイギャラリー' ) );

例2: カスタム属性を持つギャラリーブロック

カスタム属性を追加してギャラリーブロックを登録します。

register_block_core_gallery( 'my-plugin/custom-gallery', array( 'attributes' => array( 'columns' => array( 'type' => 'number', 'default' => 3 ) ) ) );

例3: カスタムスタイルの追加

ギャラリーブロックにカスタムスタイルを追加します。

register_block_core_gallery( 'my-plugin/styled-gallery', array( 'style' => 'my-plugin-gallery-style' ) );

例4: カスタムスクリプトの追加

ギャラリーブロックにカスタムスクリプトを追加します。

register_block_core_gallery( 'my-plugin/scripted-gallery', array( 'script' => 'my-plugin-gallery-script' ) );

例5: カスタムエディタースタイルの追加

エディター内で使用するカスタムスタイルを追加します。

register_block_core_gallery( 'my-plugin/editor-styled-gallery', array( 'editor_style' => 'my-plugin-gallery-editor-style' ) );

例6: カスタムカテゴリーの追加

ギャラリーブロックを特定のカテゴリーに追加します。

register_block_core_gallery( 'my-plugin/categorized-gallery', array( 'category' => 'my-custom-category' ) );

例7: カスタムアイコンの設定

ギャラリーブロックにカスタムアイコンを設定します。

register_block_core_gallery( 'my-plugin/icon-gallery', array( 'icon' => 'format-gallery' ) );

注意点

  • ブロックタイプ名は一意である必要があります。
  • カスタム属性やスタイルを追加する際は、適切なタイプやハンドル名を使用してください。
  • スクリプトやスタイルを追加する場合は、事前にそれらを登録しておく必要があります。

関連機能：