Merge branch 'feature/cpt-by-slug'

Author: erwstout

README.md

@@ -112,7 +112,7 @@ Returns the following JSON response:
 - Author & Author ID
 - ACF fields if applicable
 
-### Custom Post Type Post
+### Custom Post Type Post by ID
 **`better-wp-endpoints/v1/{custom_post_type}/{id}`**
 Gets a single custom post type item. Accepts the following parameters:
 
@@ -131,6 +131,25 @@ Returns the following JSON Response:
 - Author & Author ID
 - ACF Fields, if applicable
 
+### Custom Post Type Post by Slug
+**`better-wp-endpoints/v1/{custom_post_type}/{slug}`**
+Gets a single custom post type item. Accepts the following parameters:
+
+- slug
+
+Returns the following JSON Response:
+
+- ID
+- slug
+- title
+- date (ISO 8601)
+- post terms
+- excerpt
+- content
+- all possible thumbnail sizes & URLs
+- Author & Author ID
+- ACF Fields, if applicable
+
 ### Menus
 **`better-wp-endpoints/v1/menus/{menu-slug}`**
 Gets a WordPress Menu by slug. Accepts no parameters.
@@ -141,7 +160,7 @@ Returns the following JSON Response in each item object:
 - menu_order
 - title
 - url
-- slug 
+- slug
 - target
 - description
 - classes (array)

better-wp-endpoints.php

@@ -3,7 +3,7 @@
 Plugin Name:  Better WordPress Endpoints
 Plugin URI:   https://github.com/factor1/better-wp-endpoints/
 Description:  Serves up slimmer WordPress Rest API endpoints, with some great enhancements.
-Version:      0.1.6
+Version:      0.1.7
 Author:       Eric Stout, Factor1 Studios
 Author URI:   https://factor1studios.com/
 License:      GPL3
@@ -95,6 +95,9 @@ private function includes() {
     // get custom post type by id
 		include_once self::$plugin_dir . 'includes/get_cpt_by_id.php';
 
+		// get custom post type by slug
+		include_once self::$plugin_dir . 'includes/get_cpt_by_slug.php';
+
     // get custom post type by id
 		include_once self::$plugin_dir . 'includes/wp_nav_menus.php';
 	}

includes/get_cpt_by_slug.php

@@ -0,0 +1,124 @@
+<?php
+/**
+ * Get Custom Post Type By Slug
+ *
+ * @param array $data Options for the function.
+ * @return object|null Return post object,
 * or null if none.
+ * @since 0.0.1
+ */
+
+function bwe_build_single_cpt_endpoints_slug() {
+  if( bwe_get_cpts() ) {
+
+    // store what custom post types we have
+    $cpt_collection = bwe_get_cpts();
+
+    foreach ($cpt_collection as $key => $cpt) {
+
+      /*
+       *
+       * Register Rest API Endpoint
+       *
+       */
+      register_rest_route( 'better-wp-endpoints/v1', '/'.$cpt.'/(?P<slug>\S+)', array(
+        'methods' => 'GET',
+        'callback' => function ( WP_REST_Request $request ) use ($cpt) {
+
+            // setup parameters
+            $post_slug = $request['slug'];
+
+            // WP_Query Arguments
+            $args = array(
+              'post_type'     => $cpt,
+              'p'             => $post_slug,
+            );
+
+            // The Query
+            $query = new WP_Query( $args );
+
+            if( $query->have_posts() ){
+
+              // setup post object
+              $bwe_cpt_post = new stdClass();
+
+              while( $query->have_posts() ) {
+                $query->the_post();
+
+
+                // get post data
+                $bwe_cpt_post->id = get_the_ID();
+                $bwe_cpt_post->title = get_the_title();
+                $bwe_cpt_post->slug = basename(get_permalink());
+                $bwe_cpt_post->date = get_the_date('c');
+                $bwe_cpt_post->excerpt = get_the_excerpt();
+                $bwe_cpt_post->content = apply_filters('the_content', get_the_content());
+                $bwe_cpt_post->author = esc_html__(get_the_author(), 'text_domain');
+                $bwe_cpt_post->author_id = get_the_author_meta('ID');
+
+                /*
+                 *
+                 * get the terms
+                 *
+                 */
+                if( get_object_taxonomies($cpt) ){
+                  $cpt_taxonomies = get_object_taxonomies($cpt, 'names');
+
+                  $bwe_cpt_post->terms = get_the_terms(get_the_ID(), $cpt_taxonomies);
+
+                } else {
+                  $bwe_cpt_post->terms = array();
+                }
+
+
+                /*
+                 *
+                 * return acf fields if they exist
+                 *
+                 */
+                $bwe_cpt_post->acf = bwe_get_acf();
+
+                /*
+                 *
+                 * get possible thumbnail sizes and urls
+                 *
+                 */
+                $thumbnail_names = get_intermediate_image_sizes();
+                $bwe_thumbnails = new stdClass();
+
+                if( has_post_thumbnail() ){
+                  foreach ($thumbnail_names as $key => $name) {
+                    $bwe_thumbnails->$name = esc_url(get_the_post_thumbnail_url($post->ID, $name));
+                  }
+
+                  $bwe_cpt_post->media = $bwe_thumbnails;
+                } else {
+                  $bwe_cpt_post->media = false;
+                }
+
+              }
+
+              return $bwe_cpt_post;
+            } else {
+              // if no post is found
+              return array();
+            }
+
+            // reset post data
+            wp_reset_postdata();
+
+          }
+      ));
+
+    }
+
+  } else {
+    return array();
+  }
+}
+
+/*
+ *
+ * Add action for cpt endpoint building
+ *
+ */
+add_action( 'rest_api_init', 'bwe_build_single_cpt_endpoints_slug' );

includes/get_pages.php

@@ -125,7 +125,7 @@ function bwe_get_pages( WP_REST_Request $request ) {
        'per_page' => array(
          'description'       => 'Maxiumum number of items to show per page.',
          'type'              => 'integer',
-         'validate_callback' => 'is_numeric',
+         'validate_callback' => function( $v ) { return is_numeric( $v );},
          'sanitize_callback' => 'absint',
        ),
        'page' =>  array(

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "better-wp-endpoints",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Serves up slimmer WordPress Rest API endpoints.",
   "main": "index.js",
   "scripts": {