- Fix issues with the blog APIs

Author: vicky-ftxinfotech

app/Http/Controllers/Api/V1/BlogsController.php

@@ -2,21 +2,21 @@
 
 namespace App\Http\Controllers\Api\V1;
 
+use App\Models\Blog;
+use Illuminate\Http\Response;
+use App\Http\Resources\BlogsResource;
+use App\Repositories\Backend\BlogsRepository;
+use App\Http\Requests\Backend\Blogs\StoreBlogsRequest;
 use App\Http\Requests\Backend\Blogs\DeleteBlogsRequest;
 use App\Http\Requests\Backend\Blogs\ManageBlogsRequest;
-use App\Http\Requests\Backend\Blogs\StoreBlogsRequest;
 use App\Http\Requests\Backend\Blogs\UpdateBlogsRequest;
-use App\Http\Resources\BlogsResource;
-use App\Models\Blog;
-use App\Repositories\Backend\BlogsRepository;
-use Illuminate\Http\Response;
 
 /**
  * @group Blog Management
  *
  * Class BlogsController
  *
- * API's for Blog Management
+ * APIs for Blog Management
  *
  * @authenticated
  */
@@ -45,9 +45,10 @@ public function __construct(BlogsRepository $repository)
      * This endpoint provides a paginated list of all blogs. You can customize how many records you want in each
      * returned response as well as sort records based on a key in specific order.
      *
-     * @queryParam paginate Which page to show. Example :12
-     * @queryParam orderBy Order by ascending or descending. Example :ASC or DESC
-     * @queryParam sortBy Sort by any database column. Example :created_at
+     * @queryParam page Which page to show. Example: 12
+     * @queryParam per_page Number of records per page. (use -1 to retrieve all) Example: 20
+     * @queryParam order_by Order by database column. Example: created_at
+     * @queryParam order Order direction ascending (asc) or descending (desc). Example: asc
      *
      * @responseFile status=401 scenario="api_key not provided" responses/unauthenticated.json
      * @responseFile responses/blog/blog-list.json
