add_sub_row() │ ACF 5.2.3

This function will add a row of data to a field

No Hooks.

Returns

(true|false).

Usage

add_sub_row( $selector, $row, $post_id );

$selector(required)

.

$row

.
Default: false

$post_id

.
Default: false

Changelog

add_sub_row() add sub row code ^{ACF 6.8.8}

function add_sub_row( $selector, $row = false, $post_id = false ) {

	// vars
	$sub_field = false;

	// get sub field
	if ( is_array( $selector ) ) {
		$post_id   = acf_get_valid_post_id( $post_id );
		$sub_field = acf_maybe_get_sub_field( $selector, $post_id, false );
	} else {
		$post_id   = acf_get_loop( 'active', 'post_id' );
		$sub_field = get_row_sub_field( $selector );
	}

	// bail early if no sub field
	if ( ! $sub_field ) {
		return false;
	}

	// get raw value
	$value = acf_get_value( $post_id, $sub_field );

	// ensure array
	$value = acf_get_array( $value );

	// append
	$value[] = $row;

	// update
	acf_update_value( $value, $post_id, $sub_field );

	// return
	return count( $value );
}