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