44 *
55 * @package WPMN
66 * @subpackage REST_API
7- * @since 2.3 .0
7+ * @since 2.4 .0
88 */
99
1010/**
1111 * Core controller used to access networks via the REST API.
1212 *
13- * @since 2.3 .0
13+ * @since 2.4 .0
1414 *
1515 * @see WP_REST_Controller
1616 */
@@ -19,7 +19,7 @@ class WP_MS_REST_Networks_Controller extends WP_REST_Controller {
1919 /**
2020 * Constructor.
2121 *
22- * @since 2.3 .0
22+ * @since 2.4 .0
2323 */
2424 public function __construct () {
2525 $ this ->namespace = 'wpmn/v1 ' ;
@@ -29,7 +29,7 @@ public function __construct() {
2929 /**
3030 * Registers the routes for the objects of the controller.
3131 *
32- * @since 2.3 .0
32+ * @since 2.4 .0
3333 */
3434 public function register_routes () {
3535
@@ -97,7 +97,7 @@ public function register_routes() {
9797 /**
9898 * Checks if a given request has access to read networks.
9999 *
100- * @since 2.3 .0
100+ * @since 2.4 .0
101101 *
102102 * @param WP_REST_Request $request Full details about the request.
103103 *
@@ -110,7 +110,7 @@ public function get_items_permissions_check( $request ) {
110110 /**
111111 * Retrieves a list of network items.
112112 *
113- * @since 2.3 .0
113+ * @since 2.4 .0
114114 *
115115 * @param WP_REST_Request $request Full details about the request.
116116 *
@@ -172,7 +172,7 @@ public function get_items( $request ) {
172172 /**
173173 * Filters arguments, before passing to WP_Network_Query, when querying networks via the REST API.
174174 *
175- * @since 2.3 .0
175+ * @since 2.4 .0
176176 *
177177 * @link https://developer.wordpress.org/reference/classes/wp_network_query/
178178 *
@@ -237,7 +237,7 @@ public function get_items( $request ) {
237237 /**
238238 * Get the network, if the ID is valid.
239239 *
240- * @since 2.3 .0
240+ * @since 2.4 .0
241241 *
242242 * @param int $id Supplied ID.
243243 *
@@ -265,7 +265,7 @@ protected function get_network( $id ) {
265265 /**
266266 * Checks if a given request has access to read the network.
267267 *
268- * @since 2.3 .0
268+ * @since 2.4 .0
269269 *
270270 * @param WP_REST_Request $request Full details about the request.
271271 *
@@ -283,7 +283,7 @@ public function get_item_permissions_check( $request ) {
283283 /**
284284 * Retrieves a network.
285285 *
286- * @since 2.3 .0
286+ * @since 2.4 .0
287287 *
288288 * @param WP_REST_Request $request Full details about the request.
289289 *
@@ -304,7 +304,7 @@ public function get_item( $request ) {
304304 /**
305305 * Checks if a given request has access to create a network.
306306 *
307- * @since 2.3 .0
307+ * @since 2.4 .0
308308 *
309309 * @param WP_REST_Request $request Full details about the request.
310310 *
@@ -317,7 +317,7 @@ public function create_item_permissions_check( $request ) {
317317 /**
318318 * Creates a network.
319319 *
320- * @since 2.3 .0
320+ * @since 2.4 .0
321321 *
322322 * @param WP_REST_Request $request Full details about the request.
323323 *
@@ -344,7 +344,7 @@ public function create_item( $request ) {
344344 * Returning a WP_Error value from the filter will shortcircuit insertion and allow
345345 * skipping further processing.
346346 *
347- * @since 2.3 .0
347+ * @since 2.4 .0
348348 *
349349 * @param array|WP_Error $prepared_network The prepared network data for insert_network().
350350 * @param WP_REST_Request $request Request used to insert the network.
@@ -371,7 +371,7 @@ public function create_item( $request ) {
371371 /**
372372 * Fires after a network is created or updated via the REST API.
373373 *
374- * @since 2.3 .0
374+ * @since 2.4 .0
375375 *
376376 * @param WP_Network $network Inserted or updated network object.
377377 * @param WP_REST_Request $request Request object.
@@ -402,7 +402,7 @@ public function create_item( $request ) {
402402 /**
403403 * Checks if a given REST request has access to update a network.
404404 *
405- * @since 2.3 .0
405+ * @since 2.4 .0
406406 *
407407 * @param WP_REST_Request $request Full details about the request.
408408 *
@@ -428,7 +428,7 @@ public function update_item_permissions_check( $request ) {
428428 /**
429429 * Updates a network.
430430 *
431- * @since 2.3 .0
431+ * @since 2.4 .0
432432 *
433433 * @param WP_REST_Request $request Full details about the request.
434434 *
@@ -490,7 +490,7 @@ public function update_item( $request ) {
490490 /**
491491 * Checks if a given request has access to delete a network.
492492 *
493- * @since 2.3 .0
493+ * @since 2.4 .0
494494 *
495495 * @param WP_REST_Request $request Full details about the request.
496496 *
@@ -508,7 +508,7 @@ public function delete_item_permissions_check( $request ) {
508508 /**
509509 * Deletes a network.
510510 *
511- * @since 2.3 .0
511+ * @since 2.4 .0
512512 *
513513 * @param WP_REST_Request $request Full details about the request.
514514 *
@@ -547,7 +547,7 @@ public function delete_item( $request ) {
547547 /**
548548 * Fires after a network is deleted via the REST API.
549549 *
550- * @since 2.3 .0
550+ * @since 2.4 .0
551551 *
552552 * @param WP_Network $network The deleted network data.
553553 * @param WP_REST_Response $response The response returned from the API.
@@ -561,7 +561,7 @@ public function delete_item( $request ) {
561561 /**
562562 * Prepares a single network output for response.
563563 *
564- * @since 2.3 .0
564+ * @since 2.4 .0
565565 *
566566 * @param WP_Network $network Network object.
567567 * @param WP_REST_Request $request Request object.
@@ -592,7 +592,7 @@ public function prepare_item_for_response( $network, $request ) {
592592 *
593593 * Allows modification of the network right before it is returned.
594594 *
595- * @since 2.3 .0
595+ * @since 2.4 .0
596596 *
597597 * @param WP_REST_Response $response The response object.
598598 * @param WP_Network $network The original network object.
@@ -604,7 +604,7 @@ public function prepare_item_for_response( $network, $request ) {
604604 /**
605605 * Prepares links for the request.
606606 *
607- * @since 2.3 .0
607+ * @since 2.4 .0
608608 *
609609 * @param WP_Network $network Network object.
610610 *
@@ -626,7 +626,7 @@ protected function prepare_links( $network ) {
626626 /**
627627 * Helper function to normalisze query params.
628628 *
629- * @since 2.3 .0
629+ * @since 2.4 .0
630630 *
631631 * @param string $query_param Query parameter.
632632 *
@@ -648,7 +648,7 @@ protected function normalize_query_param( $query_param ) {
648648 /**
649649 * Prepares a single network to be inserted into the database.
650650 *
651- * @since 2.3 .0
651+ * @since 2.4 .0
652652 *
653653 * @param WP_REST_Request $request Request object.
654654 *
@@ -674,7 +674,7 @@ protected function prepare_item_for_database( $request ) {
674674 *
675675 * Allows modification of the network right after it is prepared for the database.
676676 *
677- * @since 2.3 .0
677+ * @since 2.4 .0
678678 *
679679 * @param array $prepared_network The prepared network data for `insert_network`.
680680 * @param WP_REST_Request $request The current request.
@@ -685,7 +685,7 @@ protected function prepare_item_for_database( $request ) {
685685 /**
686686 * Retrieves the network's schema, conforming to JSON Schema.
687687 *
688- * @since 2.3 .0
688+ * @since 2.4 .0
689689 *
690690 * @return array
691691 */
@@ -733,7 +733,7 @@ public function get_item_schema() {
733733 /**
734734 * Retrieves the query params for collections.
735735 *
736- * @since 2.3 .0
736+ * @since 2.4 .0
737737 *
738738 * @return array Networks collection parameters.
739739 */
@@ -828,7 +828,7 @@ public function get_collection_params() {
828828 * collection parameter to an internal WP_Network_Query parameter. Use the
829829 * `rest_network_query` filter to set WP_Network_Query parameters.
830830 *
831- * @since 2.3 .0
831+ * @since 2.4 .0
832832 *
833833 * @param array $query_params JSON Schema-formatted collection parameters.
834834 */
@@ -839,7 +839,7 @@ public function get_collection_params() {
839839 /**
840840 * Checks if the network can be read.
841841 *
842- * @since 2.3 .0
842+ * @since 2.4 .0
843843 *
844844 * @param WP_Network $network Network object.
845845 * @param WP_REST_Request $request Request data to check.
@@ -857,7 +857,7 @@ protected function check_read_permission( $network, $request ) {
857857 /**
858858 * Checks if a network can be edited or deleted.
859859 *
860- * @since 2.3 .0
860+ * @since 2.4 .0
861861 *
862862 * @param object $network Network object.
863863 *
0 commit comments