NebulaPanel - Control Interface

✏️ Editing: class-acf-field-flexible-content.php

<?php

if ( ! class_exists( 'acf_field_flexible_content' ) ) :

class acf_field_flexible_content extends acf_field {

/*
		*  __construct
		*
		*  This function will setup the field type data
		*
		*  @type    function
		*  @date    5/03/2014
		*  @since   5.0.0
		*
		*  @param   n/a
		*  @return  n/a
		*/

function initialize() {

// vars
			$this->name     = 'flexible_content';
			$this->label    = __( 'Flexible Content', 'acf' );
			$this->category = 'layout';
			$this->defaults = array(
				'layouts'      => array(),
				'min'          => '',
				'max'          => '',
				'button_label' => __( 'Add Row', 'acf' ),
			);

// ajax
			$this->add_action( 'wp_ajax_acf/fields/flexible_content/layout_title', array( $this, 'ajax_layout_title' ) );
			$this->add_action( 'wp_ajax_nopriv_acf/fields/flexible_content/layout_title', array( $this, 'ajax_layout_title' ) );

// filters
			$this->add_filter( 'acf/prepare_field_for_export', array( $this, 'prepare_any_field_for_export' ) );
			$this->add_filter( 'acf/clone_field', array( $this, 'clone_any_field' ), 10, 2 );
			$this->add_filter( 'acf/validate_field', array( $this, 'validate_any_field' ) );

// field filters
			$this->add_field_filter( 'acf/get_sub_field', array( $this, 'get_sub_field' ), 10, 3 );
			$this->add_field_filter( 'acf/prepare_field_for_export', array( $this, 'prepare_field_for_export' ) );
			$this->add_field_filter( 'acf/prepare_field_for_import', array( $this, 'prepare_field_for_import' ) );

}

/*
		*  input_admin_enqueue_scripts
		*
		*  description
		*
		*  @type    function
		*  @date    16/12/2015
		*  @since   5.3.2
		*
		*  @param   $post_id (int)
		*  @return  $post_id (int)
		*/

function input_admin_enqueue_scripts() {

// localize
			acf_localize_text(
				array(

// identifiers
					'layout'  => __( 'layout', 'acf' ),
					'layouts' => __( 'layouts', 'acf' ),

// min / max
					'This field requires at least {min} {label} {identifier}' => __( 'This field requires at least {min} {label} {identifier}', 'acf' ),
					'This field has a limit of {max} {label} {identifier}' => __( 'This field has a limit of {max} {label} {identifier}', 'acf' ),

// popup badge
					'{available} {label} {identifier} available (max {max})' => __( '{available} {label} {identifier} available (max {max})', 'acf' ),
					'{required} {label} {identifier} required (min {min})' => __( '{required} {label} {identifier} required (min {min})', 'acf' ),

// field settings
					'Flexible Content requires at least 1 layout' => __( 'Flexible Content requires at least 1 layout', 'acf' ),
				)
			);
		}

/*
		*  get_valid_layout
		*
		*  This function will fill in the missing keys to create a valid layout
		*
		*  @type    function
		*  @date    3/10/13
		*  @since   1.1.0
		*
		*  @param   $layout (array)
		*  @return  $layout (array)
		*/

function get_valid_layout( $layout = array() ) {

// parse
			$layout = wp_parse_args(
				$layout,
				array(
					'key'        => uniqid( 'layout_' ),
					'name'       => '',
					'label'      => '',
					'display'    => 'block',
					'sub_fields' => array(),
					'min'        => '',
					'max'        => '',
				)
			);

// return
			return $layout;
		}

/*
		*  load_field()
		*
		*  This filter is appied to the $field after it is loaded from the database
		*
		*  @type    filter
		*  @since   3.6
		*  @date    23/01/13
		*
		*  @param   $field - the field array holding all the field options
		*
		*  @return  $field - the field array holding all the field options
		*/

function load_field( $field ) {

// bail early if no field layouts
			if ( empty( $field['layouts'] ) ) {

return $field;

}

// vars
			$sub_fields = acf_get_fields( $field );

// loop through layouts, sub fields and swap out the field key with the real field
			foreach ( array_keys( $field['layouts'] ) as $i ) {

// extract layout
				$layout = acf_extract_var( $field['layouts'], $i );

// validate layout
				$layout = $this->get_valid_layout( $layout );

// append sub fields
				if ( ! empty( $sub_fields ) ) {

foreach ( array_keys( $sub_fields ) as $k ) {

// check if 'parent_layout' is empty
						if ( empty( $sub_fields[ $k ]['parent_layout'] ) ) {

// parent_layout did not save for this field, default it to first layout
							$sub_fields[ $k ]['parent_layout'] = $layout['key'];

}

// append sub field to layout,
						if ( $sub_fields[ $k ]['parent_layout'] == $layout['key'] ) {

$layout['sub_fields'][] = acf_extract_var( $sub_fields, $k );

}
					}
				}

// append back to layouts
				$field['layouts'][ $i ] = $layout;

}

// return
			return $field;
		}

/*
		*  get_sub_field
		*
		*  This function will return a specific sub field
		*
		*  @type    function
		*  @date    29/09/2016
		*  @since   5.4.0
		*
		*  @param   $sub_field
		*  @param   $selector (string)
		*  @param   $field (array)
		*  @return  $post_id (int)
		*/
		function get_sub_field( $sub_field, $id, $field ) {

// Get active layout.
			$active = get_row_layout();

// Loop over layouts.
			if ( $field['layouts'] ) {
				foreach ( $field['layouts'] as $layout ) {

// Restict to active layout if within a have_rows() loop.
					if ( $active && $active !== $layout['name'] ) {
						continue;
					}

// Check sub fields.
					if ( $layout['sub_fields'] ) {
						$sub_field = acf_search_fields( $id, $layout['sub_fields'] );
						if ( $sub_field ) {
							break;
						}
					}
				}
			}

// return
			return $sub_field;
		}

/*
		*  render_field()
		*
		*  Create the HTML interface for your field
		*
		*  @param   $field - an array holding all the field's data
		*
		*  @type    action
		*  @since   3.6
		*  @date    23/01/13
		*/

function render_field( $field ) {

// defaults
			if ( empty( $field['button_label'] ) ) {

$field['button_label'] = $this->defaults['button_label'];

}

// sort layouts into names
			$layouts = array();

foreach ( $field['layouts'] as $k => $layout ) {

$layouts[ $layout['name'] ] = $layout;

}

// vars
			$div = array(
				'class'    => 'acf-flexible-content',
				'data-min' => $field['min'],
				'data-max' => $field['max'],
			);

// empty
			if ( empty( $field['value'] ) ) {
				$div['class'] .= ' -empty';
			}

// no value message
			$no_value_message = __( 'Click the "%s" button below to start creating your layout', 'acf' );
			$no_value_message = apply_filters( 'acf/fields/flexible_content/no_value_message', $no_value_message, $field );
			$no_value_message = sprintf( $no_value_message, $field['button_label'] );

?>
<div <?php acf_esc_attr_e( $div ); ?>>
	
			<?php acf_hidden_input( array( 'name' => $field['name'] ) ); ?>
	
	<div class="no-value-message">
			<?php echo acf_esc_html( $no_value_message ); ?>
	</div>
	
	<div class="clones">
			<?php foreach ( $layouts as $layout ) : ?>
				<?php $this->render_layout( $field, $layout, 'acfcloneindex', array() ); ?>
		<?php endforeach; ?>
	</div>
	
	<div class="values">
			<?php
			if ( ! empty( $field['value'] ) ) :

foreach ( $field['value'] as $i => $value ) :

// validate
					if ( empty( $layouts[ $value['acf_fc_layout'] ] ) ) {
						continue;
					}

// render
					$this->render_layout( $field, $layouts[ $value['acf_fc_layout'] ], $i, $value );

endforeach;

endif;
			?>
	</div>
	
	<div class="acf-actions">
		<a class="acf-button button button-primary" href="#" data-name="add-layout"><?php echo acf_esc_html( $field['button_label'] ); ?></a>
	</div>
	
	<script type="text-html" class="tmpl-popup"><ul>
			<?php
			foreach ( $layouts as $layout ) :

$atts = array(
						'href'        => '#',
						'data-layout' => $layout['name'],
						'data-min'    => $layout['min'],
						'data-max'    => $layout['max'],
					);

?>
			<li><a <?php acf_esc_attr_e( $atts ); ?>><?php echo acf_esc_html( $layout['label'] ); ?></a></li>
				<?php

endforeach;
			?>
</ul>
	</script>
	
</div>
			<?php

}

/*
		*  render_layout
		*
		*  description
		*
		*  @type    function
		*  @date    19/11/2013
		*  @since   5.0.0
		*
		*  @param   $post_id (int)
		*  @return  $post_id (int)
		*/

function render_layout( $field, $layout, $i, $value ) {

// vars
			$order      = 0;
			$el         = 'div';
			$sub_fields = $layout['sub_fields'];
			$id         = ( $i === 'acfcloneindex' ) ? 'acfcloneindex' : "row-$i";
			$prefix     = $field['name'] . '[' . $id . ']';

// div
			$div = array(
				'class'       => 'layout',
				'data-id'     => $id,
				'data-layout' => $layout['name'],
			);

// clone
			if ( is_numeric( $i ) ) {

$order = $i + 1;

} else {

$div['class'] .= ' acf-clone';

}

// display
			if ( $layout['display'] == 'table' ) {

$el = 'td';

}

// title
			$title = $this->get_layout_title( $field, $layout, $i, $value );

// remove row
			reset_rows();

?>
<div <?php echo acf_esc_attr( $div ); ?>>
			
			<?php
			acf_hidden_input(
				array(
					'name'  => $prefix . '[acf_fc_layout]',
					'value' => $layout['name'],
				)
			);
			?>
	
	<div class="acf-fc-layout-handle" title="<?php _e( 'Drag to reorder', 'acf' ); ?>" data-name="collapse-layout"><?php echo acf_esc_html( $title ); ?></div>
	
	<div class="acf-fc-layout-controls">
		<a class="acf-icon -plus small light acf-js-tooltip" href="#" data-name="add-layout" title="<?php _e( 'Add layout', 'acf' ); ?>"></a>
		<a class="acf-icon -duplicate small light acf-js-tooltip" href="#" data-name="duplicate-layout" title="<?php _e( 'Duplicate layout', 'acf' ); ?>"></a>
		<a class="acf-icon -minus small light acf-js-tooltip" href="#" data-name="remove-layout" title="<?php _e( 'Remove layout', 'acf' ); ?>"></a>
		<a class="acf-icon -collapse small -clear acf-js-tooltip" href="#" data-name="collapse-layout" title="<?php _e( 'Click to toggle', 'acf' ); ?>"></a>
	</div>
	
			<?php if ( ! empty( $sub_fields ) ) : ?>
	
				<?php if ( $layout['display'] == 'table' ) : ?>
	<table class="acf-table">
		
		<thead>
			<tr>
					<?php
					foreach ( $sub_fields as $sub_field ) :

// Set prefix to generate correct "for" attribute on <label>.
						$sub_field['prefix'] = $prefix;

// Prepare field (allow sub fields to be removed).
						$sub_field = acf_prepare_field( $sub_field );
						if ( ! $sub_field ) {
							continue;
						}

// Define attrs.
						$attrs              = array();
						$attrs['class']     = 'acf-th';
						$attrs['data-name'] = $sub_field['_name'];
						$attrs['data-type'] = $sub_field['type'];
						$attrs['data-key']  = $sub_field['key'];

if ( $sub_field['wrapper']['width'] ) {
							$attrs['data-width'] = $sub_field['wrapper']['width'];
							$attrs['style']      = 'width: ' . $sub_field['wrapper']['width'] . '%;';
						}

?>
					<th <?php acf_esc_attr_e( $attrs ); ?>>
						<?php acf_render_field_label( $sub_field ); ?>
						<?php acf_render_field_instructions( $sub_field ); ?>
					</th>
					<?php endforeach; ?> 
			</tr>
		</thead>
		
		<tbody>
			<tr class="acf-row">
	<?php else : ?>
	<div class="acf-fields 
		<?php
		if ( $layout['display'] == 'row' ) :
			?>
		-left<?php endif; ?>">
	<?php endif; ?>
	
					<?php

// loop though sub fields
					foreach ( $sub_fields as $sub_field ) {

// add value
						if ( isset( $value[ $sub_field['key'] ] ) ) {

// this is a normal value
							$sub_field['value'] = $value[ $sub_field['key'] ];

} elseif ( isset( $sub_field['default_value'] ) ) {

// no value, but this sub field has a default value
							$sub_field['value'] = $sub_field['default_value'];

}

// update prefix to allow for nested values
						$sub_field['prefix'] = $prefix;

// render input
						acf_render_field_wrap( $sub_field, $el );

}

?>
			
				<?php if ( $layout['display'] == 'table' ) : ?>
			</tr>
		</tbody>
	</table>
	<?php else : ?>
	</div>
	<?php endif; ?>

<?php endif; ?>

</div>
			<?php

}

/*
		*  render_field_settings()
		*
		*  Create extra options for your field. This is rendered when editing a field.
		*  The value of $field['name'] can be used (like bellow) to save extra data to the $field
		*
		*  @type    action
		*  @since   3.6
		*  @date    23/01/13
		*
		*  @param   $field  - an array holding all the field's data
		*/

function render_field_settings( $field ) {

// load default layout
			if ( empty( $field['layouts'] ) ) {

$field['layouts'] = array(
					array(),
				);

}

// loop through layouts
			foreach ( $field['layouts'] as $layout ) {

// get valid layout
				$layout = $this->get_valid_layout( $layout );

// vars
				$layout_prefix = "{$field['prefix']}[layouts][{$layout['key']}]";

?>
				<tr class="acf-field acf-field-setting-fc_layout" data-name="fc_layout" data-setting="flexible_content" data-id="<?php echo esc_attr( $layout['key'] ); ?>">
	<td class="acf-label">
		<label><?php _e( 'Layout', 'acf' ); ?></label>
		<ul class="acf-bl acf-fl-actions">
			<li><a class="reorder-layout" href="#" title="<?php _e( 'Reorder Layout', 'acf' ); ?>"><?php _e( 'Reorder', 'acf' ); ?></a></li>
			<li><a class="delete-layout" href="#" title="<?php _e( 'Delete Layout', 'acf' ); ?>"><?php _e( 'Delete', 'acf' ); ?></a></li>
			<li><a class="duplicate-layout" href="#" title="<?php _e( 'Duplicate Layout', 'acf' ); ?>"><?php _e( 'Duplicate', 'acf' ); ?></a></li>
			<li><a class="add-layout" href="#" title="<?php _e( 'Add New Layout', 'acf' ); ?>"><?php _e( 'Add New', 'acf' ); ?></a></li>
		</ul>
	</td>
	<td class="acf-input">
				<?php

acf_hidden_input(
					array(
						'id'    => acf_idify( $layout_prefix . '[key]' ),
						'name'  => $layout_prefix . '[key]',
						'class' => 'layout-key',
						'value' => $layout['key'],
					)
				);

?>
		<ul class="acf-fc-meta acf-bl">
			<li class="acf-fc-meta-label">
				<?php

acf_render_field(
					array(
						'type'    => 'text',
						'name'    => 'label',
						'class'   => 'layout-label',
						'prefix'  => $layout_prefix,
						'value'   => $layout['label'],
						'prepend' => __( 'Label', 'acf' ),
					)
				);

?>
			</li>
			<li class="acf-fc-meta-name">
					<?php

acf_render_field(
						array(
							'type'    => 'text',
							'name'    => 'name',
							'class'   => 'layout-name',
							'prefix'  => $layout_prefix,
							'value'   => $layout['name'],
							'prepend' => __( 'Name', 'acf' ),
						)
					);

?>
			</li>
			<li class="acf-fc-meta-display">
				<div class="acf-input-prepend"><?php _e( 'Layout', 'acf' ); ?></div>
				<div class="acf-input-wrap">
					<?php

acf_render_field(
						array(
							'type'    => 'select',
							'name'    => 'display',
							'prefix'  => $layout_prefix,
							'value'   => $layout['display'],
							'class'   => 'acf-is-prepended',
							'choices' => array(
								'table' => __( 'Table', 'acf' ),
								'block' => __( 'Block', 'acf' ),
								'row'   => __( 'Row', 'acf' ),
							),
						)
					);

?>
				</div>
			</li>
			<li class="acf-fc-meta-min">
					<?php

acf_render_field(
						array(
							'type'    => 'text',
							'name'    => 'min',
							'prefix'  => $layout_prefix,
							'value'   => $layout['min'],
							'prepend' => __( 'Min', 'acf' ),
						)
					);

?>
			</li>
			<li class="acf-fc-meta-max">
					<?php

acf_render_field(
						array(
							'type'    => 'text',
							'name'    => 'max',
							'prefix'  => $layout_prefix,
							'value'   => $layout['max'],
							'prepend' => __( 'Max', 'acf' ),
						)
					);

?>
			</li>
		</ul>
				<?php

// vars
				$args = array(
					'fields' => $layout['sub_fields'],
					'parent' => $field['ID'],
				);

acf_get_view( 'field-group-fields', $args );

?>
	</td>
</tr>
				<?php

}
			// endforeach

// min
			acf_render_field_setting(
				$field,
				array(
					'label'        => __( 'Button Label', 'acf' ),
					'instructions' => '',
					'type'         => 'text',
					'name'         => 'button_label',
				)
			);

// min
			acf_render_field_setting(
				$field,
				array(
					'label'        => __( 'Minimum Layouts', 'acf' ),
					'instructions' => '',
					'type'         => 'number',
					'name'         => 'min',
				)
			);

// max
			acf_render_field_setting(
				$field,
				array(
					'label'        => __( 'Maximum Layouts', 'acf' ),
					'instructions' => '',
					'type'         => 'number',
					'name'         => 'max',
				)
			);

}

/*
		*  load_value()
		*
		*  This filter is applied to the $value after it is loaded from the db
		*
		*  @type    filter
		*  @since   3.6
		*  @date    23/01/13
		*
		*  @param   $value (mixed) the value found in the database
		*  @param   $post_id (mixed) the $post_id from which the value was loaded
		*  @param   $field (array) the field array holding all the field options
		*  @return  $value
		*/

function load_value( $value, $post_id, $field ) {

// bail early if no value
			if ( empty( $value ) || empty( $field['layouts'] ) ) {

return $value;

}

// value must be an array
			$value = acf_get_array( $value );

// vars
			$rows = array();

// sort layouts into names
			$layouts = array();
			foreach ( $field['layouts'] as $k => $layout ) {

$layouts[ $layout['name'] ] = $layout['sub_fields'];

}

// loop through rows
			foreach ( $value as $i => $l ) {

// append to $values
				$rows[ $i ]                  = array();
				$rows[ $i ]['acf_fc_layout'] = $l;

// bail early if layout deosnt contain sub fields
				if ( empty( $layouts[ $l ] ) ) {

continue;

}

// get layout
				$layout = $layouts[ $l ];

// loop through sub fields
				foreach ( array_keys( $layout ) as $j ) {

// get sub field
					$sub_field = $layout[ $j ];

// bail ealry if no name (tab)
					if ( acf_is_empty( $sub_field['name'] ) ) {
						continue;
					}

// update full name
					$sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";

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

// add value
					$rows[ $i ][ $sub_field['key'] ] = $sub_value;

}
				// foreach

}
			// foreach

// return
			return $rows;

}

/*
		*  format_value()
		*
		*  This filter is appied to the $value after it is loaded from the db and before it is returned to the template
		*
		*  @type    filter
		*  @since   3.6
		*  @date    23/01/13
		*
		*  @param   $value (mixed) the value which was loaded from the database
		*  @param   $post_id (mixed) the $post_id from which the value was loaded
		*  @param   $field (array) the field array holding all the field options
		*
		*  @return  $value (mixed) the modified value
		*/

function format_value( $value, $post_id, $field ) {

// bail early if no value
			if ( empty( $value ) || empty( $field['layouts'] ) ) {

return false;

}

// sort layouts into names
			$layouts = array();
			foreach ( $field['layouts'] as $k => $layout ) {

$layouts[ $layout['name'] ] = $layout['sub_fields'];

}

// loop over rows
			foreach ( array_keys( $value ) as $i ) {

// get layout name
				$l = $value[ $i ]['acf_fc_layout'];

// bail early if layout deosnt exist
				if ( empty( $layouts[ $l ] ) ) {
					continue;
				}

// get layout
				$layout = $layouts[ $l ];

// loop through sub fields
				foreach ( array_keys( $layout ) as $j ) {

// get sub field
					$sub_field = $layout[ $j ];

// bail ealry if no name (tab)
					if ( acf_is_empty( $sub_field['name'] ) ) {
						continue;
					}

// extract value
					$sub_value = acf_extract_var( $value[ $i ], $sub_field['key'] );

// update $sub_field name
					$sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";

// format value
					$sub_value = acf_format_value( $sub_value, $post_id, $sub_field );

// append to $row
					$value[ $i ][ $sub_field['_name'] ] = $sub_value;

}
			}

// return
			return $value;
		}

/*
		*  validate_value
		*
		*  description
		*
		*  @type    function
		*  @date    11/02/2014
		*  @since   5.0.0
		*
		*  @param   $post_id (int)
		*  @return  $post_id (int)
		*/

function validate_value( $valid, $value, $field, $input ) {

// vars
			$count = 0;

// check if is value (may be empty string)
			if ( is_array( $value ) ) {

// remove acfcloneindex
				if ( isset( $value['acfcloneindex'] ) ) {
					unset( $value['acfcloneindex'] );
				}

// count
				$count = count( $value );
			}

// validate required
			if ( $field['required'] && ! $count ) {
				$valid = false;
			}

// validate min
			$min = (int) $field['min'];
			if ( $min && $count < $min ) {

// vars
				$error      = __( 'This field requires at least {min} {label} {identifier}', 'acf' );
				$identifier = _n( 'layout', 'layouts', $min );

// replace
				$error = str_replace( '{min}', $min, $error );
				$error = str_replace( '{label}', '', $error );
				$error = str_replace( '{identifier}', $identifier, $error );

// return
				return $error;
			}

// find layouts
			$layouts = array();
			foreach ( array_keys( $field['layouts'] ) as $i ) {

// vars
				$layout = $field['layouts'][ $i ];

// add count
				$layout['count'] = 0;

// append
				$layouts[ $layout['name'] ] = $layout;
			}

// validate value
			if ( $count ) {

// loop rows
				foreach ( $value as $i => $row ) {

// get layout
					$l = $row['acf_fc_layout'];

// bail if layout doesn't exist
					if ( ! isset( $layouts[ $l ] ) ) {
						continue;
					}

// increase count
					$layouts[ $l ]['count']++;

// bail if no sub fields
					if ( empty( $layouts[ $l ]['sub_fields'] ) ) {
						continue;
					}

// loop sub fields
					foreach ( $layouts[ $l ]['sub_fields'] as $sub_field ) {

// get sub field key
						$k = $sub_field['key'];

// bail if no value
						if ( ! isset( $value[ $i ][ $k ] ) ) {
							continue;
						}

// validate
						acf_validate_value( $value[ $i ][ $k ], $sub_field, "{$input}[{$i}][{$k}]" );
					}
					// end loop sub fields

}
				// end loop rows
			}

// validate layouts
			foreach ( $layouts as $layout ) {

// validate min / max
				$min   = (int) $layout['min'];
				$count = $layout['count'];
				$label = $layout['label'];

if ( $min && $count < $min ) {

// vars
					$error      = __( 'This field requires at least {min} {label} {identifier}', 'acf' );
					$identifier = _n( 'layout', 'layouts', $min );

// replace
					$error = str_replace( '{min}', $min, $error );
					$error = str_replace( '{label}', '"' . $label . '"', $error );
					$error = str_replace( '{identifier}', $identifier, $error );

// return
					return $error;
				}
			}

// return
			return $valid;
		}

/**
		 * This function will return a specific layout by name from a field
		 *
		 * @date    15/2/17
		 * @since   5.5.8
		 *
		 * @param   string $name
		 * @param   array  $field
		 * @return  array|false
		 */
		function get_layout( $name, $field ) {

// bail early if no layouts
			if ( ! isset( $field['layouts'] ) ) {
				return false;
			}

// loop
			foreach ( $field['layouts'] as $layout ) {

// match
				if ( $layout['name'] === $name ) {
					return $layout;
				}
			}

// return
			return false;

}

/**
		 * This function will delete a value row
		 *
		 * @date    15/2/17
		 * @since   5.5.8
		 *
		 * @param   int   $i
		 * @param   array $field
		 * @param   mixed $post_id
		 * @return  bool
		 */
		function delete_row( $i, $field, $post_id ) {

// vars
			$value = acf_get_metadata( $post_id, $field['name'] );

// bail early if no value
			if ( ! is_array( $value ) || ! isset( $value[ $i ] ) ) {
				return false;
			}

// get layout
			$layout = $this->get_layout( $value[ $i ], $field );

// bail early if no layout
			if ( ! $layout || empty( $layout['sub_fields'] ) ) {
				return false;
			}

// loop
			foreach ( $layout['sub_fields'] as $sub_field ) {

// modify name for delete
				$sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";

// delete value
				acf_delete_value( $post_id, $sub_field );

}

// return
			return true;

}

/**
		 * This function will update a value row
		 *
		 * @date    15/2/17
		 * @since   5.5.8
		 *
		 * @param   array $row
		 * @param   int   $i
		 * @param   array $field
		 * @param   mixed $post_id
		 * @return  bool
		 */
		function update_row( $row, $i, $field, $post_id ) {

// bail early if no layout reference
			if ( ! is_array( $row ) || ! isset( $row['acf_fc_layout'] ) ) {
				return false;
			}

// get layout
			$layout = $this->get_layout( $row['acf_fc_layout'], $field );

// bail early if no layout
			if ( ! $layout || empty( $layout['sub_fields'] ) ) {
				return false;
			}

// loop
			foreach ( $layout['sub_fields'] as $sub_field ) {

// value
				$value = null;

// find value (key)
				if ( isset( $row[ $sub_field['key'] ] ) ) {

$value = $row[ $sub_field['key'] ];

// find value (name)
				} elseif ( isset( $row[ $sub_field['name'] ] ) ) {

$value = $row[ $sub_field['name'] ];

// value does not exist
				} else {

continue;

}

// modify name for save
				$sub_field['name'] = "{$field['name']}_{$i}_{$sub_field['name']}";

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

}

// return
			return true;

}

/*
		*  update_value()
		*
		*  This filter is appied to the $value before it is updated in the db
		*
		*  @type    filter
		*  @since   3.6
		*  @date    23/01/13
		*
		*  @param   $value - the value which will be saved in the database
		*  @param   $field - the field array holding all the field options
		*  @param   $post_id - the $post_id of which the value will be saved
		*
		*  @return  $value - the modified value
		*/

function update_value( $value, $post_id, $field ) {

// bail early if no layouts
			if ( empty( $field['layouts'] ) ) {
				return $value;
			}

// vars
			$new_value = array();
			$old_value = acf_get_metadata( $post_id, $field['name'] );
			$old_value = is_array( $old_value ) ? $old_value : array();

// update
			if ( ! empty( $value ) ) {
				$i = -1;

// remove acfcloneindex
				if ( isset( $value['acfcloneindex'] ) ) {

unset( $value['acfcloneindex'] );

}

// loop through rows
				foreach ( $value as $row ) {
					$i++;

// bail early if no layout reference
					if ( ! is_array( $row ) || ! isset( $row['acf_fc_layout'] ) ) {
						continue;
					}

// delete old row if layout has changed
					if ( isset( $old_value[ $i ] ) && $old_value[ $i ] !== $row['acf_fc_layout'] ) {

$this->delete_row( $i, $field, $post_id );

}

// update row
					$this->update_row( $row, $i, $field, $post_id );

// append to order
					$new_value[] = $row['acf_fc_layout'];

}
			}

// vars
			$old_count = empty( $old_value ) ? 0 : count( $old_value );
			$new_count = empty( $new_value ) ? 0 : count( $new_value );

// remove old rows
			if ( $old_count > $new_count ) {

// loop
				for ( $i = $new_count; $i < $old_count; $i++ ) {

$this->delete_row( $i, $field, $post_id );

}
			}

// save false for empty value
			if ( empty( $new_value ) ) {
				$new_value = '';
			}

// return
			return $new_value;

}

/*
		*  delete_value
		*
		*  description
		*
		*  @type    function
		*  @date    1/07/2015
		*  @since   5.2.3
		*
		*  @param   $post_id (int)
		*  @return  $post_id (int)
		*/

function delete_value( $post_id, $key, $field ) {

// vars
			$old_value = acf_get_metadata( $post_id, $field['name'] );
			$old_value = is_array( $old_value ) ? $old_value : array();

// bail early if no rows or no sub fields
			if ( empty( $old_value ) ) {
				return;
			}

// loop
			foreach ( array_keys( $old_value ) as $i ) {

$this->delete_row( $i, $field, $post_id );

}

/*
		*  update_field()
		*
		*  This filter is appied to the $field before it is saved to the database
		*
		*  @type    filter
		*  @since   3.6
		*  @date    23/01/13
		*
		*  @param   $field - the field array holding all the field options
		*  @param   $post_id - the field group ID (post_type = acf)
		*
		*  @return  $field - the modified field
		*/

function update_field( $field ) {

// loop
			if ( ! empty( $field['layouts'] ) ) {

foreach ( $field['layouts'] as &$layout ) {

unset( $layout['sub_fields'] );

}
			}

// return
			return $field;
		}

/*
		*  delete_field
		*
		*  description
		*
		*  @type    function
		*  @date    4/04/2014
		*  @since   5.0.0
		*
		*  @param   $post_id (int)
		*  @return  $post_id (int)
		*/

function delete_field( $field ) {

if ( ! empty( $field['layouts'] ) ) {

// loop through layouts
				foreach ( $field['layouts'] as $layout ) {

// loop through sub fields
					if ( ! empty( $layout['sub_fields'] ) ) {

foreach ( $layout['sub_fields'] as $sub_field ) {

acf_delete_field( $sub_field['ID'] );

}
						// foreach

}
					// if

}
				// foreach

}
			// if
		}

/*
		*  duplicate_field()
		*
		*  This filter is appied to the $field before it is duplicated and saved to the database
		*
		*  @type    filter
		*  @since   3.6
		*  @date    23/01/13
		*
		*  @param   $field - the field array holding all the field options
		*
		*  @return  $field - the modified field
		*/

function duplicate_field( $field ) {

// vars
			$sub_fields = array();

if ( ! empty( $field['layouts'] ) ) {

// loop through layouts
				foreach ( $field['layouts'] as $layout ) {

// extract sub fields
					$extra = acf_extract_var( $layout, 'sub_fields' );

// merge
					if ( ! empty( $extra ) ) {

$sub_fields = array_merge( $sub_fields, $extra );

}
				}
				// foreach

}
			// if

// save field to get ID
			$field = acf_update_field( $field );

// duplicate sub fields
			acf_duplicate_fields( $sub_fields, $field['ID'] );

// return
			return $field;

}

/*
		*  ajax_layout_title
		*
		*  description
		*
		*  @type    function
		*  @date    2/03/2016
		*  @since   5.3.2
		*
		*  @param   $post_id (int)
		*  @return  $post_id (int)
		*/

function ajax_layout_title() {

// options
			$options = acf_parse_args(
				$_POST,
				array(
					'post_id'   => 0,
					'i'         => 0,
					'field_key' => '',
					'nonce'     => '',
					'layout'    => '',
					'value'     => array(),
				)
			);

// load field
			$field = acf_get_field( $options['field_key'] );
			if ( ! $field ) {
				die();
			}

// vars
			$layout = $this->get_layout( $options['layout'], $field );
			if ( ! $layout ) {
				die();
			}

// title
			$title = $this->get_layout_title( $field, $layout, $options['i'], $options['value'] );

// echo
			echo $title;
			die;

}

function get_layout_title( $field, $layout, $i, $value ) {

// vars
			$rows       = array();
			$rows[ $i ] = $value;

// add loop
			acf_add_loop(
				array(
					'selector' => $field['name'],
					'name'     => $field['name'],
					'value'    => $rows,
					'field'    => $field,
					'i'        => $i,
					'post_id'  => 0,
				)
			);

// vars
			$title = $layout['label'];

// filters
			$title = apply_filters( 'acf/fields/flexible_content/layout_title', $title, $field, $layout, $i );
			$title = apply_filters( 'acf/fields/flexible_content/layout_title/name=' . $field['_name'], $title, $field, $layout, $i );
			$title = apply_filters( 'acf/fields/flexible_content/layout_title/key=' . $field['key'], $title, $field, $layout, $i );

// remove loop
			acf_remove_loop();

// prepend order
			$order = is_numeric( $i ) ? $i + 1 : 0;
			$title = '<span class="acf-fc-layout-order">' . $order . '</span> ' . acf_esc_html( $title );

// return
			return $title;

}

/*
		*  clone_any_field
		*
		*  This function will update clone field settings based on the origional field
		*
		*  @type    function
		*  @date    28/06/2016
		*  @since   5.3.8
		*
		*  @param   $clone (array)
		*  @param   $field (array)
		*  @return  $clone
		*/

function clone_any_field( $field, $clone_field ) {

// remove parent_layout
			// - allows a sub field to be rendered as a normal field
			unset( $field['parent_layout'] );

// attempt to merger parent_layout
			if ( isset( $clone_field['parent_layout'] ) ) {

$field['parent_layout'] = $clone_field['parent_layout'];

}

// return
			return $field;

}

/*
		*  prepare_field_for_export
		*
		*  description
		*
		*  @type    function
		*  @date    11/03/2014
		*  @since   5.0.0
		*
		*  @param   $post_id (int)
		*  @return  $post_id (int)
		*/

function prepare_field_for_export( $field ) {

// loop
			if ( ! empty( $field['layouts'] ) ) {

foreach ( $field['layouts'] as &$layout ) {

$layout['sub_fields'] = acf_prepare_fields_for_export( $layout['sub_fields'] );

}
			}

// return
			return $field;

}

function prepare_any_field_for_export( $field ) {

// remove parent_layout
			unset( $field['parent_layout'] );

// return
			return $field;

}

/*
		*  prepare_field_for_import
		*
		*  description
		*
		*  @type    function
		*  @date    11/03/2014
		*  @since   5.0.0
		*
		*  @param   $post_id (int)
		*  @return  $post_id (int)
		*/

function prepare_field_for_import( $field ) {

// Bail early if no layouts
			if ( empty( $field['layouts'] ) ) {
				return $field;
			}

// Storage for extracted fields.
			$extra = array();

// Loop over layouts.
			foreach ( $field['layouts'] as &$layout ) {

// Ensure layout is valid.
				$layout = $this->get_valid_layout( $layout );

// Extract sub fields.
				$sub_fields = acf_extract_var( $layout, 'sub_fields' );

// Modify and append sub fields to $extra.
				if ( $sub_fields ) {
					foreach ( $sub_fields as $i => $sub_field ) {

// Update atttibutes
						$sub_field['parent']        = $field['key'];
						$sub_field['parent_layout'] = $layout['key'];
						$sub_field['menu_order']    = $i;

// Append to extra.
						$extra[] = $sub_field;
					}
				}
			}

// Merge extra sub fields.
			if ( $extra ) {
				array_unshift( $extra, $field );
				return $extra;
			}

// Return field.
			return $field;
		}

/*
		*  validate_any_field
		*
		*  This function will add compatibility for the 'column_width' setting
		*
		*  @type    function
		*  @date    30/1/17
		*  @since   5.5.6
		*
		*  @param   $field (array)
		*  @return  $field
		*/

function validate_any_field( $field ) {

// width has changed
			if ( isset( $field['column_width'] ) ) {

$field['wrapper']['width'] = acf_extract_var( $field, 'column_width' );

}

// return
			return $field;

}

/*
		*  translate_field
		*
		*  This function will translate field settings
		*
		*  @type    function
		*  @date    8/03/2016
		*  @since   5.3.2
		*
		*  @param   $field (array)
		*  @return  $field
		*/

function translate_field( $field ) {

// translate
			$field['button_label'] = acf_translate( $field['button_label'] );

// loop
			if ( ! empty( $field['layouts'] ) ) {

foreach ( $field['layouts'] as &$layout ) {

$layout['label'] = acf_translate( $layout['label'] );

}
			}

// return
			return $field;

}

/**
		 * Additional validation for the flexible content field when submitted via REST.
		 *
		 * @param bool  $valid
		 * @param int   $value
		 * @param array $field
		 *
		 * @return bool|WP_Error
		 */
		public function validate_rest_value( $valid, $value, $field ) {
			$param = sprintf( '%s[%s]', $field['prefix'], $field['name'] );
			$data  = array(
				'param' => $param,
				'value' => $value,
			);

if ( ! is_array( $value ) && is_null( $value ) ) {
				$error = sprintf( __( '%s must be of type array or null.', 'acf' ), $param );
				return new WP_Error( 'rest_invalid_param', $error, $param );
			}

$layouts_to_update = array_count_values( array_column( $value, 'acf_fc_layout' ) );

foreach ( $field['layouts'] as $layout ) {
				$num_layouts = isset( $layouts_to_update[ $layout['name'] ] ) ? $layouts_to_update[ $layout['name'] ] : 0;

if ( '' !== $layout['min'] && $num_layouts < (int) $layout['min'] ) {
					$error = sprintf(
						_n(
							'%1$s must contain at least %2$s %3$s layout.',
							'%1$s must contain at least %2$s %3$s layouts.',
							$layout['min'],
							'acf'
						),
						$param,
						number_format_i18n( $layout['min'] ),
						$layout['name']
					);

return new WP_Error( 'rest_invalid_param', $error, $data );
				}

if ( '' !== $layout['max'] && $num_layouts > (int) $layout['max'] ) {
					$error = sprintf(
						_n(
							'%1$s must contain at most %2$s %3$s layout.',
							'%1$s must contain at most %2$s %3$s layouts.',
							$layout['max'],
							'acf'
						),
						$param,
						number_format_i18n( $layout['max'] ),
						$layout['name']
					);

return new WP_Error( 'rest_invalid_param', $error, $data );
				}
			}

return $valid;
		}

/**
		 * Return the schema array for the REST API.
		 *
		 * @param array $field
		 * @return array
		 */
		public function get_rest_schema( array $field ) {
			$schema = array(
				'type'     => array( 'array', 'null' ),
				'required' => ! empty( $field['required'] ),
				'items'    => array(
					'oneOf' => array(),
				),
			);

// Loop through layouts building up a schema for each.
			foreach ( $field['layouts'] as $layout ) {
				$layout_schema = array(
					'type'       => 'object',
					'properties' => array(
						'acf_fc_layout' => array(
							'type'     => 'string',
							'required' => true,
							// By using a pattern match against the layout name, data sent in must match an available
							// layout on the flexible field. If it doesn't, a 400 Bad Request response will result.
							'pattern'  => '^' . $layout['name'] . '$',
						),
					),
				);

foreach ( $layout['sub_fields'] as $sub_field ) {
					if ( $sub_field_schema = acf_get_field_rest_schema( $sub_field ) ) {
						$layout_schema['properties'][ $sub_field['name'] ] = $sub_field_schema;
					}
				}

$schema['items']['oneOf'][] = $layout_schema;
			}

if ( ! empty( $field['min'] ) ) {
				$schema['minItems'] = (int) $field['min'];
			}

if ( ! empty( $field['max'] ) ) {
				$schema['maxItems'] = (int) $field['max'];
			}

return $schema;
		}

/**
		 * Apply basic formatting to prepare the value for default REST output.
		 *
		 * @param mixed      $value
		 * @param int|string $post_id
		 * @param array      $field
		 * @return array|mixed
		 */
		public function format_value_for_rest( $value, $post_id, array $field ) {
			if ( empty( $value ) || ! is_array( $value ) || empty( $field['layouts'] ) ) {
				return null;
			}

// Create a map of layout sub fields mapped to layout names.
			foreach ( $field['layouts'] as $layout ) {
				$layouts[ $layout['name'] ] = $layout['sub_fields'];
			}

// Loop through each layout and within that, each sub field to process sub fields individually.
			foreach ( $value as &$layout ) {
				$name = $layout['acf_fc_layout'];

if ( empty( $layouts[ $name ] ) ) {
					continue;
				}

foreach ( $layouts[ $name ] as $sub_field ) {

// Bail early if the field has no name (tab).
					if ( acf_is_empty( $sub_field['name'] ) ) {
						continue;
					}

// Extract the sub field 'field_key'=>'value' pair from the $layout and format it.
					$sub_value = acf_extract_var( $layout, $sub_field['key'] );
					$sub_value = acf_format_value_for_rest( $sub_value, $post_id, $sub_field );

// Add the sub field value back to the $layout but mapped to the field name instead
					// of the key reference.
					$layout[ $sub_field['name'] ] = $sub_value;
				}
			}

return $value;
		}

}

// initialize
	acf_register_field_type( 'acf_field_flexible_content' );

endif; // class_exists check

✏️ Editing: class-acf-field-flexible-content.php

🚀 NebulaPanel