PATH:
home
/
lab2454c
/
cbcei.com
/
wp-content
/
plugins
/
advanced-custom-fields-pro
/
pro
/
fields
<?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; } } // initialize acf_register_field_type( 'acf_field_flexible_content' ); endif; // class_exists check ?>
[-] class-acf-field-gallery.php
[edit]
[+]
..
[-] class-acf-field-flexible-content.php
[edit]
[-] class-acf-field-repeater.php
[edit]
[-] class-acf-field-clone.php
[edit]