publicize-connections.php — Jetpack – WP Security, Backup, Speed, & Growth 12.0.3

jetpack / _inc / lib / core-api / wpcom-endpoints / publicize-connections.php

jetpack / _inc / lib / core-api / wpcom-endpoints Last commit date

publicize-connections.php

218 lines

1	<?php // phpcs:ignore WordPress.Files.FileName.InvalidClassFileName
2	/**
3	* Fetch information about Publicize connections on a site.
4	*
5	* @package automattic/jetpack
6	*/
7
8	/**
9	* Publicize: List Connections
10	*
11	* [
12	* { # Connnection Object. See schema for more detail.
13	* id: (string) Connection unique_id
14	* service_name: (string) Service slug
15	* display_name: (string) User name/display name of user/connection on Service
16	* global: (boolean) Is the Connection available to all users of the site?
17	* },
18	* ...
19	* ]
20	*
21	* @since 6.8
22	*/
23	class WPCOM_REST_API_V2_Endpoint_List_Publicize_Connections extends WP_REST_Controller {
24	/**
25	* Flag to help WordPress.com decide where it should look for
26	* Publicize data. Ignored for direct requests to Jetpack sites.
27	*
28	* @var bool $wpcom_is_wpcom_only_endpoint
29	*/
30	public $wpcom_is_wpcom_only_endpoint = true;
31
32	/**
33	* Constructor.
34	*/
35	public function __construct() {
36	$this->namespace = 'wpcom/v2';
37	$this->rest_base = 'publicize/connections';
38
39	add_action( 'rest_api_init', array( $this, 'register_routes' ) );
40	}
41
42	/**
43	* Called automatically on `rest_api_init()`.
44	*/
45	public function register_routes() {
46	register_rest_route(
47	$this->namespace,
48	'/' . $this->rest_base,
49	array(
50	array(
51	'methods' => WP_REST_Server::READABLE,
52	'callback' => array( $this, 'get_items' ),
53	'permission_callback' => array( $this, 'get_items_permission_check' ),
54	),
55	'schema' => array( $this, 'get_public_item_schema' ),
56	)
57	);
58	}
59
60	/**
61	* Helper for generating schema. Used by this endpoint and by the
62	* Connection Test Result endpoint.
63	*
64	* @internal
65	* @return array
66	*/
67	protected function get_connection_schema_properties() {
68	return array(
69	'id' => array(
70	'description' => __( 'Unique identifier for the Jetpack Social connection', 'jetpack' ),
71	'type' => 'string',
72	),
73	'service_name' => array(
74	'description' => __( 'Alphanumeric identifier for the Jetpack Social service', 'jetpack' ),
75	'type' => 'string',
76	),
77	'display_name' => array(
78	'description' => __( 'Username of the connected account', 'jetpack' ),
79	'type' => 'string',
80	),
81	'profile_display_name' => array(
82	'description' => __( 'The name to display in the profile of the connected account', 'jetpack' ),
83	'type' => 'string',
84	),
85	'profile_picture' => array(
86	'description' => __( 'Profile picture of the connected account', 'jetpack' ),
87	'type' => 'string',
88	),
89	'global' => array(
90	'description' => __( 'Is this connection available to all users?', 'jetpack' ),
91	'type' => 'boolean',
92	),
93	);
94	}
95
96	/**
97	* Schema for the endpoint.
98	*
99	* @return array
100	*/
101	public function get_item_schema() {
102	$schema = array(
103	'$schema' => 'http://json-schema.org/draft-04/schema#',
104	'title' => 'jetpack-publicize-connection',
105	'type' => 'object',
106	'properties' => $this->get_connection_schema_properties(),
107	);
108
109	return $this->add_additional_fields_schema( $schema );
110	}
111
112	/**
113	* Helper for retrieving Connections. Used by this endpoint and by
114	* the Connection Test Result endpoint.
115	*
116	* @internal
117	* @return array
118	*/
119	protected function get_connections() {
120	global $publicize;
121
122	$items = array();
123
124	foreach ( (array) $publicize->get_services( 'connected' ) as $service_name => $connections ) {
125	foreach ( $connections as $connection ) {
126	$connection_meta = $publicize->get_connection_meta( $connection );
127	$connection_data = $connection_meta['connection_data'];
128
129	$items[] = array(
130	'id' => (string) $publicize->get_connection_unique_id( $connection ),
131	'service_name' => $service_name,
132	'display_name' => $publicize->get_display_name( $service_name, $connection ),
133	'profile_display_name' => ! empty( $connection_meta['profile_display_name'] ) ? $connection_meta['profile_display_name'] : '',
134	'profile_picture' => ! empty( $connection_meta['profile_picture'] ) ? $connection_meta['profile_picture'] : '',
135	// phpcs:ignore Universal.Operators.StrictComparisons.LooseEqual -- We expect an integer, but do loose comparison below in case some other type is stored.
136	'global' => 0 == $connection_data['user_id'],
137	);
138	}
139	}
140
141	return $items;
142	}
143
144	/**
145	* Get list of connected Publicize connections.
146	*
147	* @param WP_REST_Request $request Full details about the request.
148	*
149	* @return WP_REST_Response suitable for 1-page collection
150	*/
151	public function get_items( $request ) {
152	$items = array();
153
154	foreach ( $this->get_connections() as $item ) {
155	$items[] = $this->prepare_item_for_response( $item, $request );
156	}
157
158	$response = rest_ensure_response( $items );
159	$response->header( 'X-WP-Total', count( $items ) );
160	$response->header( 'X-WP-TotalPages', 1 );
161
162	return $response;
163	}
164
165	/**
166	* Filters out data based on ?_fields= request parameter
167	*
168	* @param array $connection Array of info about a specific Publicize connection.
169	* @param WP_REST_Request $request Full details about the request.
170	*
171	* @return array filtered $connection
172	*/
173	public function prepare_item_for_response( $connection, $request ) {
174	if ( ! is_callable( array( $this, 'get_fields_for_response' ) ) ) {
175	return $connection;
176	}
177
178	$fields = $this->get_fields_for_response( $request );
179
180	$response_data = array();
181	foreach ( $connection as $field => $value ) {
182	if ( in_array( $field, $fields, true ) ) {
183	$response_data[ $field ] = $value;
184	}
185	}
186
187	return $response_data;
188	}
189
190	/**
191	* Verify that user can access Publicize data
192	*
193	* @return true\|WP_Error
194	*/
195	public function get_items_permission_check() {
196	global $publicize;
197
198	if ( ! $publicize ) {
199	return new WP_Error(
200	'publicize_not_available',
201	__( 'Sorry, Jetpack Social is not available on your site right now.', 'jetpack' ),
202	array( 'status' => rest_authorization_required_code() )
203	);
204	}
205
206	if ( $publicize->current_user_can_access_publicize_data() ) {
207	return true;
208	}
209
210	return new WP_Error(
211	'invalid_user_permission_publicize',
212	__( 'Sorry, you are not allowed to access Jetpack Social data on this site.', 'jetpack' ),
213	array( 'status' => rest_authorization_required_code() )
214	);
215	}
216	}
217	wpcom_rest_api_v2_load_plugin( 'WPCOM_REST_API_V2_Endpoint_List_Publicize_Connections' );
218