File "Context.php"
Full Path: /home/romayxjt/public_html/wp-content/plugins/the-events-calendar/common/src/Tribe/Context.php
File size: 49.21 KB
MIME-type: text/x-php
Charset: utf-8
<?php
use TEC\Common\Context\Post_Request_Type;
use Tribe__Utils__Array as Arr;
/**
* Class Tribe__Context
*
* @since 4.7.7
* @since 4.9.5 Made the context immutable.
*/
class Tribe__Context {
/**
* The value that will be used to indicate no value was found in any location while trying to read it.
*
* @since 4.9.11
*/
const NOT_FOUND = '__not_found__';
/**
* The key to locate a context value as the value of a request variable.
*
* @since 4.9.11
*/
const REQUEST_VAR = 'request_var';
/**
* The key to locate a context value as the value of a Tribe option.
*
* @since 4.9.11
*/
const TRIBE_OPTION = 'tribe_option';
/**
* The key to locate a context value as the value of an option.
*
* @since 4.9.11
*/
const OPTION = 'option';
/**
* The key to locate a context value as the value of a transient.
*
* @since 4.9.11
*/
const TRANSIENT = 'transient';
/**
* The key to locate a context value as the value of the main query (global `$wp_query`) query var.
*
* @since 4.9.11
*/
const QUERY_VAR = 'query_var';
/**
* The key to locate a context value as the value of the main query (global `$wp_query`) property.
*
* @since 4.9.11
*/
const QUERY_PROP = 'query_prop';
/**
* The key to locate a context value as the value of the main query (global `$wp_query`) method return value.
*
* @since 4.9.20
*/
const QUERY_METHOD = 'query_method';
/**
* The key to locate a context value as the value of a constant.
*
* @since 4.9.11
*/
const CONSTANT = 'constant';
/**
* The key to locate a context value as a static class property.
*
* @since 4.9.11
*/
const STATIC_PROP = 'static_prop';
/**
* The key to locate a context value as property of an object.
*
* @since 4.9.11
*/
const PROP = 'prop';
/**
* The key to locate a context value as result running a static class method.
*
* @since 4.9.11
*/
const STATIC_METHOD = 'static_method';
/**
* The key to locate a context value as result running a method on an object.
*
* @since 4.9.11
*/
const METHOD = 'method';
/**
* The key to locate a context value as result running a callback function (e.g. a callable, a closure).
*
* @since 4.9.11
*/
const FUNC = 'func';
/**
* The key to locate a context value as result of reading a global value.
*
* @since 4.9.11
*/
const GLOBAL_VAR = 'global_var';
/**
* The key to locate a context value as result of an `apply_filters` call.
*
* @since 4.9.11
*/
const FILTER = 'filter';
/**
* The key to locate a context value among the values parsed by `WP::parse_request`.
*
* @since 4.9.11
*/
const WP_PARSED = 'wp_parsed';
/**
* The key to locate a context value among the values in the query mached by `WP::parse_request`.
*
* @since 4.9.11
*/
const WP_MATCHED_QUERY = 'wp_matched_query';
/**
* The key to indicate a location should be read by applying a callback to the value of another context location.
*
* @since 4.9.18
*/
const LOCATION_FUNC = 'location_func';
/**
*
* An array defining the properties the context will be able to read and (dangerously) write.
*
* This is the configuration that should be modified to add/remove/modify values and locations
* provided by the global context.
* Each entry has the shape [ <key> => [ 'read' => <read_locations>, 'write' => <write_locations> ] ].
* The key is used to identify the property that will be accessible with the `get` and
* 'dangerously_set_global_context' method, e.g. `$context->get( 'event_display', 'list' );`.
* The locations is a list of locations the context will search, top to bottom, left to right, to find a value that's
* not empty or the default one, here's a list of supported lookup locations:
*
* request_var - look into $_GET, $_POST, $_PUT, $_DELETE, $_REQUEST.
* query_var - get the value from the main WP_Query object query vars.
* query_prop - get the value from a property of the main WP_Query object.
* tribe_option - get the value from a Tribe option.
* option - get the value from a database option.
* transient - get the value from a transient.
* constant - get the value from a constant, can also be a class constant with <class>::<const>.
* global_var - get the value from a global variable
* static_prop - get the value from a class static property, format: `array( $class, $prop )`.
* prop - get the value from a tribe() container binding, format `array( $binding, $prop )`.
* static_method - get the value from a class static method.
* method - get the value calling a method on a tribe() container binding.
* func - get the value from a function or a closure.
* filter - get the value by applying a filter.
* location_func - get the value by applying a callback to the value of a location.
*
* For each location additional arguments can be specified:
* orm_arg - if `false` then the location will never produce an ORM argument, if provided the ORM arg produced bye the
* location will have this name.
* orm_transform - if provided the value of the location will be obtained by passing it as an argument to a callable.
*
* As the Context locations increase in number it would be impractical to define them inline here.
* The locations will be loaded by the `Tribe__Context::populate_locations` method from the `Context/locations.php`
* file.
*
* @var array
*/
protected static $locations = [];
/**
* A utility static property keeping track of write locations that
* will be defined as associative arrays.
*
* @var array
*/
protected static $associative_locations = [
self::TRANSIENT,
self::METHOD,
self::STATIC_METHOD,
self::PROP,
self::STATIC_PROP,
];
/**
* Whether the static dynamic locations were set or not.
*
* @var bool
*/
protected static $did_populate_locations = false;
/**
* A list of locations to disable reading from.
*
* @var array
*/
protected array $disable_read_from = [];
/**
* A list of override locations to read and write from.
*
* This list has the same format and options as the static `$locations` property
* but allows a context instance to override, or add, read and write locations.
*
* @var array
*/
protected $override_locations = [];
/**
* Whether the context of the current HTTP request is an AJAX one or not.
*
* @var bool
*/
protected $doing_ajax;
/**
* Whether the context of the current HTTP request is a Cron one or not.
*
* @var bool
*/
protected $doing_cron;
/**
* A request-based array cache to store the values fetched by the context.
*
* @var array
*/
protected $request_cache = [];
/**
* An instance of the post state handler.
*
* @since 5.0.13
*
* @var Post_Request_Type
*/
protected Post_Request_Type $post_state;
/**
* Tribe__Context constructor.
*
* @since 5.0.13
*
* @param Post_Request_Type|null $post_state An instance of the post state handler.
*/
public function __construct( ?Post_Request_Type $post_state = null ) {
$this->post_state = $post_state ?: tribe( Post_Request_Type::class );
}
/**
* Whether we are currently creating a new post, a post of post type(s) or not.
*
* @since 4.7.7
* @since 5.0.13 Extracted the logic to the `TEC\Common\Context\Post_Request_Type` class.
*
* @param null $post_type The optional post type to check.
*
* @return bool Whether we are currently creating a new post, a post of post type(s) or not.
*/
public function is_new_post( $post_type = null ) {
return $this->post_state->is_new_post( $post_type );
}
/**
* Whether we are currently editing a post(s), post type(s) or not.
*
* @since 4.7.7
* @since 5.0.13 Extracted the logic to the `TEC\Common\Context\Post_Request_Type` class.
*
* @param null|array|string|int $post_or_type A post ID, post type, an array of post types or post IDs, `null`
* to just make sure we are currently editing a post.
*
* @return bool
*/
public function is_editing_post( $post_or_type = null ): bool {
return $this->post_state->is_editing_post( $post_or_type );
}
/**
* Helper function to indicate whether the current execution context is AJAX.
*
* This method exists to allow us test code that behaves differently depending on the execution
* context.
*
* @since 4.7.12
* @since 4.9.5 Removed the $doing_ajax parameter.
*
* @return boolean
*/
public function doing_ajax() {
return function_exists( 'wp_doing_ajax' )
? wp_doing_ajax()
: defined( 'DOING_AJAX' ) && DOING_AJAX;
}
/**
* Checks whether the context of the current HTTP request is a Cron one or not.
*
* @since 4.7.23
* @since 4.9.5 Removed the $doing_cron parameter.
*
* @return bool Whether the context of the current HTTP request is a Cron one or not.
*/
public function doing_cron() {
return function_exists( 'wp_doing_cron' )
? wp_doing_cron()
: defined( 'DOING_CRON' ) && DOING_CRON;
}
/**
* Gets a value reading it from the location(s) defined in the `Tribe__Context::$props
*
* @since 4.9.5
*
* @param string $key The key of the variable to fetch.
* @param mixed|null $default The default value to return if not found.
* @param bool $force Whether to force the re-fetch of the value from the context or
* not; defaults to `false`.
*
* @return mixed The value from the first location that can provide it or the default
* value if not found.
*/
public function get( $key, $default = null, $force = false ) {
/**
* Filters the value of a context variable skipping all of its logic.
*
* @since 4.9.5
*
* @param mixed $value The value for the key before it's fetched from the context.
* @param string $key The key of the value to fetch from the context.
* @param mixed $default The default value that should be returned if the value is
* not set in the context.
* @param bool $force Whether to force the re-fetch of the value from the context or
* not; defaults to `false`.
*/
$value = apply_filters( "tribe_context_pre_{$key}", null, $key, $default, $force );
if ( null !== $value ) {
return $value;
}
$value = $default;
$locations = $this->get_locations();
$found = false;
if ( ! $force && isset( $this->request_cache[ $key ] ) ) {
$value = $this->request_cache[ $key ];
} elseif ( ! empty( $locations[ $key ]['read'] ) ) {
foreach ( $locations[ $key ]['read'] as $location => $keys ) {
$the_value = $this->$location( (array) $keys, $default );
if ( $default !== $the_value && static::NOT_FOUND !== $the_value ) {
$found = true;
$value = $the_value;
break;
}
}
}
/**
* Filters the value fetched from the context for a key.
*
* Useful for testing and local override.
*
* @since 4.9.5
*
* @param mixed $value The value as fetched from the context.
*/
$value = apply_filters( "tribe_context_{$key}", $value );
// Only cache if the value was found.
if ( $found ) {
$this->request_cache[ $key ] = $value;
}
return $value;
}
/**
* Alters the context.
*
* Due to its immutable nature setting values on the context will NOT modify the
* context but return a modified clone.
* If you need to modify the global context update the location(s) it should read from
* and call the `refresh` method.
* Example: `$widget_context = tribe_context()->alter( $widget_args );`.
*
* @since 4.9.5
*
* @param array $values An associative array of key-value pairs to modify the context.
*
* @return \Tribe__Context A clone, with modified, values, of the context the method was called on.
*/
public function alter( array $values ) {
$clone = clone $this;
$clone->request_cache = array_merge( $clone->request_cache, $values );
return $clone;
}
/**
* Clears the context cache forcing a re-fetch of the variables from the context.
*
* @since 4.9.5
*
* @param string $key An optional specific key to refresh, if passed only this key
* will be refreshed.
*/
public function refresh( $key = null ) {
if ( null !== $key ) {
unset( $this->request_cache[ $key ] );
} else {
$this->request_cache = [];
}
}
/**
* Returns the read and write locations set on the context.
*
* @since 4.9.5
*
* @return array An array of read and write location in the shape of the `Tribe__Context::$locations` one,
* `[ <location> => [ 'read' => <read_locations>, 'write' => <write_locations> ] ]`.
*/
public function get_locations() {
$this->populate_locations();
if ( has_filter( 'tribe_context_locations' ) ) {
/**
* Filters the locations registered in the Context.
*
* @since 4.10.2
*
* @param $locations array An array of read and write location in the shape of the `Tribe__Context::$locations` one,
* `[ <location> => [ 'read' => <read_locations>, 'write' => <write_locations> ] ]`.
* @param $context Tribe__Context Current instance of the context.
*/
static::$locations = apply_filters( 'tribe_context_locations', static::$locations, $this );
// Remove all filters everytime it runs.
remove_all_filters( 'tribe_context_locations' );
}
$new_locations = array_merge( static::$locations, $this->override_locations );
foreach ( array_keys( $new_locations ) as $key ) {
foreach ( $this->disable_read_from as $disable_read_from ) {
unset( $new_locations[ $key ]['read'][ $disable_read_from ] );
}
}
return $new_locations;
}
/**
* Disable reading from specific locations.
*
* @since 6.5.5
*
* @param array $locations The locations to disable reading from.
*/
public function disable_read_from( array $locations ): void {
$this->disable_read_from = $locations;
}
/**
* Reads the value from one or more $_REQUEST vars.
*
* @since 4.9.5
*
* @param array $request_vars The list of request vars to lookup, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function request_var( array $request_vars, $default ) {
$value = $default;
foreach ( $request_vars as $request_var ) {
$the_value = tribe_get_request_var( $request_var, self::NOT_FOUND );
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the value from one or more global WP_Query object query variables.
*
* @since 4.9.5
*
* @param array $query_vars The list of query vars to look up, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function query_var( array $query_vars, $default ) {
$value = $default;
global $wp_query;
if ( ! $wp_query instanceof \WP_Query ) {
return $value;
}
foreach ( $query_vars as $query_var ) {
$the_value = $wp_query->get( $query_var, self::NOT_FOUND );
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the value from one or more global WP_Query object properties.
*
* @since 4.9.5
*
* @param array $query_props The list of properties to look up, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function query_prop( array $query_props, $default ) {
$value = $default;
global $wp_query;
foreach ( $query_props as $query_prop ) {
$the_value = isset( $wp_query->{$query_prop} ) ? $wp_query->{$query_prop} : self::NOT_FOUND;
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the value from one more more `tribe_option`s.
*
* @since 4.9.5
*
* @param array $tribe_options The list of `tribe_option`s to lookup, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function tribe_option( array $tribe_options, $default ) {
$value = $default;
foreach ( $tribe_options as $option_name ) {
$the_value = tribe_get_option( $option_name, self::NOT_FOUND );
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the value from one or more options.
*
* @since 4.9.5
*
* @param array $options The list of options to lookup, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function option( array $options, $default ) {
$value = $default;
foreach ( $options as $option_name ) {
$the_value = get_option( $option_name, self::NOT_FOUND );
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the value from one or more transients.
*
* @since 4.9.5
*
* @param array $transients The list of transients to lookup, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function transient( array $transients, $default ) {
$value = $default;
foreach ( $transients as $transient ) {
$the_value = get_transient( $transient );
if ( false !== $the_value ) {
$value = $the_value;
/*
* This will fail when the value is actually `false`.
*/
break;
}
}
return $value;
}
/**
* Reads the value from one or more constants.
*
* @since 4.9.5
*
* @param array $constants The list of constants to lookup, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function constant( array $constants, $default ) {
$value = $default;
foreach ( $constants as $constant ) {
$the_value = defined( $constant ) ? constant( $constant ) : self::NOT_FOUND;
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the value from one or more global variable.
*
* @since 4.9.5
*
* @param array $global_vars The list of global variables to look up, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function global_var( array $global_vars, $default ) {
$value = $default;
foreach ( $global_vars as $var ) {
$the_value = isset( $GLOBALS[ $var ] ) ? $GLOBALS[ $var ] : self::NOT_FOUND;
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the value from one or more class static properties.
*
* @since 4.9.5
*
* @param array $classes_and_props An associative array in the shape [ <class> => <prop> ].
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function static_prop( array $classes_and_props, $default ) {
$value = $default;
foreach ( $classes_and_props as $class => $prop ) {
if ( class_exists( $class ) ) {
// PHP 5.2 compat, on PHP 5.3+ $class::$$prop
$vars = get_class_vars( $class );
$the_value = isset( $vars[ $prop ] ) ? $vars[ $prop ] : self::NOT_FOUND;
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
}
return $value;
}
/**
* Reads the value from one or more properties of implementations bound in the `tribe()` container.
*
* @since 4.9.5
*
* @param array $bindings_and_props An associative array in the shape [ <binding> => <prop> ].
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
protected function prop( array $bindings_and_props, $default ) {
$value = $default;
foreach ( $bindings_and_props as $binding => $prop ) {
$the_value = tribe()->offsetExists( $binding ) && property_exists( tribe( $binding ), $prop )
? tribe( $binding )->{$prop}
: self::NOT_FOUND;
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the values from one or more static class methods.
*
* @since 4.9.5
*
* @param array $classes_and_methods An associative array in the shape [ <class> => <method> ].
* @param mixed $default The default value to return.
*
* @return mixed The first value that's not equal to the default one, the default value
* otherwise.
*/
protected function static_method( array $classes_and_methods, $default ) {
$value = $default;
foreach ( $classes_and_methods as $class => $method ) {
$the_value = class_exists( $class ) && method_exists( $class, $method )
? call_user_func( [ $class, $method ] )
: self::NOT_FOUND;
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the value from one or more methods called on implementations bound in the `tribe()` container.
*
* @since 4.9.5
*
* @param array $bindings_and_methods An associative array in the shape [ <binding> => <method> ].
* @param mixed $default The default value to return.
*
* @return mixed The first value that's not equal to the default one, the default value
* otherwise.
*/
protected function method( array $bindings_and_methods, $default ) {
$value = $default;
$the_value = self::NOT_FOUND;
foreach ( $bindings_and_methods as $binding => $method ) {
if ( tribe()->offsetExists( $binding ) ) {
$implementation = tribe( $binding );
if ( method_exists( $implementation, $method ) ) {
$the_value = $implementation->$method();
}
}
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Reads the value from one or more functions until one returns a value that's not the default one.
*
* @since 4.9.5
*
* @param array $functions An array of functions to call, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first value that's not equal to the default one, the default value
* otherwise.
*/
protected function func( array $functions, $default ) {
$value = $default;
$the_value = self::NOT_FOUND;
foreach ( $functions as $function ) {
if ( is_callable( $function ) || function_exists( $function ) ) {
$the_value = $function();
}
if ( $the_value !== self::NOT_FOUND ) {
$value = $the_value;
break;
}
}
return $value;
}
/**
* Modifies the global context using the defined write locations to persist the altered values.
*
* Please keep in mind this will set the the global context for the whole request and, when the
* write location is an option, to the database.
* With great power comes great responsibility: think a lot before using this.
*
* @param array|null $fields An optional whitelist or blacklist of fields to write
* depending on the value of the `$whitelist` parameter;
* defaults to writing all available fields.
* @param bool $whitelist Whether the list of fields provided in the `$fields`
* parameter should be treated as a whitelist (`true`) or
* blacklist (`false`).
*
* @since 4.9.5
*/
public function dangerously_set_global_context( ?array $fields = null, $whitelist = true ) {
$locations = $this->get_locations();
if ( null !== $fields ) {
$locations = $whitelist
? array_intersect_key( $locations, array_combine( $fields, $fields ) )
: array_diff_key( $locations, array_combine( $fields, $fields ) );
}
/**
* Here we intersect with the request cache to only write values we've actually read
* or modified. If none of the two happened then there's no need to write anything.
*/
foreach ( array_intersect_key( $this->request_cache, $locations ) as $key => $value ) {
if ( ! isset( $locations[ $key ]['write'] ) ) {
continue;
}
foreach ( (array) $locations[ $key ]['write'] as $location => $targets ) {
$targets = (array) $targets;
$write_func = 'write_' . $location;
foreach ( $targets as $arg_1 => $arg_2 ) {
if ( self::FUNC === $location && is_array( $arg_2 ) && is_callable( $arg_2 ) ) {
// Handles write functions specified as an array.
$location_args = [ $arg_2 ];
} else {
$location_args = in_array( $location, self::$associative_locations, true )
? [ $arg_1, $arg_2 ]
: (array) $arg_2;
}
$args = array_merge( $location_args, [ $value ] );
call_user_func_array( [ $this, $write_func ], $args );
}
}
}
}
/**
* Writes an altered context value to a request var.
*
* @since 4.9.5
*
* @param string $request_var The request var to write.
* @param mixed $value The value to set on the request var.
*/
protected function write_request_var( $request_var, $value ) {
if ( isset( $_REQUEST ) ) {
$_REQUEST[ $request_var ] = $value;
}
if ( isset( $_GET ) ) {
$_GET[ $request_var ] = $value;
}
if ( isset( $_POST ) ) {
$_POST[ $request_var ] = $value;
}
}
/**
* Writes an altered context value to a global WP_Query object properties.
*
* @since 4.9.5
*
* @param string $query_prop The global WP_Query object property to write.
* @param mixed $value The value to set on the query property.
*/
protected function write_query_prop( $query_prop, $value ) {
global $wp_query;
if ( ! $wp_query instanceof WP_Query ) {
return;
}
$wp_query->{$query_prop} = $value;
}
/**
* Writes an altered context value to a global WP_Query object query var.
*
* @since 4.9.5
*
* @param string $query_var The global WP_Query query var to write.
* @param mixed $value The value to set on the query var.
*/
protected function write_query_var( $query_var, $value ) {
global $wp_query;
if ( ! $wp_query instanceof WP_Query ) {
return;
}
$wp_query->set( $query_var, $value );
}
/**
* Writes an altered context value to a `tribe_option`.
*
* @since 4.9.5
*
* @param string $tribe_option The `tribe_option` to write.
* @param mixed $value The value to set on the `tribe_option`.
*/
protected function write_tribe_option( $tribe_option, $value ) {
tribe_update_option( $tribe_option, $value );
}
/**
* Writes an altered context value to an option.
*
* @since 4.9.5
*
* @param string $option_name The option to write.
* @param mixed $value The value to set on the option.
*/
protected function write_option( $option_name, $value ) {
update_option( $option_name, $value );
}
/**
* Writes an altered context value to a transient.
*
* @since 4.9.5
*
* @param string $transient The transient to write.
* @param int $expiration The transient expiration time, in seconds.
* @param mixed $value The value to set on the transient.
*/
protected function write_transient( $transient, $expiration, $value ) {
set_transient( $transient, $value, $expiration );
}
/**
* Writes an altered context value to a constant.
*
* @since 4.9.5
*
* @param string $constant The constant to define.
* @param mixed $value The value to set on the constant.
*/
protected function write_constant( $constant, $value ) {
if ( defined( $constant ) ) {
return;
}
define( $constant, $value );
}
/**
* Writes an altered context value to a global var.
*
* @since 4.9.5
*
* @param string $global_var The global var to set.
* @param mixed $value The value to set on the global_var.
*/
protected function write_global_var( $global_var, $value ) {
$GLOBALS[ $global_var ] = $value;
}
/**
* Writes an altered context value setting a public static property on a class.
*
* @since 4.9.5
*
* @param string $class The class to set the static public property on.
* @param string $prop The static public property to set.
* @param mixed $value The value to set on the property.
*/
protected function write_static_prop( $class, $prop, $value ) {
if ( ! ( class_exists( $class ) && property_exists( $class, $prop ) ) ) {
return;
}
$class::$$prop = $value;
}
/**
* Writes an altered context value setting a public property on a `tribe()` binding.
*
* @since 4.9.5
*
* @param string $binding The container binding to set the public property on.
* @param string $prop The public property to set.
* @param mixed $value The value to set on the property.
*/
protected function write_prop( $binding, $prop, $value ) {
if ( ! tribe()->offsetExists( $binding ) ) {
return;
}
$implementation = tribe( $binding );
if ( ! property_exists( $implementation, $prop ) ) {
return;
}
$implementation->{$prop} = $value;
}
/**
* Writes an altered context value calling a public static method on a class.
*
* @since 4.9.5
*
* @param string $class The class to call the public static method on.
* @param string $method The static method to call.
* @param mixed $value The value to pass to the public static method.
*/
protected function write_static_method( $class, $method, $value ) {
if ( ! class_exists( $class ) ) {
return;
}
call_user_func( [ $class, $method ], $value );
}
/**
* Writes an altered context value calling a public method on a `tribe()` binding.
*
* @since 4.9.5
*
* @param string $binding The `tribe()` container binding to call the public method on.
* @param string $method The method to call.
* @param mixed $value The value to pass to the public method.
*/
protected function write_method( $binding, $method, $value ) {
if ( ! tribe()->offsetExists( $binding ) ) {
return;
}
call_user_func( [ tribe( $binding ), $method ], $value );
}
/**
* Writes an altered context value calling a function or closure.
*
* @since 4.9.5
*
* @param callable $func function, closure or callable to call.
* @param mixed $value The value to pass to the callable.
*/
protected function write_func( $func, $value ) {
if ( ! is_callable( $func ) ) {
return;
}
call_user_func( $func, $value );
}
/**
* Adds/replaces read and write locations to a context.
*
* Locations are merged with an `array_merge` call. To refine the locations get them first with the
* `get_locations` method.
*
* @since 4.9.5
*
* @param array $locations An array of read and write locations to add to the context.
* The array should have the same shape as the static `$locations`
* one: `[ <location> => [ 'read' => <read_locations>, 'write' => <write_locations> ] ]`.
*
*
* @return \Tribe__Context A clone of the current context with the additional read and
* write locations added.
*/
public function add_locations( array $locations ) {
$clone = clone $this;
$clone->override_locations = array_merge( $clone->override_locations, $locations );
return $clone;
}
/**
* Sets, replacing them, the locations used by this context.
*
* @since 4.9.5
* @since 6.5.5 Remove the $use_default_locations parameter.
*
* @param array $locations An array of locations to replace the current ones.
*
* @return \Tribe__Context A clone of the current context with modified locations.
*/
public function set_locations( array $locations ) {
$clone = clone $this;
$clone::$locations = [];
$clone->override_locations = $locations;
return $clone;
}
/**
* Returns an array representation of the context.
*
* @since 4.9.5
*
* @return array An associative array of the context keys and values.
*/
public function to_array( ) {
$locations = array_keys( array_merge( $this->get_locations(), $this->request_cache ) );
$dump = [];
foreach ( $locations as $location ) {
$the_value = $this->get( $location, self::NOT_FOUND );
if ( self::NOT_FOUND === $the_value ) {
continue;
}
$dump[ $location ] = $the_value;
}
return $dump;
}
/**
* Returns the current context state in a format suitable to hydrate a Redux-like
* store on the front-end.
*
* This method is a filtered wrapper around the the `Tribe__Context::to_array` method to allow the
* customization of the format when producing a store-compatible state.
*
* @param array|null $fields An optional whitelist or blacklist of fields to include
* depending on the value of the `$whitelist` parameter;
* defaults to returning all available fields.
* @param bool $whitelist Whether the list of fields provided in the `$fields`
* parameter should be treated as a whitelist (`true`) or
* blacklist (`false`).
*
* @since 4.9.5
*
* @return array
*/
public function get_state( ?array $fields = null, $whitelist = true ): array {
$state = $this->to_array();
$is_global_context = tribe_context() === $this;
if ( null !== $fields ) {
$state = $whitelist
? array_intersect_key( $state, array_combine( $fields, $fields ) )
: array_diff_key( $state, array_combine( $fields, $fields ) );
}
/**
* Filters the Redux store compatible state produced from the current context.
*
* @since 4.9.5
*
* @param array $state The Redux store compatible state produced from the current context.
* @param bool $is_global_context Whether the context producing the state is the global one
* or a modified clone of it.
* @param Tribe__Context The context object producing the state.
*/
$state = apply_filters( 'tribe_context_state', $state, $is_global_context, $this );
if ( $is_global_context ) {
/**
* Filters the Redux store compatible state produced from the global context.
*
* While the `tribe_context_state` filter will apply to all contexts producing a
* state this filter will only apply to the global context.
*
* @since 4.9.5
*
* @param array $state The Redux store compatible state produced from the global context.
* @param Tribe__Context The global context object producing the state.
*/
$state = apply_filters( 'tribe_global_context_state', $state, $this );
}
return $state;
}
/**
* Returns an array of ORM arguments generated from the current context values.
*
* @since 4.9.5
*
* @param array|null $fields An optional whitelist or blacklist of fields to include
* depending on the value of the `$whitelist` parameter;
* defaults to returning all available fields.
* @param bool $whitelist Whether the list of fields provided in the `$fields`
* parameter should be treated as a whitelist (`true`) or
* blacklist (`false`).
*
* @return array A map of ORM fields produced from the context current values.
*/
public function get_orm_args( ?array $fields = null, $whitelist = true ) {
$locations = $this->get_locations();
$dump = $this->to_array();
$orm_args = [];
$is_global_context = tribe_context() === $this;
foreach ( $dump as $key => $value ) {
$alias = isset( $locations[ $key ]['orm_arg'] )
? $locations[ $key ]['orm_arg']
: $key;
if ( false === $alias ) {
// Do not provide the variable as an ORM arg.
continue;
}
if ( isset( $locations[ $key ]['orm_transform'] ) ) {
$value = call_user_func( $locations[ $key ]['orm_transform'], $value );
}
$orm_args[ $alias ] = $value;
}
if ( null !== $fields ) {
/*
* Only keep wanted fields, the filtering is done on the resolved aliases,
* from the perspective of the client code that might ignore the source keys.
*/
$orm_args = $whitelist
? array_intersect_key( $orm_args, array_combine( $fields, $fields ) )
: array_diff_key( $orm_args, array_combine( $fields, $fields ) );
}
/**
* Filters the ORM arguments produced from the current context.
*
* @since 4.9.5
*
* @param array $orm_args The ORM args produced from the current context.
* @param bool $is_global_context Whether the context producing the ORM args is the global one
* or a modified clone of it.
* @param Tribe__Context The context object producing the ORM args.
*/
$orm_args = apply_filters( 'tribe_context_orm_args', $orm_args, $is_global_context, $this );
if ( $is_global_context ) {
/**
* Filters the ORM arguments produced from the global context.
*
* While the `tribe_context_orm_args` filter will apply to all contexts producing ORM
* args this filter will only apply to the global context.
*
* @since 4.9.5
*
* @param array $orm_args The ORM args produced from the global context.
* @param Tribe__Context The global context object producing the ORM args.
*/
$orm_args = apply_filters( 'tribe_global_context_orm_args', $orm_args, $this );
}
return $orm_args;
}
/**
* Sets some locations that can only be set at runtime.
*
* Using a flag locations are added only once per request.
*
* @since 4.9.8
*/
protected function populate_locations(): void {
if ( static::$did_populate_locations ) {
return;
}
// To improve the class readability, and as a small optimization, locations are loaded from a file.
static::$locations = include __DIR__ . '/Context/locations.php';
static::$did_populate_locations = true;
}
/**
* Just dont...
* Unless you very specifically know what you are doing **DO NOT USE THIS METHOD**!
*
* Please keep in mind this will set force the context to repopulate all locations for the whole request, expensive
* and very dangerous overall since it could affect all this things we hold dear in the request.
*
* With great power comes great responsibility: think a lot before using this.
*
* @since 4.13.0
*/
public function dangerously_repopulate_locations() {
static::$did_populate_locations = false;
$this->get_locations();
}
/**
* Reads (gets) the value applying one or more filters.
*
* @since 4.9.8
*
* @param array $filters The list of filters to apply, in order.
* @param mixed $default The default value to return.
*
* @return mixed The first valid value found or the default value.
*/
public function filter( array $filters, $default ) {
foreach ( $filters as $filter ) {
$the_value = apply_filters( $filter, $default );
if ( $the_value !== $default ) {
return $the_value;
}
}
return $default;
}
/**
* Reads (gets) the value reading it from a query var parsed from the global `$wp` object.
*
* @since 4.9.8
*
* @param array $vars The list of variables to read, in order.
* @param mixed $default The default value to return if no variable was parsed.
*
* @return mixed The first valid value found or the default value.
*/
public function wp_parsed( array $vars, $default ) {
/** @var WP $wp */
global $wp;
if ( ! $wp instanceof WP || empty($wp->query_vars) ) {
return $default;
}
return Arr::get_first_set( (array) $wp->query_vars, $vars, $default );
}
/**
* Reads (gets) the value reading it from a query var parsed from the query matched by the global `$wp` object.
*
* @since 4.9.8
*
* @param array $vars The list of variables to read, in order.
* @param mixed $default The default value to return if no variable was parsed.
*
* @return mixed The first valid value found or the default value.
*/
public function wp_matched_query( array $vars, $default ) {
/** @var WP $wp */
global $wp;
if ( ! $wp instanceof WP || empty( $wp->matched_query ) ) {
return $default;
}
parse_str( $wp->matched_query, $query_vars );
return Arr::get_first_set( (array) $query_vars, $vars, $default );
}
/**
* Maps an input array to the corresponding read locations.
*
* The resulting array can be used as input for the `alter_values` method.
* The main use of this method is to leverage the Context knowledge of the read locations, and their types, to
* "translate" an array of values to an array of valid read sources. As an example this is useful to "translate"
* the locations to an array of query vars:
* $input = [ 'event_display' => 'some-view', 'event_date' => '2018-01-03' ];
* $query_args = tribe_context()->map_to_read( $input, Tribe__Context::REQUEST_VAR );
* $url = add_query_arg( $query_args, home_url() );
*
* @since 4.9.11
*
* @param array $input An associative array of values in the shape `[ <location> => <value> ]`;
* where `location` is the name of the location registered in the Context
* locations.
* @param string|array|null $types A white-list of read location types to include in the mapped output;
* `null`
* means all types are allowed.
* @param bool $passthru Whether to pass unknown locations in the output or not; if `false` then
* any input key that's not a context location will not appear in the output;
* defaults to `false` to remove unknown locations from the output.
*
* @return array An associative array in the shape `[ <read_location> => <input_value> ]`. Since some read
* locations could have multiple sources the number of elements in this array will likely NOT be the
* same as the number of elements in the input array. When a read location as more than 1 source then
* the value will be duplicated, in the output array, to both sources.
*/
public function map_to_read( array $input, $types = null, $passthru = false ) {
$mapped = [];
$processed = [];
$types = null !== $types ? (array) $types : null;
$locations = $this->get_locations();
// Take the current read locations
foreach ( $locations as $key => $location ) {
if ( ! isset( $location['read'], $input[ $key ] ) ) {
continue;
}
$processed[] = $key;
foreach ( $location['read'] as $type => $name ) {
if ( null !== $types && ! in_array( $type, $types, true ) ) {
continue;
}
foreach ( (array) $name as $destination ) {
$mapped[ $destination ] = $input[ $key ];
}
}
}
if ( $passthru ) {
$mapped = array_merge(
$mapped,
array_diff_key( $input, array_keys( $locations ), array_combine( $processed, $processed ) )
);
}
ksort( $mapped );
return $mapped;
}
/**
* Translates sub-locations to their respective location key.
*
* This method leverages the inherent knowledge of aliases stored in the Context locations to "translate" a
* sub-location to its location key.
* E.g. assume the `car` location is `read` from the [ 'carriage', 'vehicle', 'transport_mean' ] query var; calling
* `$context->populate_aliases( [ 'vehicle' => 'hyunday' ], 'read', Context::QUERY_VAR )` would yield
* `[ 'car' => 'hyunday' ]`.
*
* @since 4.9.12
*
* @param array $values An associative array of value to use as "masters" to populate the aliases.
* @param string $type The type of Context location to use, e.g. `Tribe__Context::QUERY_VAR`.
* @param string $direction The direction to use for the location, one of `read` or `write`.
*
* @return array The original array, merged with the populated values.
*/
public function translate_sub_locations( array $values, $type, $direction = 'read' ) {
if ( ! in_array( $direction, [ 'read', 'write' ], true ) ) {
throw new \InvalidArgumentException(
"Direction must be one of `read` or `write`; `{$direction}` is not valid."
);
}
$filled = [];
$locations = $this->get_locations();
$matching_locations = array_filter( $locations, static function ( $location ) use ( $type, $direction ) {
return isset( $location[ $direction ][ $type ] );
} );
foreach ( $matching_locations as $key => $location ) {
$entry = (array)$location[ $direction ][ $type ];
$found = array_intersect( array_keys( $values ), array_merge( $entry, [ $key ] ) );
if ( $found ) {
$filled[ $key ] = $values[ reset( $found ) ];
}
}
return $filled;
}
/**
* Convenience method to get and check if a location has a truthy value or not.
*
* @since 4.9.18
*
* @param string $flag_key The location to check.
* @param bool $default The default value to return if the location is not set.
*
* @return bool Whether the location has a truthy value or not.
*/
public function is( $flag_key, $default = false ) {
$val = $this->get( $flag_key, $default );
return ! empty( $val ) || tribe_is_truthy( $val );
}
/**
* Reads the value from one callback, passing it the value of another Context location.
*
* @since 4.9.18
*
* @param array $location_and_callback An array of two elements: the location key and the callback to call on the
* location value. The callback will receive the location value as argument.
*
* @return mixed The return value of the callback, called on the location value.
*/
public function location_func( array $location_and_callback ) {
list( $location, $callback ) = $location_and_callback;
return $callback( $this->get( $location ) );
}
/**
* Checks whether the current request is a REST API one or not.
*
* @since 4.9.20
*
* @return bool Whether the current request is a REST API one or not.
*/
public function doing_rest() {
return defined( 'REST_REQUEST' ) && REST_REQUEST;
}
/**
* Reads the value from one or more global WP_Query object methods.
*
* @since 4.9.20
*
* @param array $query_vars The list of query methods to call, in order.
* @param mixed $default The default value to return if no method was defined on the global `WP_Query` object.
*
* @return mixed The first valid value found or the default value.
*/
public function query_method( $methods, $default ) {
global $wp_query;
$found = $default;
foreach ( $methods as $method ) {
$this_value = $wp_query instanceof WP_Query && method_exists( $wp_query, $method )
? call_user_func( [ $wp_query, $method ] )
: static::NOT_FOUND;
if ( static::NOT_FOUND !== $this_value ) {
return $this_value;
}
}
return $found;
}
/**
* Whether the current request is for a PHP-rendered initial state or not.
*
* This method is a shortcut to make sure we're not doing an AJAX, REST or Cron request.
*
* @since 4.9.20
*
* @return bool Whether the current request is for a PHP-rendered initial state or not.
*/
public function doing_php_initial_state() {
return ! $this->doing_rest() && ! $this->doing_ajax() && ! $this->doing_cron();
}
/**
* Returns the first key, if there are many, that will be used to read a location.
*
* The type ar
*
* @since 4.9.20
*
* @param string $location The location to get the read key for.
* @param string|null $type The type of read location to return the key for; default to `static::REQUEST_VAR`.
*
* @return string Either the first key for the type of read location, or the input location if not found.
*/
public function get_read_key_for( $location, $type = null ) {
$type = $type ?: static::REQUEST_VAR;
$locations = $this->get_locations();
if ( isset( $locations[ $location ]['read'][ $type ] ) ) {
$keys = (array) $locations[ $location ]['read'][ $type ];
return reset( $keys );
}
return $location;
}
/**
* Safely set the value of a group of locations.
*
* This method can only augment the context, without altering it; it can only add new values.
*
* @since 4.10.2
*
* @param array|string $values The values to set, if not already set or the key of the value to set, requires
* the `$value` to be passed.
* @param mixed|null $value The value to set for the key, this parameter will be ignored if the `$values_or_key`
* parameter is not a string.
*/
public function safe_set( $values_or_key, $value = null ) {
$values = func_num_args() === 2
? [ $values_or_key => $value ]
: $values_or_key;
foreach ( $values as $key => $val ) {
if ( static::NOT_FOUND !== $this->get( $key, static::NOT_FOUND ) ) {
continue;
}
$this->request_cache[ $key ] = $val;
}
}
/**
* Whether the current request is one to edit a list of the specified post types or not.
*
* The admin edit screen for a post type is the one that lists all the posts of that typ,
* it has the URL `/wp-admin/edit.php?post_type=<post_type>`.
*
* @since 5.0.13
* @since 5.0.13 Extracted the logic to the `TEC\Common\Context\Post_Request_Type` class.
*
* @param string|array<string> $post_type The post type or post types to check.
*
* @return bool Whether the current request is one to edit a list of the specified post types or not.
*/
public function is_editing_posts_list( $post_type ): bool {
return $this->post_state->is_editing_post_list( $post_type );
}
/**
* Whether the current request is one to quick edit a single post of the specified post type or not.
*
* @since 5.0.13
*
* @param string|array<string> $post_type The post type or post types to check.
*
* @return bool Whether the current request is one to quick edit a single post of the specified post type or not.
*/
public function is_inline_editing_post( $post_type ): bool {
return $this->post_state->is_inline_editing_post( $post_type );
}
}