The Events Calendar - Version 4.4.2

	@@ -81,7 +81,7 @@ if ( ! function_exists( 'tribe_singleton' ) ) {
81	* construction.
82	*/
83	function tribe_singleton( $slug, $class, array $after_build_methods = null ) {
84	- Tribe__Container::instance()->~~singleton~~( $slug, $class, $after_build_methods );
85	}
86	}
87
	@@ -145,7 +145,7 @@ if ( ! function_exists( 'tribe_register' ) ) {
145	* will be called each time after the instance contstruction.
146	*/
147	function tribe_register( $slug, $class, array $after_build_methods = null ) {
148	- Tribe__Container::instance()->~~bind~~( $slug, $class, $after_build_methods );
149	}
150	}
151


81	* construction.
82	*/
83	function tribe_singleton( $slug, $class, array $after_build_methods = null ) {
84	+ Tribe__Container::instance()->replaceSingleton( $slug, $class, $after_build_methods );
85	}
86	}
87

145	* will be called each time after the instance contstruction.
146	*/
147	function tribe_register( $slug, $class, array $after_build_methods = null ) {
148	+ Tribe__Container::instance()->replaceBind( $slug, $class, $after_build_methods );
149	}
150	}
151


1	+ <?php
2	+
3	+ interface Tribe__Documentation__Swagger__Builder_Interface {
4	+ /**
5	+ * Registers a documentation provider for a path.
6	+ *
7	+ * @param $path
8	+ * @param Tribe__REST__Endpoints__Endpoint_Interface $endpoint
9	+ */
10	+ public function register_documentation_provider( $path, Tribe__Documentation__Swagger__Provider_Interface $endpoint );
11	+
12	+ /**
13	+ * @return Tribe__Documentation__Swagger__Provider_Interface[]
14	+ */
15	+ public function get_registered_documentation_providers();
16	+
17	+ /**
18	+ * Registers a documentation provider for a definition.
19	+ *
20	+ * @param string $type
21	+ * @param Tribe__Documentation__Swagger__Provider_Interface $provider
22	+ */
23	+ public function register_definition_provider( $type, Tribe__Documentation__Swagger__Provider_Interface $provider );
24	+
25	+ /**
26	+ * @return Tribe__Documentation__Swagger__Provider_Interface[]
27	+ */
28	+ public function get_registered_definition_providers();
29	+ }


1	+ <?php
2	+
3	+ class Tribe__Documentation__Swagger__Cost_Details_Definition_Provider
4	+ implements Tribe__Documentation__Swagger__Provider_Interface {
5	+
6	+ /**
7	+ * Returns an array in the format used by Swagger 2.0.
8	+ *
9	+ * While the structure must conform to that used by v2.0 of Swagger the structure can be that of a full document
10	+ * or that of a document part.
11	+ * The intelligence lies in the "gatherer" of informations rather than in the single "providers" implementing this
12	+ * interface.
13	+ *
14	+ * @link http://swagger.io/
15	+ *
16	+ * @return array An array description of a Swagger supported component.
17	+ */
18	+ public function get_documentation() {
19	+ $documentation = array(
20	+ 'type' => 'array',
21	+ 'properties' => array(
22	+ 'currency_symbol' => array(
23	+ 'type' => 'string',
24	+ 'description' => __( 'The cost currency symbol', 'tribe-common' ),
25	+ ),
26	+ 'currency_position ' => array(
27	+ 'type' => 'string',
28	+ 'description' => __( 'The position of the currency symbol in the cost string', 'tribe-common' ),
29	+ 'enum' => array( 'prefix', 'postfix' ),
30	+ ),
31	+ 'values' => array(
32	+ 'type' => 'array',
33	+ 'description' => __( 'An sorted array of all the numeric values for the cost', 'tribe-common' ),
34	+ ),
35	+ ),
36	+ );
37	+
38	+ /**
39	+ * Filters the Swagger documentation generated for a cost details in the TEC REST API.
40	+ *
41	+ * @param array $documentation An associative PHP array in the format supported by Swagger.
42	+ *
43	+ * @link http://swagger.io/
44	+ */
45	+ $documentation = apply_filters( 'tribe_rest_swagger_cost_details_documentation', $documentation );
46	+
47	+ return $documentation;
48	+ }
49	+ }


