acf_field_flexible_content{}ACF 1.0

Использование

$acf_field_flexible_content = new acf_field_flexible_content();
// use class methods

Методы

  1. public ajax_layout_title()
  2. public clone_any_field( $field, $clone_field )
  3. public delete_field( $field )
  4. public delete_row( $i, $field, $post_id )
  5. public delete_value( $post_id, $key, $field )
  6. public duplicate_field( $field )
  7. public format_value( $value, $post_id, $field )
  8. public get_layout( $name, $field )
  9. public get_layout_title( $field, $layout, $i, $value )
  10. public get_sub_field( $sub_field, $id, $field )
  11. public get_valid_layout( $layout = array() )
  12. public initialize()
  13. public input_admin_enqueue_scripts()
  14. public load_field( $field )
  15. public load_value( $value, $post_id, $field )
  16. public prepare_any_field_for_export( $field )
  17. public prepare_field_for_export( $field )
  18. public prepare_field_for_import( $field )
  19. public render_field( $field )
  20. public render_field_settings( $field )
  21. public render_layout( $field, $layout, $i, $value )
  22. public translate_field( $field )
  23. public update_field( $field )
  24. public update_row( $row, $i, $field, $post_id )
  25. public update_value( $value, $post_id, $field )
  26. public validate_any_field( $field )
  27. public validate_value( $valid, $value, $field, $input )

Код acf_field_flexible_content{} ACF 5.10.2

<?php
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;

	}

}