wip: initial commit

Author: thomasnavarro

.editorconfig

@@ -0,0 +1,22 @@
+# For more information about the properties used in
+# this file, please see the EditorConfig documentation:
+# http://editorconfig.org/
+
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+indent_size = 4
+indent_style = space
+
+[*.{php,js,html,css,scss,xml,phtml,twig,json}]
+indent_size = 4
+
+[*.md]
+trim_trailing_whitespace = false
+
+[*.bat]
+end_of_line = crlf

README.md

@@ -0,0 +1,13 @@
+# Ici On Drive - Multisite API
+
+Create endpoint to the WordPress REST API for multisite. Plugin developed for the "Ici On Drive" platform.
+
+## Requirements
+
+This plugin requires [API Rest enabled](https://developer.wordpress.org/rest-api/), [Multisite WordPress enabled](https://codex.wordpress.org/fr:Cr%C3%A9er_un_r%C3%A9seau)
+
+## Included
+
+-   Create endpoint: get all sites `http://example.com/wp-json/sites`
+-   Create endpoint: get site by blog_id `http://example.com/wp-json/sites/<id>`
+-   Added some filters to customize the data of your request.

class-multisite-api.php

@@ -0,0 +1,95 @@
+<?php
+/**
+ * Plugin Name: Ici On Drive - Multisite API
+ * Description: Create endpoint to the WordPress REST API for multisite. Plugin developed for the "Ici On Drive" platform.
+ * Plugin URI: https://github.com/iciondrive/multisite-api
+ * Author: Thomas Navarro
+ * Version: 1.0.0
+ * Network: true
+ * License: GPL v2 or later
+ * License URI: https://www.gnu.org/licenses/gpl-2.0.html
+ * Author URI: http://github.com/thomasnavarro.
+ */
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+if (!class_exists('IOD_Multisite_API')) {
+    class IOD_Multisite_API
+    {
+        /**
+         * @var string namespace
+         */
+        private const NAMESPACE = 'iciondrive/v1';
+
+        /**
+         * @var string rest_base
+         */
+        private $rest_base = 'sites';
+
+        public function __construct()
+        {
+            // WP hooks
+            add_action('init', [$this, 'init_hook']);
+
+            $this->get_sites = new IOD_Multisite_API_Get_Sites();
+            $this->get_site = new IOD_Multisite_API_Get_Site();
+        }
+
+        public function init_hook()
+        {
+            add_action('rest_api_init', [$this, 'register_rest_route']);
+        }
+
+        public function register_rest_route()
+        {
+            // Get all sites
+            register_rest_route(
+                self::NAMESPACE, '/sites',
+                [
+                    'methods' => WP_REST_Server::READABLE,
+                    'callback' => [$this->get_sites, 'callback'],
+                    // 'permission_callback' => [$this, 'get_item_permissions_check'],
+                    'args' => [],
+                ]);
+
+            // Get site by blog ID
+            register_rest_route(
+                self::NAMESPACE, '/'.$this->rest_base.'/(?P<id>[\d]+)',
+                [
+                    'args' => [
+                        'id' => [
+                            'description' => __('Unique identifier for the object.'),
+                            'type' => 'integer',
+                        ],
+                    ],
+                    [
+                        'methods' => WP_REST_Server::READABLE,
+                        'callback' => [$this->get_site, 'callback'],
+                        // 'permission_callback' => [$this, 'get_item_permissions_check'],
+                        'args' => [],
+                    ],
+                    'schema' => [$this, 'get_public_item_schema'],
+                ]
+            );
+        }
+
+        private function get_item_permissions_check()
+        {
+            global $wp_version;
+
+            if (version_compare($wp_version, '4.8', '>=')) {
+                return current_user_can('setup_network');
+            }
+
+            return is_super_admin();
+        }
+    }
+
+    // Includes
+    require_once dirname(__FILE__).'/class-multisite-get-sites.php';
+    require_once dirname(__FILE__).'/class-multisite-get-site.php';
+
+    // Instantiate
+    new IOD_Multisite_API();
+}

class-multisite-get-site.php

@@ -0,0 +1,43 @@
+<?php
+
+class IOD_Multisite_API_Get_Site extends WP_REST_Controller
+{
+    /**
+     * Get a collection of items.
+     *
+     * @param WP_REST_Request $request full data about the request
+     *
+     * @return WP_Error|WP_REST_Response
+     */
+    public function callback($request)
+    {
+        $site = apply_filters('multisite_api/get_site', $this->get_site($request['id']));
+
+        if (is_wp_error($site)) {
+            return $site;
+        }
+
+        return $site;
+    }
+
+    protected function get_site($id)
+    {
+        $error = new WP_Error(
+            'rest_site_invalid_id',
+            __('Invalid site ID.'),
+            ['status' => 404]
+        );
+
+        if ((int) $id <= 0) {
+            return $error;
+        }
+
+        $site = get_site((int) $id);
+
+        if (empty($site) || empty($site->blog_id)) {
+            return $error;
+        }
+
+        return $site;
+    }
+}

class-multisite-get-sites.php

@@ -0,0 +1,28 @@
+<?php
+
+class IOD_Multisite_API_Get_Sites extends WP_REST_Controller
+{
+    /**
+     * Get a collection of items.
+     *
+     * @param WP_REST_Request $request full data about the request
+     *
+     * @return WP_Error|WP_REST_Response
+     */
+    public function callback($request)
+    {
+        $args = [
+            'public' => 1,
+            'archived' => 0,
+            'mature' => 0,
+            'spam' => 0,
+            'deleted' => 0,
+            'site__not_in' => [1],
+        ];
+
+        $args = apply_filters('multisite_api/get_sites/args', $args);
+        $sites = apply_filters('multisite_api/get_sites', get_sites($args));
+
+        return rest_ensure_response($sites);
+    }
+}

composer.json

@@ -0,0 +1,14 @@
+{
+    "name": "iciondrive/multisite-api",
+    "description": "Create endpoint to the WordPress REST API for multisite. Plugin developed for the \"Ici On Drive\" platform.",
+    "type": "wordpress-plugin",
+    "version": "1.0.0",
+    "license": "GPLv2 or later",
+    "authors": [
+        {
+            "name": "Thomas Navarro",
+            "email": "[email protected]"
+        }
+    ],
+    "require": {}
+}