has_sub_field()

Last updated Feb 17, 2022

Description

This function is deprecated. Please use the have_rows() function instead.

This function is used within a while-loop to loop through each row of a Repeater or Flexible Content field.

Unlike have_rows(), this function will take a step through the available rows each time it is called, causing undesired results when also used within an if-statment.

Parameters

has_sub_field( $field_name, $post_id );
  • $field_name (string) (Required) The name of the Repeater or Flexible Content field to be retrieved. e.g. ‘gallery_images’
  • $post_id (mixed) (Optional) The post ID where the value is saved. Defaults to the current post.

Return

(bool) True if a row exists.

Change Log

  • Deprecated in version 4.3.0

Examples

Loop through Repeater field

This example demonstrates how to loop through a repeater field called "gallery_images".

<?php if( get_field('gallery_images') ): ?>
    <?php while( has_sub_field('gallery_images') ): ?>
        <img src="<?php the_sub_field('image'); ?>" alt="<?php the_sub_field('alt'); ?>" />
    <?php endwhile; ?>
 <?php endif;

Loop through a Flexible Content field

This example demonstrates how to loop through a Flexible Content field called "content" and display various layouts.

<?php while( has_sub_field("content") ): ?>
    <?php if( get_row_layout() == "paragraph" ): ?>
        <div>
            <?php the_sub_field("content"); ?>
        </div>
    <?php elseif( get_row_layout() == "file" ): ?>
        <div>
            <a href="<?php the_sub_field("file"); ?>" ><?php the_sub_field("name"); ?></a>
        </div>
    <?php elseif( get_row_layout() == "featured_posts" ): ?>
        <div>
            <h2><?php the_sub_field("title"); ?></h2>
            <?php the_sub_field("content"); ?>
            <?php if( get_sub_field("posts") ): ?>
                <ul>
                <?php foreach( get_sub_field("posts") as $p ): ?>
                    <li><a href="<?php echo get_permalink($p->ID); ?>"><?php echo get_the_title($p->ID); ?></a></li>
                <?php endforeach; ?>
                </ul>
            <?php endif; ?>
        </div>
    <?php endif; ?>
<?php endwhile; ?>

Loop through nested Repeater fields

This example demonstrates how to loop through nested Repeater fields and display the sub field data.

<?php if( get_field('parent_repeater') ): ?>
    <?php while( has_sub_field('parent_repeater') ): ?>
        <div>
            <?php if( get_sub_field('child_repeater') ): ?>
                <ul>
                <?php while( has_sub_field('child_repeater') ): ?>
                    <li><?php the_sub_field('item'); ?></li>
                <?php endwhile; ?>
                </ul>
            <?php endif; ?>
        </div>  
    <?php endwhile; ?>
<?php endif; 

Loop through nested Repeater fields (from another $post ID)

This example demonstrates how to loop through nested Repeater fields from a different post with the ID of 123.

Note: You don’t need to specify the $post_id for any sub field functions.

<?php if( get_field('parent_repeater', 123) ): ?>
    <?php while( has_sub_field('parent_repeater', 123) ): ?>
        <div>
            <?php 

            if( get_sub_field('child_repeater') ): ?>
                <ul>
                <?php while( has_sub_field('child_repeater') ): ?>
                    <li><?php the_sub_field('item'); ?></li>
                <?php endwhile; ?>
                </ul>
            <?php endif; ?>
        </div>  
    <?php endwhile; ?>
<?php endif;

Related