Merge branch 'release/2.2.0'

CHANGELOG.md

@@ -3,6 +3,17 @@
 All notable changes to this project will be documented in this file. This project adheres to
 [Semantic Versioning](http://semver.org/) and [this changelog format](http://keepachangelog.com/).
 
+## [2.2.0] - 2022-04-10
+
+### Added
+
+- [#181](https://github.com/laravel-json-api/laravel/issues/181) The `JsonApiController` now extends the base Laravel
+  controller.
+
+### Fixed
+
+- [#180](https://github.com/laravel-json-api/laravel/pull/180) Add missing method to the Authorizer stub.
+
 ## [2.1.2] - 2022-04-04
 
 ### Fixed

README.md

@@ -5,10 +5,15 @@
 Implement feature-rich [JSON:API](https://jsonapi.org) compliant APIs in your
 [Laravel](https://laravel.com) applications. Build your next standards-compliant API today.
 
-### Why use JSON:API?
+## Why use JSON:API and Laravel JSON:API?
+
+Great question! [Here's some reasons from this excellent article by Denisa Halmaghi](https://graffino.com/web-development/how-to-use-laravel-json-api-to-create-a-json-api-compliant-backend-in-laravel):
+
+### Why Use JSON:API?
 
 - Standardised, consistent APIs.
-- Feature rich - some of which are filtering, pagination, eager loading and sparse fieldsets.
+- Feature rich - some of which are: sparse fieldsets (only fetch the fields you need), filtering, sorting, pagination,
+  eager loading for relationships (includes, which solve the _N+1_ problem).
 - Easy to understand.
 
 ### Why use Laravel JSON:API?

src/Http/Controllers/JsonApiController.php

@@ -22,10 +22,10 @@
 use Illuminate\Foundation\Auth\Access\AuthorizesRequests;
 use Illuminate\Foundation\Bus\DispatchesJobs;
 use Illuminate\Foundation\Validation\ValidatesRequests;
+use Illuminate\Routing\Controller;
 
-class JsonApiController
+class JsonApiController extends Controller
 {
-
     /**
      * JSON:API Actions
      */
@@ -46,5 +46,4 @@ class JsonApiController
     use AuthorizesRequests;
     use DispatchesJobs;
     use ValidatesRequests;
-
 }

stubs/authorizer.stub

@@ -69,7 +69,20 @@ class {{ class }} implements Authorizer
     }
 
     /**
-     * Authorize the show-related and show-relationship controller action.
+     * Authorize the show-related controller action
+     *
+     * @param Request $request
+     * @param object $model
+     * @param string $fieldName
+     * @return bool
+     */
+    public function showRelated(Request $request, object $model, string $fieldName): bool
+    {
+        // TODO: Implement showRelated() method.
+    }
+
+    /**
+     * Authorize the show-relationship controller action.
      *
      * @param Request $request
      * @param object $model