ACF_Location{} ACF 1.0

Хуков нет.

Возвращает

Null. Ничего.

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

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

Методы

1. __construct()
2. compare_to_rule( $value, $rule )
3. get_object_subtype( $rule )
4. get_object_type( $rule )
5. get_operators( $rule )
6. get_values( $rule )
7. initialize()
8. match( $rule, $screen, $field_group )

Код ACF_Location{} ACF Location{} ^{ACF 5.9.1}

<?php
abstract class ACF_Location extends ACF_Legacy_Location {
	
	/**
	 * The location rule name.
	 *
	 * @since 5.9.0
	 * @var string
	 */
	public $name = '';
	
	/**
	 * The location rule label.
	 *
	 * @since 5.9.0
	 * @var string
	 */
	public $label = '';
	
	/**
	 * The location rule category. 
	 * 
	 * Accepts "post", "page", "user", "forms" or a custom label.
	 *
	 * @since 5.9.0
	 * @var string
	 */
	public $category = 'post';
	
	/**
	 * Whether or not the location rule is publicly accessible.
	 *
	 * @since 5.0.0
	 * @var bool
	 */
	public $public = true;
	
	/**
	 * The object type related to this location rule.
	 * 
	 * Accepts an object type discoverable by `acf_get_object_type()`.
	 *
	 * @since 5.9.0
	 * @var string
	 */
	public $object_type = '';
	
	/**
	 * The object subtype related to this location rule.
	 * 
	 * Accepts a custom post type or custom taxonomy.
	 *
	 * @since 5.9.0
	 * @var string
	 */
	public $object_subtype = '';
	
	/**
	 * Constructor.
	 *
	 * @date	8/4/20
	 * @since	5.9.0
	 *
	 * @param	void
	 * @return	void
	 */
	public function __construct() {
		$this->initialize();
		
		// Call legacy constructor.
		parent::__construct();
	}
	
	/**
	 * Initializes props.
	 *
	 * @date	5/03/2014
	 * @since	5.0.0
	 *
	 * @param	void
	 * @return	void
	 */
	public function initialize() {
		// Set props here.
	}
	
	/**
	 * Returns an array of operators for this location.
	 *
	 * @date	9/4/20
	 * @since	5.9.0
	 *
	 * @param	array $rule A location rule.
	 * @return	array
	 */
	public static function get_operators( $rule ) {
		return array(
			'=='	=> __( "is equal to", 'acf' ),
			'!='	=> __( "is not equal to", 'acf' )
		);
	}
	
	/**
	 * Returns an array of possible values for this location.
	 *
	 * @date	9/4/20
	 * @since	5.9.0
	 *
	 * @param	array $rule A location rule.
	 * @return	array
	 */
	public function get_values( $rule ) {
		return array();
	}
	
	/**
	 * Returns the object_type connected to this location.
	 *
	 * @date	1/4/20
	 * @since	5.9.0
	 *
	 * @param	array $rule A location rule.
	 * @return	string
	 */
	public function get_object_type( $rule ) {
		return $this->object_type;
	}
	
	/**
	 * Returns the object_subtype connected to this location.
	 *
	 * @date	1/4/20
	 * @since	5.9.0
	 *
	 * @param	array $rule A location rule.
	 * @return	string|array
	 */
	public function get_object_subtype( $rule ) {
		return $this->object_subtype;
	}
	
	/**
	 * Matches the provided rule against the screen args returning a bool result.
	 *
	 * @date	9/4/20
	 * @since	5.9.0
	 *
	 * @param	array $rule The location rule.
	 * @param	array $screen The screen args.
	 * @param	array $field_group The field group settings.
	 * @return	bool
	 */
	public function match( $rule, $screen, $field_group ) {
		return false;
	}

	/**
	 * Compares the given value and rule params returning true when they match.
	 *
	 * @date	17/9/19
	 * @since	5.8.1
	 *
	 * @param	array $rule The location rule data.
	 * @param	mixed $value The value to compare against.
	 * @return	bool
	 */
	public function compare_to_rule( $value, $rule ) {
		$result = ( $value == $rule['value'] );
		
		// Allow "all" to match any value.
        if( $rule['value'] === 'all' ) {
	        $result = true;   
        }
		
		// Reverse result for "!=" operator.
        if( $rule['operator'] === '!=' ) {
        	return !$result;
        }
		return $result;
	}
}