docs: add how to properly upgrade for $permission_denied&$group_denied

Author: datamweb

UPGRADING.md

@@ -25,6 +25,28 @@ following steps will be done.
     $this->helpers = array_merge($this->helpers, ['setting']);
     ```
 
+#### Config\Auth
+
+The following items have been added. Copy the properties in **src/Config/Auth.php**.
+
+- `$permission_denied` and `$group_denied` are added to `Config\Auth::$redirects`.
+- `permissionDeniedRedirect()` and `groupDeniedRedirect()` are added.
+
+#### Fix Custom Filter If extends `AbstractAuthFilter`
+If you have written a custom filter that extends `AbstractAuthFilter`. Now you need to add and implement method `redirectToDeniedUrl()` to your custom filter.
+The following example is related to the above explanation for **group** filter.
+```php
+/**
+ * If there is no necessary access to the group,
+ * it will redirect the user to the set URL with an error message.
+ */
+protected function redirectToDeniedUrl(): RedirectResponse
+{
+    return redirect()->to(config('Auth')->groupDeniedRedirect())
+        ->with('error', lang('Auth.notEnoughPrivilege'));
+} 
+```
+
 ## Version 1.0.0-beta.6 to 1.0.0-beta.7
 
 ### The minimum CodeIgniter version

src/Filters/GroupFilter.php

@@ -5,7 +5,6 @@
 namespace CodeIgniter\Shield\Filters;
 
 use CodeIgniter\HTTP\RedirectResponse;
-use CodeIgniter\Shield\Config\Auth;
 
 /**
  * Group Authorization Filter.
@@ -27,7 +26,7 @@ protected function isAuthorized(array $arguments): bool
      */
     protected function redirectToDeniedUrl(): RedirectResponse
     {
-        return redirect()->to(config(Auth::class)->groupDeniedRedirect())
+        return redirect()->to(config('Auth')->groupDeniedRedirect())
             ->with('error', lang('Auth.notEnoughPrivilege'));
     }
 }

src/Filters/PermissionFilter.php

@@ -5,7 +5,6 @@
 namespace CodeIgniter\Shield\Filters;
 
 use CodeIgniter\HTTP\RedirectResponse;
-use CodeIgniter\Shield\Config\Auth;
 
 /**
  * Permission Authorization Filter.
@@ -33,7 +32,7 @@ protected function isAuthorized(array $arguments): bool
      */
     protected function redirectToDeniedUrl(): RedirectResponse
     {
-        return redirect()->to(config(Auth::class)->permissionDeniedRedirect())
+        return redirect()->to(config('Auth')->permissionDeniedRedirect())
             ->with('error', lang('Auth.notEnoughPrivilege'));
     }
 }

tests/Authentication/Filters/GroupFilterTest.php

@@ -4,7 +4,6 @@
 
 namespace Tests\Authentication\Filters;
 
-use CodeIgniter\Shield\Config\Auth;
 use CodeIgniter\Shield\Entities\User;
 use CodeIgniter\Shield\Filters\GroupFilter;
 use CodeIgniter\Shield\Models\UserModel;
@@ -70,7 +69,7 @@ public function testFilterIncorrectGroupNoPrevious(): void
             ->get('protected-route');
 
         // Should redirect to home page since previous_url is not set
-        $result->assertRedirectTo(config(Auth::class)->groupDeniedRedirect());
+        $result->assertRedirectTo(config('Auth')->groupDeniedRedirect());
         // Should have error message
         $result->assertSessionHas('error', lang('Auth.notEnoughPrivilege'));
     }

tests/Authentication/Filters/PermissionFilterTest.php

@@ -4,7 +4,6 @@
 
 namespace Tests\Authentication\Filters;
 
-use CodeIgniter\Shield\Config\Auth;
 use CodeIgniter\Shield\Entities\User;
 use CodeIgniter\Shield\Filters\PermissionFilter;
 use CodeIgniter\Shield\Models\UserModel;
@@ -70,7 +69,7 @@ public function testFilterIncorrectGroupNoPrevious(): void
             ->get('protected-route');
 
         // Should redirect to home page since previous_url is not set
-        $result->assertRedirectTo(config(Auth::class)->permissionDeniedRedirect());
+        $result->assertRedirectTo(config('Auth')->permissionDeniedRedirect());
         // Should have error message
         $result->assertSessionHas('error', lang('Auth.notEnoughPrivilege'));
     }