register_block_core_widget_group()


WordPressのregister_block_core_widget_group()関数は、ウィジェットグループを登録するために使用されます。この関数は、ブロックエディタでウィジェットをグループ化する際に役立ちます。

構文

register_block_core_widget_group( string $group_name, array $args = array() );

引数の説明:

  • $group_name(string) — ウィジェットグループの名前を指定します。
  • $args(array) — ウィジェットグループの設定オプションを指定します。

例1: 基本的なウィジェットグループの登録

この例では、シンプルなウィジェットグループを登録します。

register_block_core_widget_group( 'my_widget_group', array( 'title' => 'マイウィジェットグループ' ) );

例2: カスタムアイコン付きのウィジェットグループ

この例では、カスタムアイコンを指定してウィジェットグループを登録します。

register_block_core_widget_group( 'custom_icon_group', array( 'title' => 'カスタムアイコン', 'icon' => 'smiley' ) );

例3: ウィジェットグループに説明を追加

この例では、ウィジェットグループに説明を追加します。

register_block_core_widget_group( 'description_group', array( 'title' => '説明付きグループ', 'description' => 'これは説明です。' ) );

例4: ウィジェットグループの順序を指定

この例では、ウィジェットグループの表示順序を指定します。

register_block_core_widget_group( 'ordered_group', array( 'title' => '順序指定グループ', 'order' => 5 ) );

例5: ウィジェットグループにカスタムクラスを追加

この例では、ウィジェットグループにカスタムCSSクラスを追加します。

register_block_core_widget_group( 'custom_class_group', array( 'title' => 'カスタムクラス', 'className' => 'my-custom-class' ) );

例6: ウィジェットグループの表示条件を設定

この例では、特定の条件下でのみウィジェットグループを表示するように設定します。

register_block_core_widget_group( 'conditional_group', array( 'title' => '条件付きグループ', 'condition' => array( 'postType' => 'page' ) ) );

例7: ウィジェットグループにカスタム属性を追加

この例では、ウィジェットグループにカスタム属性を追加します。

register_block_core_widget_group( 'custom_attr_group', array( 'title' => 'カスタム属性', 'attributes' => array( 'data-custom' => 'value' ) ) );

注意点

  • ウィジェットグループ名は一意である必要があります。
  • 引数$argsは、必要に応じてカスタマイズできますが、正しいキーと値のペアを使用してください。
  • ウィジェットグループの登録は、initアクションフック内で行うことが推奨されます。

関連機能：