1	+ <?php
2	+
3	+ class Tribe__Documentation__Swagger__Date_Details_Definition_Provider
4	+ implements Tribe__Documentation__Swagger__Provider_Interface {
5	+
6	+ /**
7	+ * Returns an array in the format used by Swagger 2.0.
8	+ *
9	+ * While the structure must conform to that used by v2.0 of Swagger the structure can be that of a full document
10	+ * or that of a document part.
11	+ * The intelligence lies in the "gatherer" of informations rather than in the single "providers" implementing this
12	+ * interface.
13	+ *
14	+ * @link http://swagger.io/
15	+ *
16	+ * @return array An array description of a Swagger supported component.
17	+ */
18	+ public function get_documentation() {
19	+ $documentation = array(
20	+ 'type' => 'array',
21	+ 'properties' => array(
22	+ 'year' => array(
23	+ 'type' => 'int',
24	+ 'description' => __( 'The date year', 'tribe-common' ),
25	+ ),
26	+ 'month' => array(
27	+ 'type' => 'int',
28	+ 'description' => __( 'The date month', 'tribe-common' ),
29	+ ),
30	+ 'day' => array(
31	+ 'type' => 'int',
32	+ 'description' => __( 'The date day', 'tribe-common' ),
33	+ ),
34	+ 'hour' => array(
35	+ 'type' => 'int',
36	+ 'description' => __( 'The date hour', 'tribe-common' ),
37	+ ),
38	+ 'minutes' => array(
39	+ 'type' => 'int',
40	+ 'description' => __( 'The date minutes', 'tribe-common' ),
41	+ ),
42	+ 'seconds' => array(
43	+ 'type' => 'int',
44	+ 'description' => __( 'The date seconds', 'tribe-common' ),
45	+ ),
46	+ ),
47	+ );
48	+
49	+ /**
50	+ * Filters the Swagger documentation generated for an date details in the TEC REST API.
51	+ *
52	+ * @param array $documentation An associative PHP array in the format supported by Swagger.
53	+ *
54	+ * @link http://swagger.io/
55	+ */
56	+ $documentation = apply_filters( 'tribe_rest_swagger_date_details_documentation', $documentation );
57	+
58	+ return $documentation;
59	+ }
60	+ }

The Events Calendar - Version 4.4.2

Version Description

Release Info

Code changes from version 4.4.1 to 4.4.2

Developer	barry.hughes
Plugin	The Events Calendar
Version	4.4.2
Comparing to
See all releases


1	+ <?php
2	+
3	+ class Tribe__Documentation__Swagger__Image_Definition_Provider
4	+ implements Tribe__Documentation__Swagger__Provider_Interface {
5	+
6	+ /**
7	+ * Returns an array in the format used by Swagger 2.0.
8	+ *
9	+ * While the structure must conform to that used by v2.0 of Swagger the structure can be that of a full document
10	+ * or that of a document part.
11	+ * The intelligence lies in the "gatherer" of informations rather than in the single "providers" implementing this
12	+ * interface.
13	+ *
14	+ * @link http://swagger.io/
15	+ *
16	+ * @return array An array description of a Swagger supported component.
17	+ */
18	+ public function get_documentation() {
19	+ $documentation = array(
20	+ 'type' => 'object',
21	+ 'properties' => array(
22	+ 'url' => array(
23	+ 'type' =>'string',
24	+ 'description' =>__('The URL to the full size version of the image', 'tribe-common'),
25	+ ),
26	+ 'id' => array(
27	+ 'type' => 'int',
28	+ 'description' => __( 'The image WordPress post ID', 'tribe-common' ),
29	+ ),
30	+ 'extension' => array(
31	+ 'type' =>'string',
32	+ 'description' =>__('The image file extension', 'tribe-common'),
33	+ ),
34	+ 'width' => array(
35	+ 'type' => 'int',
36	+ 'description' => __( 'The image natural width in pixels', 'tribe-common' ),
37	+ ),
38	+ 'height' => array(
39	+ 'type' => 'int',
40	+ 'description' => __( 'The image natura height in pixels', 'tribe-common' ),
41	+ ),
42	+ 'sizes' => array(
43	+ 'type' => 'array',
44	+ 'description' => __( 'The details about each size available for the image', 'tribe-common' ),
45	+ '$ref' => '#/definitions/ImageSize',
46	+ ),
47	+ ),
48	+ );
49	+
50	+ /**
51	+ * Filters the Swagger documentation generated for an image deatails in the TEC REST API.
52	+ *
53	+ * @param array $documentation An associative PHP array in the format supported by Swagger.
54	+ *
55	+ * @link http://swagger.io/
56	+ */
57	+ $documentation = apply_filters( 'tribe_rest_swagger_image_details_documentation', $documentation );
58	+
59	+ return $documentation;
60	+ }
61	+ }


