REST API Support

co-authors-plus.php

@@ -31,6 +31,8 @@
 
 require_once( dirname( __FILE__ ) . '/php/class-coauthors-template-filters.php' );
 
+require_once( dirname( __FILE__ ) . '/php/api/boot.php' );
+
 if ( defined( 'WP_CLI' ) && WP_CLI ) {
 	require_once( dirname( __FILE__ ) . '/php/class-wp-cli.php' );
 }
@@ -114,7 +116,6 @@ function __construct() {
 
 		// Support infinite scroll for Guest Authors on author pages
 		add_filter( 'infinite_scroll_js_settings', array( $this, 'filter_infinite_scroll_js_settings' ), 10, 2 );
-
 	}
 
 	function coauthors_plus() {
@@ -126,6 +127,7 @@ function coauthors_plus() {
 	 * and the custom post type to store our author data
 	 */
 	public function action_init() {
+        global $wp_version;
 
 		// Allow Co-Authors Plus to be easily translated
 		load_plugin_textdomain( 'co-authors-plus', null, dirname( plugin_basename( __FILE__ ) ) . '/languages/' );
@@ -947,24 +949,27 @@ function filter_count_user_posts( $count, $user_id ) {
 	/**
 	 * Checks to see if the current user can set authors or not
 	 */
-	function current_user_can_set_authors( $post = null ) {
+	function current_user_can_set_authors( $post = null, $is_api_request = false ) {
 		global $typenow;
 
 		if ( ! $post ) {
 			$post = get_post();
-			if ( ! $post ) {
+			if ( ! $post && ! $is_api_request) {
 				return false;
 			}
 		}
 
-		$post_type = $post->post_type;
+		if ( $post ) {
+			$post_type = $post->post_type;
 
-		// TODO: need to fix this; shouldn't just say no if don't have post_type
-		if ( ! $post_type ) {
-			return false;
+			// TODO: need to fix this; shouldn't just say no if don't have post_type
+			if ( ! $post_type ) {
+				return false;
+			}
+
+			$post_type_object = get_post_type_object( $post_type );
 		}
 
-		$post_type_object = get_post_type_object( $post_type );
 		$current_user = wp_get_current_user();
 		if ( ! $current_user ) {
 			return false;
@@ -1463,6 +1468,7 @@ public function filter_jetpack_open_graph_tags( $og_tags, $image_dimensions ) {
 		// Send back the updated Open Graph Tags
 		return apply_filters( 'coauthors_open_graph_tags', $og_tags );
 	}
+
 }
 
 global $coauthors_plus;

php/api/boot.php

@@ -0,0 +1,27 @@
+<?php
+
+/**
+ * CoAuthors Plus REST API Boot file.
+ * It loads all the required classes need by it.
+ */
+global $wp_version;
+
+if ( version_compare( $wp_version, '4.4', '<' ) ) {
+    return;
+}
+
+require_once( dirname( __FILE__ ) . '/class-coauthors-api.php' );
+require_once( dirname( __FILE__ ) . '/class-coauthors-api-controller.php' );
+require_once( dirname( __FILE__ ) . '/class-coauthors-api-search.php' );
+require_once( dirname( __FILE__ ) . '/class-coauthors-api-post.php' );
+require_once( dirname( __FILE__ ) . '/class-coauthors-api-guest.php' );
+
+define('COAUTHORS_PLUS_API_NAMESPACE', 'coauthors/');
+define('COAUTHORS_PLUS_API_VERSION', 'v1');
+
+$coauthors_api = new CoAuthors_API();
+$coauthors_api->register_controller( new CoAuthors_API_Search() );
+$coauthors_api->register_controller( new CoAuthors_API_Post() );
+$coauthors_api->register_controller( new CoAuthors_API_Guest() );
+
+add_action( 'rest_api_init', array( $coauthors_api, 'boot' ) );

php/api/class-coauthors-api-controller.php

@@ -0,0 +1,156 @@
+<?php
+
+/**
+ * The base class for all API Controllers.
+ *
+ * Class CoAuthors_API_Controller
+ */
+class CoAuthors_API_Controller {
+
+    /**
+     * @var string
+     */
+    protected $route = null;
+
+    /**
+     * Use this method to define the routes using WP register_rest_route() function.
+     *
+     * @throws Exception
+     * @return array
+     */
+    public function create_routes() {
+        throw new Exception( 'Child class needs to implement this method.' );
+    }
+
+    /**
+     * Handles route authorization if requested.
+     *
+     * @param WP_REST_Request $request
+     * @return bool
+     */
+    public function authorization( WP_REST_Request $request ) {
+        return true;
+    }
+
+    /**
+     * DELETE HTTP method
+     *
+     * @param WP_REST_Request $request
+     * @throws Exception
+     * @return WP_REST_Response
+     */
+    public function get( WP_REST_Request $request ) {
+        throw new Exception( 'Not implemented.' );
+    }
+
+    /**
+     * DELETE HTTP method
+     *
+     * @param WP_REST_Request $request
+     * @throws Exception
+     * @return WP_REST_Response
+     */
+    public function post( WP_REST_Request $request ) {
+        throw new Exception( 'Not implemented.' );
+    }
+
+    /**
+     * DELETE HTTP method
+     *
+     * @param WP_REST_Request $request
+     * @throws Exception
+     * @return WP_REST_Response
+     */
+    public function put( WP_REST_Request $request ) {
+        throw new Exception( 'Not implemented.' );
+    }
+
+    /**
+     * DELETE HTTP method
+     *
+     * @param WP_REST_Request $request
+     * @throws Exception
+     * @return WP_REST_Response
+     */
+    public function delete( WP_REST_Request $request ) {
+        throw new Exception( 'Not implemented.' );
+    }
+
+    /**
+     * Returns a clean array
+     *
+     * @param $param
+     * @param WP_REST_Request $request
+     * @param $key
+     *
+     * @return array
+     */
+    public function sanitize_array($param, WP_REST_Request $request, $key) {
+        return array_map( 'esc_attr', (array) $param );
+    }
+
+    /**
+     * Helper method that returns a filtered array for the search_authors() main class
+     * method.
+     *
+     * @param array $arr
+     *
+     * @return array
+     */
+    protected function filter_authors_array( $arr ) {
+        $coauthors = array();
+
+        if ( ! is_array( $arr ) )
+            return $coauthors;
+
+        foreach ( $arr as $author ) {
+            $coauthors[] = array(
+                'id'            => $author->ID,
+                'user_login'    => $author->user_login,
+                'display_name'  => $author->display_name,
+                'user_email'    => $author->user_email,
+                'user_nicename' => $author->user_nicename
+            );
+        }
+
+        return $coauthors;
+    }
+
+    /**
+     * Returns an array with the register_rest_route args definition.
+     *
+     * @param string $method
+     * @return array
+     */
+    protected function get_args( $method = null ) {
+       return array();
+    }
+
+    /**
+     * Wraps an array into the WP_REST_Response.
+     * Currently very limited, it should allow header and code to be setted.
+     *
+     * @param array $data
+     * @throws Exception
+     * @return WP_REST_Response
+     */
+    protected function send_response( array $data ) {
+        $response = new WP_REST_Response( $data );
+
+        return $response;
+    }
+
+    /**
+     * @return string
+     */
+    protected function get_route() {
+        return $this->route;
+    }
+
+    /**
+     * @return string
+     */
+    protected function get_namespace() {
+        return COAUTHORS_PLUS_API_NAMESPACE . COAUTHORS_PLUS_API_VERSION;
+    }
+}