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 –
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
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 –
As you can see, depending on their usage, complex fields can either contain a single unnamed group or multiple named groups.