1	+ <?php
2	+
3	+ class Tribe__Documentation__Swagger__Term_Definition_Provider
4	+ implements Tribe__Documentation__Swagger__Provider_Interface {
5	+
6	+ /**
7	+ * Returns an array in the format used by Swagger 2.0.
8	+ *
9	+ * While the structure must conform to that used by v2.0 of Swagger the structure can be that of a full document
10	+ * or that of a document part.
11	+ * The intelligence lies in the "gatherer" of informations rather than in the single "providers" implementing this
12	+ * interface.
13	+ *
14	+ * @link http://swagger.io/
15	+ *
16	+ * @return array An array description of a Swagger supported component.
17	+ */
18	+ public function get_documentation() {
19	+ $documentation = array(
20	+ 'type' => 'object',
21	+ 'properties' => array(
22	+ 'id' => array(
23	+ 'type' => 'int',
24	+ 'description' => __( 'The WordPress term ID', 'tribe-common' ),
25	+ ),
26	+ 'name' => array(
27	+ 'type' => 'string',
28	+ 'description' => __( 'The term name', 'tribe-common' ),
29	+ ),
30	+ 'slug' => array(
31	+ 'type' => 'string',
32	+ 'description' => __( 'The term slug', 'tribe-common' ),
33	+ ),
34	+ 'taxonomy' => array(
35	+ 'type' => 'string',
36	+ 'description' => __( 'The taxonomy the term belongs to', 'tribe-common' ),
37	+ ),
38	+ 'description' => array(
39	+ 'type' => 'string',
40	+ 'description' => __( 'The term description', 'tribe-common' ),
41	+ ),
42	+ 'parent' => array(
43	+ 'type' => 'int',
44	+ 'description' => __( 'The term parent term if any', 'tribe-common' ),
45	+ ),
46	+ 'count' => array(
47	+ 'type' => 'int',
48	+ 'description' => __( 'The number of posts associated with the term', 'tribe-common' ),
49	+ ),
50	+ 'link' => array(
51	+ 'type' => 'string',
52	+ 'description' => __( 'The URL to the term archive page', 'tribe-common' ),
53	+ ),
54	+ ),
55	+ );
56	+
57	+ /**
58	+ * Filters the Swagger documentation generated for an term in the TEC REST API.
59	+ *
60	+ * @param array $documentation An associative PHP array in the format supported by Swagger.
61	+ *
62	+ * @link http://swagger.io/
63	+ */
64	+ $documentation = apply_filters( 'tribe_rest_swagger_term_documentation', $documentation );
65	+
66	+ return $documentation;
67	+ }
68	+ }


1	+ <?php
2	+
3	+
4	+ interface Tribe__REST__Endpoints__Endpoint_Interface {
5	+
6	+ /**
7	+ * Handles GET requests on the endpoint.
8	+ *
9	+ * @param WP_REST_Request $request
10	+ *
11	+ * @return WP_Error\|WP_REST_Response An array containing the data on success or a WP_Error instance on failure.
12	+ */
13	+ public function get( WP_REST_Request $request );
14	+ }


