Repeater

This field type requires the Genesis Custom Blocks Pro plugin which is available through a Genesis Pro subscription.

The Repeater field creates a field where sub-fields can be displayed repeatedly.

Repeater Field

Click image to enlarge

1. Field Label: The field label will be displayed next to the field when adding it the block to the post or page.
2. Field Name: The field name should auto-fill based on the field label, but can be customized. This will be used in the PHP as part of the block template.
3. Field Type: Choose the Repeater field type.
4. Help Text: Enter instructions to describe the data needed in the field. (optional).
5. Minimum Rows: Minimum number of rows (or sub-fields) allowed to be added to this field.
6. Maximum Rows: Maximum number of rows (or sub-fields) allowed to be added to this field.
7. Add a Sub-Field: Click to add a sub-field to this repeater field.

Repeater Sub-fields

Click image to enlarge

1. Field Label: The field label will be displayed next to the field when adding it the block to the post or page.
2. Field Name (slug): The field name should auto-fill based on the field label, but can be customized. This will be used in the PHP as part of the block template.
3. Field Type: Choose the field type.
4. Field Location: Choose a location to display the field.
   • Editor will show the field in the main editing area of a post or page.
   • Inspector will display the field in the right-hand sidebar under the block inspector.
5. Field Width: Select how widely the field should be displayed.
6. Help Text: Enter instructions to describe the data needed in the field. (optional).
7. Default Value: The default value for this sub-field when adding to the block.
8. Placeholder Text: The helper text which appears when the input is empty.
9. Depending on the field type you select for the Repeater Sub-Field, additional options will be available here. For example, because we’ve selected the Text field in the screenshot above, the Character Limit option is shown.
10. Add a Sub-Field: Click to add a sub-field to this repeater field.

PHP API Controls

• name
• label
• control
• type
• order
• help
• min
• max

Template Usage

To display the Repeater field and sub-fields in your template, use the field and sub-field names you provided.

Note: The Repeater field works with the PHP templating method only.

In this example the field’s name is pets-medical-concerns and the sub-field’s name is pets-medical-condition.

Example template file /blocks/block-example.php

<?php
 // Example Repeater Field

if ( block_rows( 'pets-medical-concerns' ) ):
    echo '<h2>Pet\'s Medical Conditions</h2>';
    echo '<ul>';

    while ( block_rows( 'pets-medical-concerns' ) ) :
        block_row( 'pets-medical-concerns' );

        echo '<li>';
        block_sub_field( 'pets-medical-condition' );
        echo '</li>';
    endwhile;

    echo '</ul>';
endif;

reset_block_rows( 'pets-medical-concerns' );

Block Usage

To use the block with the Repeater field on your site, locate it in the blocks menu.

It will then display within your post or page editor.

Click image to enlarge

And on the front end of your site.

Click image to enlarge

For more details on how to use the Repeater field, check out the associated Repeater functions:

• block_row()
• block_rows()
• block_sub_field()
• block_sub_value()
• reset_block_rows()