@@ -66,10 +67,10 @@ public function index(ManageBlogsRequest $request)
     /**
      * Gives a specific Blog.
      *
-     * This endpoint provides you a single Blog.
+     * This endpoint provides you a single Blog
      * The Blog is identified based on the ID provided as url parameter.
      *
-     * @urlParam id required The ID of the Blog.
+     * @urlParam id required The ID of the Blog
      *
      * @responseFile status=401 scenario="api_key not provided" responses/unauthenticated.json
      * @responseFile responses/blog/blog-show.json
@@ -108,7 +109,7 @@ public function store(StoreBlogsRequest $request)
      * This endpoint allows you to update existing Blog with new data.
      * The Blog to be updated is identified based on the ID provided as url parameter.
      *
-     * @urlParam id required The ID of the Blog.
+     * @urlParam id required The ID of the Blog
      *
      * @responseFile status=401 scenario="api_key not provided" responses/unauthenticated.json
      * @responseFile responses/blog/blog-update.json
@@ -126,13 +127,13 @@ public function update(UpdateBlogsRequest $request, Blog $blog)
     /**
      * Delete Blog.
      *
-     * This endpoint allows you to delete a Blog.
+     * This endpoint allows you to delete a Blog
      * The Blog to be deleted is identified based on the ID provided as url parameter.
      *
-     * @urlParam id required The ID of the Blog.
+     * @urlParam id required The ID of the Blog
      *
      * @responseFile status=401 scenario="api_key not provided" responses/unauthenticated.json
-     * @responseFile responses/blog/blog-destroy.json
+     * @responseFile status=204 scenario="When the record is deleted" responses/blog/blog-destroy.json
      *
      * @param DeleteBlogsRequest $request
      * @param \App\Models\Blog $blog

app/Http/Controllers/Backend/Blogs/BlogsController.php

@@ -2,18 +2,18 @@
 
 namespace App\Http\Controllers\Backend\Blogs;
 
-use App\Http\Controllers\Controller;
-use App\Http\Requests\Backend\Blogs\ManageBlogsRequest;
-use App\Http\Requests\Backend\Blogs\StoreBlogsRequest;
-use App\Http\Requests\Backend\Blogs\UpdateBlogsRequest;
-use App\Http\Responses\Backend\Blog\EditResponse;
-use App\Http\Responses\RedirectResponse;
-use App\Http\Responses\ViewResponse;
 use App\Models\Blog;
-use App\Models\BlogCategory;
 use App\Models\BlogTag;
-use App\Repositories\Backend\BlogsRepository;
+use App\Models\BlogCategory;
+use App\Http\Controllers\Controller;
+use App\Http\Responses\ViewResponse;
 use Illuminate\Support\Facades\View;
+use App\Http\Responses\RedirectResponse;
+use App\Repositories\Backend\BlogsRepository;
+use App\Http\Responses\Backend\Blog\EditResponse;
+use App\Http\Requests\Backend\Blogs\StoreBlogsRequest;
+use App\Http\Requests\Backend\Blogs\ManageBlogsRequest;
+use App\Http\Requests\Backend\Blogs\UpdateBlogsRequest;
 
 class BlogsController extends Controller
 {

app/Http/Controllers/Backend/Blogs/BlogsTableController.php

@@ -3,9 +3,9 @@
 namespace App\Http\Controllers\Backend\Blogs;
 
 use App\Http\Controllers\Controller;
-use App\Http\Requests\Backend\Blogs\ManageBlogsRequest;
-use App\Repositories\Backend\BlogsRepository;
 use Yajra\DataTables\Facades\DataTables;
+use App\Repositories\Backend\BlogsRepository;
+use App\Http\Requests\Backend\Blogs\ManageBlogsRequest;
 
 /**
  * Class BlogsTableController.

app/Http/Requests/Backend/Blogs/UpdateBlogsRequest.php

@@ -27,7 +27,7 @@ public function authorize()
     public function rules()
     {
         return [
-            'name' => ['required', 'max:191', 'unique:blogs,name,'.$this->route('blog')->id],
+            'name' => ['required', 'max:191', 'unique:blogs,name,'.optional($this->route('blog'))->id],
             'publish_datetime' => ['required', 'date'],
             'content' => ['required', 'string'],
             'categories' => ['required', 'array'],

app/Models/Blog.php

@@ -2,10 +2,10 @@
 
 namespace App\Models;
 
-use App\Models\Traits\Attributes\BlogAttributes;
 use App\Models\Traits\ModelAttributes;
-use App\Models\Traits\Relationships\BlogRelationships;
 use Illuminate\Database\Eloquent\SoftDeletes;
+use App\Models\Traits\Attributes\BlogAttributes;
+use App\Models\Traits\Relationships\BlogRelationships;
 
 class Blog extends BaseModel
 {

app/Models/Traits/Relationships/BlogRelationships.php

@@ -2,9 +2,9 @@
 
 namespace App\Models\Traits\Relationships;
 
+use App\Models\BlogTag;
 use App\Models\Auth\User;
 use App\Models\BlogCategory;
-use App\Models\BlogTag;
 
 trait BlogRelationships
 {

app/Repositories/Backend/BlogsRepository.php

@@ -2,20 +2,20 @@
 
 namespace App\Repositories\Backend;
 
-use App\Events\Backend\Blogs\BlogCreated;
-use App\Events\Backend\Blogs\BlogDeleted;
-use App\Events\Backend\Blogs\BlogUpdated;
-use App\Exceptions\GeneralException;
+use DB;
+use Carbon\Carbon;
 use App\Models\Blog;
+use App\Models\BlogTag;
+use App\Models\BlogMapTag;
+use Illuminate\Support\Str;
 use App\Models\BlogCategory;
 use App\Models\BlogMapCategory;
-use App\Models\BlogMapTag;
-use App\Models\BlogTag;
+use App\Exceptions\GeneralException;
 use App\Repositories\BaseRepository;
-use Carbon\Carbon;
-use DB;
 use Illuminate\Support\Facades\Storage;
-use Illuminate\Support\Str;
+use App\Events\Backend\Blogs\BlogCreated;
+use App\Events\Backend\Blogs\BlogDeleted;
+use App\Events\Backend\Blogs\BlogUpdated;
 
 class BlogsRepository extends BaseRepository
 {

database/factories/BlogFactory.php

@@ -2,8 +2,8 @@
 
 /** @var \Illuminate\Database\Eloquent\Factory $factory */
 
-use App\Models\Auth\User;
 use App\Models\Blog;
+use App\Models\Auth\User;
 use Faker\Generator as Faker;
 
 $factory->define(Blog::class, function (Faker $faker) {

database/migrations/2017_11_02_060149_create_blog_categories_table.php

@@ -1,7 +1,7 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 class CreateBlogCategoriesTable extends Migration
 {

database/migrations/2017_11_02_060149_create_blog_map_categories_table.php

@@ -1,7 +1,7 @@
 <?php
 
-use Illuminate\Database\Migrations\Migration;
 use Illuminate\Database\Schema\Blueprint;
+use Illuminate\Database\Migrations\Migration;
 
 class CreateBlogMapCategoriesTable extends Migration
 {