1	+ <?php
2	+
3	+ /**
4	+ * Class Tribe__REST__Exceptions__Exception
5	+ */
6	+ class Tribe__REST__Exceptions__Exception extends Exception {
7	+ /**
8	+ * @var int
9	+ */
10	+ protected $status;
11	+
12	+ public function __construct( $message, $code, $status ) {
13	+ $this->message = $message;
14	+ $this->code = $code;
15	+ $this->status = $status;
16	+ }
17	+
18	+ /**
19	+ * Return the error status.
20	+ * @return int
21	+ */
22	+ public function getStatus() {
23	+ return $this->status;
24	+ }
25	+ }


1	+ <?php
2	+
3	+
4	+ abstract class Tribe__REST__Headers__Base_Header {
5	+
6	+ /**
7	+ * @var Tribe__REST__Headers__Base_Interface
8	+ */
9	+ protected $base;
10	+
11	+ /**
12	+ * Tribe__REST__Headers__Base_Header constructor.
13	+ *
14	+ * @param Tribe__REST__Headers__Base_Interface $base
15	+ */
16	+ public function __construct( Tribe__REST__Headers__Base_Interface $base ) {
17	+ $this->base = $base;
18	+ }
19	+ }


1	+ <?php
2	+
3	+
4	+ /**
5	+ * Interface Tribe__REST__Headers__Base_Interface
6	+ *
7	+ * Provides basic information for the
8	+ */
9	+ interface Tribe__REST__Headers__Base_Interface {
10	+ /**
11	+ * Returns the header that the REST API will print on the page head to report
12	+ * its version.
13	+ *
14	+ * @return string
15	+ */
16	+ public function get_api_version_header();
17	+
18	+ /**
19	+ * Returns the header the REST API will print on the page head to report its root
20	+ * url.
21	+ *
22	+ * @return string
23	+ */
24	+ public function get_api_root_header();
25	+
26	+ /**
27	+ * Returns the `name` of the meta tag that will be printed on the page to indicate
28	+ * the REST API version.
29	+ *
30	+ * @return string
31	+ */
32	+ public function get_api_version_meta_name();
33	+
34	+ /**
35	+ * Returns the REST API URL.
36	+ *
37	+ * @return string
38	+ */
39	+ public function get_rest_url();
40	+ }


1	+ <?php
2	+
3	+
4	+ class Tribe__REST__Headers__Disabled extends Tribe__REST__Headers__Base_Header implements Tribe__REST__Headers__Headers_Interface {
5	+
6	+ /**
7	+ * Prints TEC REST API related meta on the site.
8	+ */
9	+ public function add_header() {
10	+ // no-op
11	+ }
12	+
13	+ /**
14	+ * Sends TEC REST API related headers.
15	+ */
16	+ public function send_header() {
17	+ if ( headers_sent() ) {
18	+ return;
19	+ }
20	+
21	+ header( $this->base->get_api_version_header() . ': disabled' );
22	+ }
23	+ }


1	+ <?php
2	+
3	+ /**
4	+ * Class Tribe__REST__Headers__Headers_Interface
5	+ *
6	+ * Handles headers and header equivalent to be printed/sent in responses.
7	+ */
8	+ interface Tribe__REST__Headers__Headers_Interface {
9	+ /**
10	+ * Prints the REST API related meta on the site.
11	+ */
12	+ public function add_header();
13	+
14	+ /**
15	+ * Sends the REST API related headers.
16	+ */
17	+ public function send_header();
18	+ }


1	+ <?php
2	+
3	+
4	+ class Tribe__REST__Headers__Supported extends Tribe__REST__Headers__Base_Header implements Tribe__REST__Headers__Headers_Interface {
5	+
6	+ /**
7	+ * @var Tribe__Events__Main
8	+ */
9	+ protected $main;
10	+
11	+ public function __construct( Tribe__REST__Headers__Base_Interface $base, Tribe__REST__Main $main ) {
12	+ parent::__construct( $base );
13	+ $this->main = $main;
14	+ }
15	+
16	+ /**
17	+ * Prints TEC REST API related meta on the site.
18	+ */
19	+ public function add_header() {
20	+ $api_root = $this->base->get_rest_url();
21	+
22	+ if ( empty( $api_root ) ) {
23	+ return;
24	+ }
25	+
26	+ printf(
27	+ '<meta name="%s" content="%s"> <link rel="%s" href="%s" />',
28	+ esc_attr( $this->base->get_api_version_meta_name() ),
29	+ esc_attr( $this->main->get_version() ),
30	+ esc_attr( $this->main->get_reference_url() ),
31	+ esc_url( $api_root )
32	+ );
33	+ }
34	+
35	+ /**
36	+ * Sends TEC REST API related headers.
37	+ */
38	+ public function send_header() {
39	+ if ( headers_sent() ) {
40	+ return;
41	+ }
42	+
43	+ $api_root = $this->base->get_rest_url();
44	+
45	+ if ( empty( $api_root ) ) {
46	+ return;
47	+ }
48	+
49	+ header( $this->base->get_api_version_header() . ': ' . $this->main->get_version() );
50	+ header( $this->base->get_api_root_header() . ': ' . esc_url_raw( $api_root ) );
51	+ }
52	+ }


