ACF_Compatibility{}ACF 1.0

Хуков нет.

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

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

Методы

  1. public __construct()
  2. public field_wrapper_attributes( $wrapper, $field )
  3. public init()
  4. public validate_date_picker_field( $field )
  5. public validate_date_time_picker_field( $field )
  6. public validate_field( $field )
  7. public validate_field_group( $field_group )
  8. public validate_image_field( $field )
  9. public validate_post_taxonomy_location_rule( $rule )
  10. public validate_relationship_field( $field )
  11. public validate_taxonomy_field( $field )
  12. public validate_textarea_field( $field )
  13. public validate_user_field( $field )
  14. public validate_wysiwyg_field( $field )

Код ACF_Compatibility{} ACF 6.0.4

class ACF_Compatibility {

	/**
	 *  __construct
	 *
	 *  Sets up the class functionality.
	 *
	 *  @date    30/04/2014
	 *  @since   5.0.0
	 *
	 *  @param   void
	 *  @return  void
	 */
	function __construct() {

		// actions
		add_filter( 'acf/validate_field', array( $this, 'validate_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=textarea', array( $this, 'validate_textarea_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=relationship', array( $this, 'validate_relationship_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=post_object', array( $this, 'validate_relationship_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=page_link', array( $this, 'validate_relationship_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=image', array( $this, 'validate_image_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=file', array( $this, 'validate_image_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=wysiwyg', array( $this, 'validate_wysiwyg_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=date_picker', array( $this, 'validate_date_picker_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=taxonomy', array( $this, 'validate_taxonomy_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=date_time_picker', array( $this, 'validate_date_time_picker_field' ), 20, 1 );
		add_filter( 'acf/validate_field/type=user', array( $this, 'validate_user_field' ), 20, 1 );
		add_filter( 'acf/validate_field_group', array( $this, 'validate_field_group' ), 20, 1 );

		// Modify field wrapper attributes
		add_filter( 'acf/field_wrapper_attributes', array( $this, 'field_wrapper_attributes' ), 20, 2 );

		// location
		add_filter( 'acf/location/validate_rule/type=post_taxonomy', array( $this, 'validate_post_taxonomy_location_rule' ), 20, 1 );
		add_filter( 'acf/location/validate_rule/type=post_category', array( $this, 'validate_post_taxonomy_location_rule' ), 20, 1 );

		// Update settings
		add_action( 'acf/init', array( $this, 'init' ) );
	}

	/**
	 * init
	 *
	 * Adds compatibility for deprecated settings.
	 *
	 * @date    10/6/19
	 * @since   5.8.1
	 *
	 * @param   void
	 * @return  void
	 */
	function init() {

		// Update "show_admin" setting based on defined constant.
		if ( defined( 'ACF_LITE' ) && ACF_LITE ) {
			acf_update_setting( 'show_admin', false );
		}
	}

	/**
	 * field_wrapper_attributes
	 *
	 * Adds compatibility with deprecated field wrap attributes.
	 *
	 * @date    21/1/19
	 * @since   5.7.10
	 *
	 * @param   array $wrapper The wrapper attributes array.
	 * @param   array $field The field array.
	 */
	function field_wrapper_attributes( $wrapper, $field ) {

		// Check compatibility setting.
		if ( acf_get_compatibility( 'field_wrapper_class' ) ) {
			$wrapper['class'] .= " field_type-{$field['type']}";
			if ( $field['key'] ) {
				$wrapper['class'] .= " field_key-{$field['key']}";
			}
		}

		// Return wrapper.
		return $wrapper;
	}

	/**
	 *  validate_field
	 *
	 *  Adds compatibility with deprecated settings
	 *
	 *  @date    23/04/2014
	 *  @since   5.0.0
	 *
	 *  @param   array $field The field array.
	 *  @return  array $field
	 */
	function validate_field( $field ) {

		// conditional logic data structure changed to groups in version 5.0.0
		// convert previous data (status, rules, allorany) into groups
		if ( isset( $field['conditional_logic']['status'] ) ) {

			// check status
			if ( $field['conditional_logic']['status'] ) {
				$field['conditional_logic'] = acf_convert_rules_to_groups( $field['conditional_logic']['rules'], $field['conditional_logic']['allorany'] );
			} else {
				$field['conditional_logic'] = 0;
			}
		}

		// return
		return $field;
	}

	/**
	 *  validate_textarea_field
	 *
	 *  Adds compatibility with deprecated settings
	 *
	 *  @date    23/04/2014
	 *  @since   5.0.0
	 *
	 *  @param   array $field The field array.
	 *  @return  array $field
	 */
	function validate_textarea_field( $field ) {

		// formatting has been removed
		$formatting = acf_extract_var( $field, 'formatting' );
		if ( $formatting === 'br' ) {
			$field['new_lines'] = 'br';
		}

		// return
		return $field;
	}

	/**
	 *  validate_relationship_field
	 *
	 *  Adds compatibility with deprecated settings
	 *
	 *  @date    23/04/2014
	 *  @since   5.0.0
	 *
	 *  @param   array $field The field array.
	 *  @return  array $field
	 */
	function validate_relationship_field( $field ) {

		// remove 'all' from post_type
		if ( acf_in_array( 'all', $field['post_type'] ) ) {
			$field['post_type'] = array();
		}

		// remove 'all' from taxonomy
		if ( acf_in_array( 'all', $field['taxonomy'] ) ) {
			$field['taxonomy'] = array();
		}

		// result_elements is now elements
		if ( isset( $field['result_elements'] ) ) {
			$field['elements'] = acf_extract_var( $field, 'result_elements' );
		}

		// return
		return $field;
	}

	/**
	 *  validate_image_field
	 *
	 *  Adds compatibility with deprecated settings
	 *
	 *  @date    23/04/2014
	 *  @since   5.0.0
	 *
	 *  @param   array $field The field array.
	 *  @return  array $field
	 */
	function validate_image_field( $field ) {

		// save_format is now return_format
		if ( isset( $field['save_format'] ) ) {
			$field['return_format'] = acf_extract_var( $field, 'save_format' );
		}

		// object is now array
		if ( $field['return_format'] == 'object' ) {
			$field['return_format'] = 'array';
		}

		// return
		return $field;
	}

	/**
	 *  validate_wysiwyg_field
	 *
	 *  Adds compatibility with deprecated settings
	 *
	 *  @date    23/04/2014
	 *  @since   5.0.0
	 *
	 *  @param   array $field The field array.
	 *  @return  array $field
	 */
	function validate_wysiwyg_field( $field ) {

		// media_upload is now numeric
		if ( $field['media_upload'] === 'yes' ) {
			$field['media_upload'] = 1;
		} elseif ( $field['media_upload'] === 'no' ) {
			$field['media_upload'] = 0;
		}

		// return
		return $field;
	}

	/**
	 *  validate_date_picker_field
	 *
	 *  Adds compatibility with deprecated settings
	 *
	 *  @date    23/04/2014
	 *  @since   5.0.0
	 *
	 *  @param   array $field The field array.
	 *  @return  array $field
	 */
	function validate_date_picker_field( $field ) {

		// date_format has changed to display_format
		if ( isset( $field['date_format'] ) ) {

			// extract vars
			$date_format    = $field['date_format'];
			$display_format = $field['display_format'];

			// convert from js to php
			$display_format = acf_convert_date_to_php( $display_format );

			// append settings
			$field['display_format'] = $display_format;
			$field['save_format']    = $date_format;

			// clean up
			unset( $field['date_format'] );
		}

		// return
		return $field;
	}

	/**
	 *  validate_taxonomy_field
	 *
	 *  Adds compatibility with deprecated settings
	 *
	 *  @date    23/04/2014
	 *  @since   5.2.7
	 *
	 *  @param   array $field The field array.
	 *  @return  array $field
	 */
	function validate_taxonomy_field( $field ) {

		// load_save_terms deprecated in favour of separate save_terms
		if ( isset( $field['load_save_terms'] ) ) {
			$field['save_terms'] = acf_extract_var( $field, 'load_save_terms' );
		}

		// return
		return $field;
	}

	/**
	 *  validate_date_time_picker_field
	 *
	 *  Adds compatibility with deprecated settings
	 *
	 *  @date    23/04/2014
	 *  @since   5.2.7
	 *
	 *  @param   array $field The field array.
	 *  @return  array $field
	 */
	function validate_date_time_picker_field( $field ) {

		// 3rd party date time picker
		// https://github.com/soderlind/acf-field-date-time-picker
		if ( ! empty( $field['time_format'] ) ) {

			// extract vars
			$time_format      = acf_extract_var( $field, 'time_format' );
			$date_format      = acf_extract_var( $field, 'date_format' );
			$get_as_timestamp = acf_extract_var( $field, 'get_as_timestamp' );

			// convert from js to php
			$time_format = acf_convert_time_to_php( $time_format );
			$date_format = acf_convert_date_to_php( $date_format );

			// append settings
			$field['return_format']  = $date_format . ' ' . $time_format;
			$field['display_format'] = $date_format . ' ' . $time_format;

			// timestamp
			if ( $get_as_timestamp === 'true' ) {
				$field['return_format'] = 'U';
			}
		}

		// return
		return $field;
	}

	/**
	 *  validate_user_field
	 *
	 *  Adds compatibility with deprecated settings
	 *
	 *  @date    23/04/2014
	 *  @since   5.2.7
	 *
	 *  @param   array $field The field array.
	 *  @return  array $field
	 */
	function validate_user_field( $field ) {

		// remove 'all' from roles
		if ( acf_in_array( 'all', $field['role'] ) ) {
			$field['role'] = '';
		}

		// field_type removed in favour of multiple
		if ( isset( $field['field_type'] ) ) {

			// extract vars
			$field_type = acf_extract_var( $field, 'field_type' );

			// multiple
			if ( $field_type === 'multi_select' ) {
				$field['multiple'] = true;
			}
		}

		// return
		return $field;
	}

	/*
	*  validate_field_group
	*
	*  This function will provide compatibility with ACF4 field groups
	*
	*  @type    function
	*  @date    23/04/2014
	*  @since   5.0.0
	*
	*  @param   $field_group (array)
	*  @return  $field_group
	*/
	function validate_field_group( $field_group ) {

		// vars
		$version = 5;

		// field group key was added in version 5.0.0
		// detect ACF4 data and generate key
		if ( ! $field_group['key'] ) {
			$version            = 4;
			$field_group['key'] = isset( $field_group['id'] ) ? "group_{$field_group['id']}" : uniqid( 'group_' );
		}

		// prior to version 5.0.0, settings were saved in an 'options' array
		// extract and merge options into the field group
		if ( isset( $field_group['options'] ) ) {
			$options     = acf_extract_var( $field_group, 'options' );
			$field_group = array_merge( $field_group, $options );
		}

		// location data structure changed to groups in version 4.1.0
		// convert previous data (rules, allorany) into groups
		if ( isset( $field_group['location']['rules'] ) ) {
			$field_group['location'] = acf_convert_rules_to_groups( $field_group['location']['rules'], $field_group['location']['allorany'] );
		}

		// some location rule names have changed in version 5.0.0
		// loop over location data and modify rules
		$replace = array(
			'taxonomy'    => 'post_taxonomy',
			'ef_media'    => 'attachment',
			'ef_taxonomy' => 'taxonomy',
			'ef_user'     => 'user_role',
			'user_type'   => 'current_user_role', // 5.2.0
		);

		// only replace 'taxonomy' rule if is an ACF4 field group
		if ( $version > 4 ) {
			unset( $replace['taxonomy'] );
		}

		// loop over location groups
		if ( $field_group['location'] ) {
			foreach ( $field_group['location'] as $i => $group ) {

				// loop over group rules
				if ( $group ) {
					foreach ( $group as $j => $rule ) {

						// migrate param
						if ( isset( $replace[ $rule['param'] ] ) ) {
							$field_group['location'][ $i ][ $j ]['param'] = $replace[ $rule['param'] ];
						}
					}
				}
			}
		}

		// change layout to style (v5.0.0)
		if ( isset( $field_group['layout'] ) ) {
			$field_group['style'] = acf_extract_var( $field_group, 'layout' );
		}

		// change no_box to seamless (v5.0.0)
		if ( $field_group['style'] === 'no_box' ) {
			$field_group['style'] = 'seamless';
		}

		// return
		return $field_group;
	}

	/**
	 *  validate_post_taxonomy_location_rule
	 *
	 *  description
	 *
	 *  @date    27/8/18
	 *  @since   5.7.4
	 *
	 *  @param   type $var Description. Default.
	 *  @return  type Description.
	 */
	function validate_post_taxonomy_location_rule( $rule ) {

		// previous versions of ACF (v4.4.12) saved value as term_id
		// convert term_id into "taxonomy:slug" string
		if ( is_numeric( $rule['value'] ) ) {
			$term = acf_get_term( $rule['value'] );
			if ( $term ) {
				$rule['value'] = acf_encode_term( $term );
			}
		}

		// return
		return $rule;
	}

}