[ Close ] Learn more about our custom WordPress development services at htmlBurger

Documentation

Documentation > Complex Field > Usage

Usage

Complex fields act as containers to which you can add multiple groups of fields. It is represented as a table, where each row is a field group. The user is able to add infinite rows of each group. This allows to repeat a set of fields multiple times creating customizable and sortable lists. This is useful when creating image galleries, lists of data or advanced content and layout elements.

Field::make('complex', 'crb_slide')->add_fields(array(
    Field::make('text', 'title'),
    Field::make('image', 'photo'),
))

The example above shows how to make a slide show. We created a single complex field named slide, to which we attached one group of fields that represents a single slide – title and photo. The user will be able to add multiple rows of title and photo, thus creating a list of slides for the slide show.

A more advanced usage of the complex field is shown below:

Field::make('complex', 'crb_media_item')
    ->add_fields('photograph', array(
        Field::make('image', 'image'),
        Field::make('text', 'caption'),
    ))
    ->add_fields('movie', array(
        Field::make('file', 'video'),
        Field::make('text', 'title'),
        Field::make('text', 'length'),
    ))

Here we have to create a list of media items, lets say for an art exhibition. There are two types of items – photos (defined by an image and a caption) and movies (having a title, length and the video file itself). Since items have different properties, we need to define separate group for each one. Groups also must have a name, by which they will be recognized later – photograph and movie.

As you can see, depending on their usage, complex fields can either contain a single unnamed group or multiple named groups.

Excited about Carbon Fields? Spread the word!