1	+ <?php
2	+
3	+
4	+ class Tribe__REST__Headers__Unsupported extends Tribe__REST__Headers__Base_Header implements Tribe__REST__Headers__Headers_Interface {
5	+
6	+ /**
7	+ * @var Tribe__REST__Main
8	+ */
9	+ protected $main;
10	+
11	+ /**
12	+ * Tribe__REST__Headers__Unsupported constructor.
13	+ *
14	+ * @param Tribe__REST__Headers__Base_Interface $base
15	+ * @param Tribe__REST__Main $main
16	+ */
17	+ public function __construct( Tribe__REST__Headers__Base_Interface $base, Tribe__REST__Main $main ) {
18	+ parent::__construct( $base );
19	+ $this->main = $main;
20	+ }
21	+
22	+ /**
23	+ * Prints TEC REST API related meta on the site.
24	+ */
25	+ public function add_header() {
26	+ // no-op
27	+ }
28	+
29	+ /**
30	+ * Sends TEC REST API related headers.
31	+ */
32	+ public function send_header() {
33	+ if ( headers_sent() ) {
34	+ return;
35	+ }
36	+
37	+ header( $this->main->get_api_version_header() . ': unsupported' );
38	+ }
39	+ }


1	+ <?php
2	+
3	+
4	+ /**
5	+ * Class Tribe__REST__Main
6	+ *
7	+ * The main entry point for a Modern Tribe REST API implementation.
8	+ *
9	+ * This class should not contain business logic and merely set up and start the REST API support.
10	+ */
11	+ abstract class Tribe__REST__Main {
12	+
13	+ /**
14	+ * Modern Tribe REST APIs URL namespace.
15	+ *
16	+ * @var string
17	+ */
18	+ protected $namespace = '/tribe';
19	+
20	+ /**
21	+ * Returns the namespace of Modern Tribe REST APIs.
22	+ *
23	+ * @return string
24	+ */
25	+ public function get_namespace() {
26	+ return $this->namespace;
27	+ }
28	+
29	+ /**
30	+ * Returns the REST API URL prefix.
31	+ *
32	+ * @return string The REST API URL prefix.
33	+ */
34	+ public function get_url_prefix() {
35	+ $use_builtin = $this->use_builtin();
36	+
37	+ if ( $use_builtin ) {
38	+ $prefix = rest_get_url_prefix();
39	+ } else {
40	+ $prefix = apply_filters( 'rest_url_prefix', 'wp-json' );
41	+ }
42	+
43	+ $default_tec_prefix = $this->namespace . $this->url_prefix();
44	+ $prefix = rtrim( $prefix, '/' ) . $default_tec_prefix;
45	+
46	+ /**
47	+ * Filters the TEC REST API URL prefix
48	+ *
49	+ * @param string $prefix The complete URL prefix.
50	+ * @param string $default_tec_prefix The default URL prefix appended to the REST URL by The Events Calendar.
51	+ */
52	+ return apply_filters( 'tribe_events_rest_url_prefix', $prefix, $default_tec_prefix );
53	+ }
54	+
55	+ /**
56	+ * Retrieves the URL to a TEC REST endpoint on a site.
57	+ *
58	+ * Note: The returned URL is NOT escaped.
59	+ *
60	+ * @global WP_Rewrite $wp_rewrite