name = 'list_items';
$this->label = __( 'List Items', 'frontend-admin' );
$this->category = __( 'Form', 'frontend-admin' );
$this->defaults = array(
'min' => 0,
'max' => 0,
'layout' => 'table',
'button_label' => __( 'Add Item', 'frontend-admin' ),
'duplicate_label' => __( 'Duplicate Item', 'frontend-admin' ),
'remove_label' => __( 'Remove Item', 'frontend-admin' ),
'no_value_msg' => '',
'no_attrs_msg' => '',
'collapsed' => '',
'sub_fields' => array(),
);
// field filters
$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' ) );
// filters
$this->add_filter( 'acf/validate_field', array( $this, 'validate_any_field' ) );
}
/*
* 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(
'Minimum rows reached ({min} rows)' => __( 'Minimum rows reached ({min} rows)', 'frontend-admin' ),
'Maximum rows reached ({max} rows)' => __( 'Maximum rows reached ({max} rows)', 'frontend-admin' ),
)
);
}
/**
* 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
*
* @since 3.6
* @date 23/01/13
*
* @param array $field An array holding all the field's data.
*/
function render_field_settings( $field ) {
$args = array(
'fields' => $field['sub_fields'],
'parent' => $field['ID'],
'is_subfield' => true,
);
$supports_pagination = ( empty( $field['parent_repeater'] ) && empty( $field['parent_layout'] ) );
?>
__( 'Layout', 'frontend-admin' ),
'instructions' => '',
'class' => 'acf-repeater-layout',
'type' => 'radio',
'name' => 'layout',
'layout' => 'horizontal',
'choices' => array(
'table' => __( 'Table', 'frontend-admin' ),
'block' => __( 'Block', 'frontend-admin' ),
'row' => __( 'Row', 'frontend-admin' ),
),
)
);
acf_render_field_setting(
$field,
array(
'label' => __( 'Minimum Rows', 'frontend-admin' ),
'instructions' => '',
'type' => 'number',
'name' => 'min',
)
);
acf_render_field_setting(
$field,
array(
'label' => __( 'Maximum Rows', 'frontend-admin' ),
'instructions' => '',
'type' => 'number',
'name' => 'max',
)
);
acf_render_field_setting(
$field,
array(
'label' => __( 'Show Order', 'frontend-admin' ),
'instructions' => '',
'type' => 'radio',
'name' => 'show_order',
'layout' => 'horizontal',
'choices' => array(
'numbers' => __( 'Numbers', 'frontend-admin' ),
'ids' => __( 'IDs', 'frontend-admin' ),
'no' => __( 'No', 'frontend-admin' ),
),
)
);
acf_render_field_setting(
$field,
array(
'label' => __( 'Show Add Button', 'frontend-admin' ),
'instructions' => '',
'type' => 'true_false',
'name' => 'show_add',
'ui' => 1,
)
);
acf_render_field_setting(
$field,
array(
'label' => __( 'Add Button Locations', 'frontend-admin' ),
'instructions' => '',
'type' => 'checkbox',
'name' => 'add_button_locations',
'choices' => array(
'top' => __( 'Top', 'frontend-admin' ),
'bottom' => __( 'Bottom', 'frontend-admin' ),
'rows' => __( 'Within Rows', 'frontend-admin' ),
),
'conditional_logic' => array(
array(
array(
'field' => 'show_add',
'operator' => '==',
'value' => 1,
),
),
),
)
);
acf_render_field_setting(
$field,
array(
'label' => __( 'Add Button Label', 'frontend-admin' ),
'instructions' => '',
'type' => 'text',
'name' => 'button_label',
'placeholder' => __( 'Add Item', 'frontend-admin' ),
'conditional_logic' => array(
array(
array(
'field' => 'show_add',
'operator' => '==',
'value' => 1,
),
),
),
)
);
acf_render_field_setting(
$field,
array(
'label' => __( 'Show Remove Button', 'frontend-admin' ),
'instructions' => '',
'type' => 'true_false',
'name' => 'show_remove',
'ui' => 1,
)
);
acf_render_field_setting(
$field,
array(
'label' => __( 'Remove Item Label', 'frontend-admin' ),
'instructions' => '',
'type' => 'text',
'name' => 'remove_label',
'placeholder' => __( 'Remove Item', 'frontend-admin' ),
'conditional_logic' => array(
array(
array(
'field' => 'show_remove',
'operator' => '==',
'value' => 1,
),
),
),
)
);
acf_render_field_setting(
$field,
array(
'label' => __( 'Duplicate Item Label', 'frontend-admin' ),
'instructions' => '',
'type' => 'text',
'name' => 'duplicate_label',
)
);
}
/*
* 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 ) {
// vars
$sub_fields = $field['sub_fields'];
$show_order = $field['show_order'] ?? 'numbers';
$show_add = $field['show_add'] ?? true;
$show_remove = $field['show_remove'] ?? true;
$add_button_locations = $field['add_button_locations'] ?? array( 'top', 'bottom', 'rows' );
// bail early if no sub fields
if ( empty( $sub_fields ) ) {
return;
}
// value
$value = is_array( $field['value'] ) ? $field['value'] : array();
// div
$div = array(
'class' => 'acf-list-items',
'data-min' => $field['min'],
'data-max' => $field['max'],
);
// empty
if ( empty( $value ) ) {
$div['class'] .= ' -empty';
}
// If there are less values than min, populate the extra values
if ( $field['min'] ) {
$value = array_pad( $value, $field['min'], array() );
}
// If there are more values than man, remove some values
if ( $field['max'] ) {
$value = array_slice( $value, 0, $field['max'] );
// if max 1 row, don't show order
if ( $field['max'] == 1 ) {
$show_order = false;
}
// if max == min, don't show add or remove buttons
if ( $field['max'] <= $field['min'] ) {
$show_remove = false;
$show_add = false;
}
}
// setup values for row clone
$value['acfcloneindex'] = array();
// button label
if ( $field['button_label'] === '' ) {
$field['button_label'] = __( 'Add Item', 'frontend-admin' );
}
if ( $field['duplicate_label'] === '' ) {
$field['duplicate_label'] = __( 'Duplicate Item', 'frontend-admin' );
}
if ( $field['remove_label'] === '' ) {
$field['remove_label'] = __( 'Remove Item', 'frontend-admin' );
}
// field wrap
$el = 'td';
$before_fields = '';
$after_fields = '';
if ( $field['layout'] == 'row' ) {
$el = 'div';
$before_fields = '';
$after_fields = ' | ';
} elseif ( $field['layout'] == 'block' ) {
$el = 'div';
$before_fields = '';
$after_fields = ' | ';
}
// layout
$div['class'] .= ' -' . $field['layout'];
// collapsed
if ( $field['collapsed'] ) {
// loop
foreach ( $sub_fields as &$sub_field ) {
if ( empty( $sub_field['wrapper']['class'] ) ) {
$sub_field['wrapper']['class'] = '';
}
// add target class
if ( $sub_field['key'] == $field['collapsed'] ) {
$sub_field['wrapper']['class'] .= ' -collapsed-target';
}
}
unset( $sub_field );
}
?>
>
$field['name'],
'value' => '',
'disabled' => true
)
);
?>
|
'',
'type' => '',
'required' => 0,
'instructions' => '',
'_name' => '',
'wrapper' => array(
'class' => '',
'id' => '',
'width' => '',
),
)
);
// 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'] . '%;';
}
// Remove "id" to avoid "for" attribute on
$row ) :
if ( empty( $row['id'] ) ) {
$row['id'] = 0;
}
if ( isset( $field['save_names'] ) || ! $show_add ) {
if ( $i === 'acfcloneindex' ) {
continue;
}
}
// Generate row id.
$id = ( $i === 'acfcloneindex' ) ? 'acfcloneindex' : $i;
$css_classes = 'acf-row';
if ( $i === 'acfcloneindex' ) {
$css_classes .= ' acf-clone';
} elseif ( $field['collapsed'] ) {
$css_classes .= ' -collapsed';
}
?>
'acf-row-handle',
'title' => __( 'Drag to reorder', 'frontend-admin' ),
);
if ( empty( $field['maintain_order'] ) ) {
$td_attrs['class'] .= ' order';
}
if ( $show_order == 'ids' ) {
$td_attrs['class'] .= ' ids';
}
if ( $field['collapsed'] ) {
$td_attrs['data-event'] = 'collapse-row';
}
?>
| >
|
$row_data['class'],
'name' => $field['name'] . '[' . $i . '][' . $row_data['name'] . ']',
'value' => $row[ $row_data['value'] ],
)
);
}
}
?>
$condition ) {
if ( $index == 'name' ) {
$row_names = explode( ',', str_replace( ' ', '', $condition ) );
if ( ! in_array( $id, $row_names ) ) {
continue 2;
}
}
}
}
// add value
if ( isset( $row[ $sub_field['key'] ] ) ) {
// this is a normal value
$sub_field['value'] = $row[ $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'] = $field['name'] . '[' . $id . ']';
$sub_field['wrapper']['id'] = $field['key'] . '-' . $i . '-' . $sub_field['key'];
// render input
fea_instance()->form_display->render_field_wrap( $sub_field, $el );
?>
|
$row ) {
// loop sub fields
foreach ( $field['sub_fields'] as $sub_field ) {
// vars
$k = $sub_field['key'];
// test sub field exists
if ( ! isset( $row[ $k ] ) ) {
continue;
}
// validate
acf_validate_value( $row[ $k ], $sub_field, "{$input}[{$i}][{$k}]" );
}
// end loop sub fields
}
// end loop rows
}
// return
return $valid;
}
function format_attributes( $attributes, $variable_attributes ) {
$formatted = array();
if ( is_array( $attributes ) ) {
foreach ( $attributes as $j => $choice ) {
$attribute_key = sanitize_title( $variable_attributes[ $j ] );
$value[ $attribute_key ] = $choice;
}
}
return $value;
}
/*
* delete_row
*
* This function will delete a value row
*
* @type function
* @date 15/2/17
* @since 5.5.8
*
* @param $i (int)
* @param $field (array)
* @param $post_id (mixed)
* @return (boolean)
*/
function delete_row( $i, $field, $post_id ) {
// bail early if no sub fields
if ( empty( $field['sub_fields'] ) ) {
return false;
}
// loop
foreach ( $field['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;
}
/*
* 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 ) {
if ( is_array( $value ) ) {
return $value;
}
// bail early if no value
if ( empty( $value ) ) {
return false;
}
// bail ealry if not numeric
if ( ! is_numeric( $value ) ) {
return false;
}
// bail early if no sub fields
if ( empty( $field['sub_fields'] ) ) {
return false;
}
// vars
$value = intval( $value );
$rows = array();
// loop
for ( $i = 0; $i < $value; $i++ ) {
// create empty array
$rows[ $i ] = array();
// loop through sub fields
foreach ( array_keys( $field['sub_fields'] ) as $j ) {
// get sub field
$sub_field = $field['sub_fields'][ $j ];
// bail ealry if no name (tab)
if ( acf_is_empty( $sub_field['name'] ) ) {
continue;
}
// update $sub_field 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;
}
}
// return
return $rows;
}
/*
* 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 sub fields
if ( empty( $field['sub_fields'] ) ) {
return $value;
}
// vars
$new_value = 0;
$old_value = (int) acf_get_metadata( $post_id, $field['name'] );
// update sub fields
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 row
if ( ! is_array( $row ) ) {
continue;
}
// update row
$this->update_row( $row, $i, $field, $post_id );
// append
$new_value++;
}
}
// remove old rows
if ( $old_value > $new_value ) {
// loop
for ( $i = $new_value; $i < $old_value; $i++ ) {
$this->delete_row( $i, $field, $post_id );
}
}
// save false for empty value
if ( empty( $new_value ) ) {
$new_value = '';
}
// return
return $new_value;
}
/**
* 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 boolean
*/
function update_row( $row, $i, $field, $post_id ) {
// bail early if no layout reference
if ( ! is_array( $row ) ) {
return false;
}
// bail early if no layout
if ( empty( $field['sub_fields'] ) ) {
return false;
}
// loop
foreach ( $field['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;
}
/*
* 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 ) {
// get old value (db only)
$old_value = (int) acf_get_metadata( $post_id, $field['name'] );
// bail early if no rows or no sub fields
if ( ! $old_value || empty( $field['sub_fields'] ) ) {
return;
}
// loop
for ( $i = 0; $i < $old_value; $i++ ) {
$this->delete_row( $i, $field, $post_id );
}
}
/*
* 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 ) {
// min/max
$field['min'] = (int) $field['min'];
$field['max'] = (int) $field['max'];
// vars
$sub_fields = acf_get_fields( $field );
// append
if ( $sub_fields ) {
$field['sub_fields'] = $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 ) {
// bail early if no sub fields
if ( empty( $field['sub_fields'] ) ) {
return;
}
// loop through sub fields
foreach ( $field['sub_fields'] as $sub_field ) {
acf_delete_field( $sub_field['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 ) {
// remove sub fields
unset( $field['sub_fields'] );
// return
return $field;
}
/*
* 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 ) {
// get sub fields
$sub_fields = acf_extract_var( $field, 'sub_fields' );
// save field to get ID
$field = acf_update_field( $field );
// duplicate sub fields
acf_duplicate_fields( $sub_fields, $field['ID'] );
// 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'] );
// return
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;
}
/*
* 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 ) {
// bail early if no sub fields
if ( empty( $field['sub_fields'] ) ) {
return $field;
}
// prepare
$field['sub_fields'] = acf_prepare_fields_for_export( $field['sub_fields'] );
// 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 sub fields
if ( empty( $field['sub_fields'] ) ) {
return $field;
}
// vars
$sub_fields = $field['sub_fields'];
// reset field setting
$field['sub_fields'] = array();
// loop
foreach ( $sub_fields as &$sub_field ) {
$sub_field['parent'] = $field['key'];
}
// merge
array_unshift( $sub_fields, $field );
// return
return $sub_fields;
}
}
endif; // class_exists check
?>