wp-parsely / src / Endpoints / class-rest-metadata.php

class-rest-metadata.php in Parse.ly 3.3.2, at src/Endpoints/class-rest-metadata.php

120 lines 3.3 KB

Raw Download Zip

1	<?php
2	/**
3	* Endpoints: REST Metadata endpoint class
4	*
5	* @package Parsely
6	* @since 3.1.0
7	*/
8
9	declare(strict_types=1);
10
11	namespace Parsely\Endpoints;
12
13	use Parsely\Metadata;
14	use WP_Post;
15
16	/**
17	* Injects Parse.ly Metadata to WordPress REST API.
18	*
19	* @since 3.1.0
20	* @since 3.2.0 Renamed FQCN from `Parsely\Rest` to `Parsely\Endpoints\Rest_Metadata`.
21	*/
22	class Rest_Metadata extends Metadata_Endpoint {
23	private const REST_VERSION = '1.1.0';
24
25	/**
26	* Registers fields in WordPress REST API.
27	*
28	* @since 3.1.0
29	*/
30	public function run(): void {
31	/**
32	* Filter whether REST API support is enabled or not.
33	*
34	* @since 3.1.0
35	*
36	* @param bool $enabled True if enabled, false if not.
37	*/
38	if ( apply_filters( 'wp_parsely_enable_rest_api_support', true ) && $this->parsely->api_key_is_set() ) {
39	$this->register_meta();
40	}
41	}
42
43	/**
44	* Registers the meta field on the appropriate resource types in the REST API.
45	*
46	* @since 3.1.0
47	*/
48	public function register_meta(): void {
49	$options = $this->parsely->get_options();
50	$object_types = array_unique( array_merge( $options['track_post_types'], $options['track_page_types'] ) );
51
52	/**
53	* Filters the list of object types that the Parse.ly REST API is hooked into.
54	*
55	* @since 3.1.0
56	*
57	* @param string[] $object_types Array of strings containing the object types, i.e. `page`,
58	* `post`, `term`.
59	*/
60	$object_types = apply_filters( 'wp_parsely_rest_object_types', $object_types );
61
62	$args = array( 'get_callback' => array( $this, 'get_callback' ) );
63	register_rest_field( $object_types, self::FIELD_NAME, $args );
64	}
65
66	/**
67	* Function to get hooked into the `get_callback` property of the `parsely`
68	* REST API field. It generates the `parsely` object in the REST API.
69	*
70	* @param array $object The WordPress object to extract to render the metadata for,
71	* usually a post or a page.
72	* @return array<string, mixed> The `parsely` object to be rendered in the REST API. Contains a
73	* version number describing the response and the `meta` object
74	* containing the actual metadata.
75	*/
76	public function get_callback( array $object ): array {
77	$post_id = $object['ID'] ?? $object['id'] ?? 0;
78	$post = WP_Post::get_instance( $post_id );
79	$options = $this->parsely->get_options();
80
81	if ( false === $post ) {
82	$metadata = '';
83	} else {
84	$metadata = ( new Metadata( $this->parsely ) )->construct_metadata( $post );
85	}
86
87	$response = array(
88	'version' => self::REST_VERSION,
89	'meta' => $metadata,
90	);
91
92	/**
93	* Filter whether REST API support in rendered string format is enabled
94	* or not.
95	*
96	* @since 3.1.0
97	*
98	* @param bool $enabled True if enabled, false if not.
99	* @param WP_Post\|false $post Current post object.
100	*/
101	if ( apply_filters( 'wp_parsely_enable_rest_rendered_support', true, $post ) ) {
102	$response['rendered'] = $this->get_rendered_meta( $options['meta_type'] );
103	}
104
105	/**
106	* Filter whether the REST API returns the tracker URL.
107	*
108	* @since 3.3.0
109	*
110	* @param bool $enabled True if enabled, false if not.
111	* @param WP_Post\|false $post Current post object.
112	*/
113	if ( apply_filters( 'wp_parsely_enable_tracker_url', true, $post ) ) {
114	$response['tracker_url'] = $this->parsely->get_tracker_url();
115	}
116
117	return $response;
118	}
119	}
120