New field group registration

[stian-overasen]

A simpler field group registration logic with new filters for overriding all field group parameters and a lot less code.

Highlights:

• Register field groups directly into core, just like we do with modules.
• New filter hogan/field_group/<name>/args for overriding all field group parameters.
• New filter hogan/field_group/default/supported_post_types for adding Hogan support to custom post types without the hassle of writing the location parameter correctly. (This filter is for the default field group only, custom field groups must define the location parameter.)
• Deprecated filters:
  • hogan/field_group/<name>/fields_before_flexible_content
  • hogan/field_group/<name>/fields_after_flexible_content
  • hogan/field_group/<name>/location
  • hogan/field_group/<name>/hide_on_screen
  • hogan/supported_post_types
• Deprecated helper functions:
  • hogan_deregister_default_field_group()
  • hogan_register_field_group()
• Removed core function get_field_group_default_location()

Test code / Examples:

Add supported for more post types to default field groups.

add_filter( 'hogan/field_group/default/supported_post_types', function( array $post_types ) : array {
  //$post_types[] = 'post'; // Add support for posts.
  return $post_types;
}, 10, 2 );

Disable default field group.

add_filter( 'hogan/field_group/default/enabled', '__return_false' );

Override default field group arguments.

add_filter( 'hogan/field_group/default/args', function( array $args ) : array {

  // Set new field group title.
  $args['title'] = 'Overridden default field group title…';

  // Set fixed modules, text only in this case.
  $args['modules'] = [ 'embed' ];

  // Add field before modules.
  $args['fields_before_flexible_content'] = [
    [
      'type'         => 'text',
      'key'          => 'field_before_modules',
      'name'         => 'before_time',
      'label'        => 'Field before modules…'
    ],
  ];

  // Add field after modules.
  $args['fields_after_flexible_content'] = [
    [
      'type'         => 'text',
      'key'          => 'field_after_modules',
      'name'         => 'aftermath',
      'label'        => 'Field after modules…',
      'placeholder'  => 'After-modules field placeholder',
    ],
  ];

  return $args;
}, 10, 1 );

Do a deprecated hide_on_screen filter for the default field group. Reinstate the format meta box.

add_filter( 'hogan/field_group/default/hide_on_screen', function( array $args ) : array {

  if ( false !== ( $key = array_search( 'format', $args ) ) ) {
    unset( $args[ $key ] );
  }

  return $args;
} );

Add new custom field group.

add_action( 'hogan/include_field_groups', function( \Dekode\Hogan\Core $core ) : void {

  $core->register_field_group( [
    'name' => 'test_group_123',
    'title' => 'Test Group 123',
    'modules' => [
      'text',
    ],
    'location' => [
      [
        [
          'param'  => 'post_type',
          'value' => 'page',
        ],
      ],
    ],
  ] );
}, 10, 1 );

[pederan]

Missing 'operator' => '==',

[stian-overasen]

Fixed.

[pederan]

Missing 'operator' => '==',

[stian-overasen]

Fixed.

[pederan]

Missing operator args in location args. Except from that: works like a charm!