feature: add abstract class and make permissions more dynamic based o…

…n cap and role

src/Framework/Permissions/Contracts/UserPermissionsInterface.php

@@ -0,0 +1,19 @@
+<?php
+
+namespace Give\Framework\Permissions\Contracts;
+
+/**
+ * @unreleased
+ */
+interface UserPermissionsInterface
+{
+     /**
+     * @return string
+     */
+    public static function getType(): string;
+
+    /**
+     * @unreleased
+     */
+    public function can(string $capability): bool;
+}

src/Framework/Permissions/DonationFormPermissions.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace Give\Framework\Permissions;
+/**
+ * @unreleased
+ */
+class DonationFormPermissions extends UserPermission
+{
+    /**
+     * @unreleased
+     */
+    public static function getType(): string
+    {
+        return 'give_form';
+    }
+}

src/Framework/Permissions/DonationPermissions.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Give\Framework\Permissions;
+
+/**
+ * @unreleased
+ */
+class DonationPermissions extends UserPermission
+{
+    /**
+     * @unreleased
+     */
+    public static function getType(): string
+    {
+        return 'give_payment';
+    }
+}

src/Framework/Permissions/DonorPermissions.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace Give\Framework\Permissions;
+
+/**
+ * @unreleased
+ */
+class DonorPermissions extends UserPermission
+{
+    /**
+     * @unreleased
+     */
+    public static function getType(): string
+    {
+        return 'give_payment';
+    }
+}

src/Framework/Permissions/Facades/UserPermissions.php

@@ -2,13 +2,17 @@
 
 namespace Give\Framework\Permissions\Facades;
 
-use Give\Framework\Permissions\DonationFormsPermissions;
+use Give\Framework\Permissions\DonationFormPermissions;
+use Give\Framework\Permissions\DonationPermissions;
+use Give\Framework\Permissions\DonorPermissions;
 use Give\Framework\Support\Facades\Facade;
 
 /**
  * @unreleased
  *
- * @method static DonationFormsPermissions donationForms()
+ * @method static DonationFormPermissions donationForms()
+ * @method static DonationPermissions donations()
+ * @method static DonorPermissions donors()
  */
 class UserPermissions extends Facade
 {

src/Framework/Permissions/Facades/UserPermissionsFacade.php

@@ -2,7 +2,9 @@
 
 namespace Give\Framework\Permissions\Facades;
 
-use Give\Framework\Permissions\DonationFormsPermissions;
+use Give\Framework\Permissions\DonationFormPermissions;
+use Give\Framework\Permissions\DonationPermissions;
+use Give\Framework\Permissions\DonorPermissions;
 
 /**
  * This is a facade for interacting with WP and GiveWP permissions.
@@ -16,8 +18,24 @@ class UserPermissionsFacade
     /**
      * @unreleased
      */
-    public function donationForms(): DonationFormsPermissions
+    public function donationForms(): DonationFormPermissions
     {
-        return new DonationFormsPermissions();
+        return new DonationFormPermissions();
+    }
+
+    /**
+     * @unreleased
+     */
+    public function donations(): DonationPermissions
+    {
+        return new DonationPermissions();
+    }
+
+    /**
+     * @unreleased
+     */
+    public function donors(): DonorPermissions
+    {
+        return new DonorPermissions();
     }
 }

src/Framework/Permissions/UserPermission.php

@@ -0,0 +1,66 @@
+<?php
+namespace Give\Framework\Permissions;
+
+abstract class UserPermission implements Contracts\UserPermissionsInterface
+{
+    /**
+     * @unreleased
+     */
+    public function can(string $capability): bool
+    {
+        switch ($capability) {
+            case 'delete':
+                $capability = $this->getCapability('delete');
+                break;
+            case 'read':
+            case 'view':
+            case 'create':
+            case 'update':
+            case 'edit':
+                $capability = $this->getCapability('edit');
+                break;
+        }
+
+        return current_user_can($capability);
+    }
+
+    /**
+     * @unreleased
+     */
+    protected function getCapability( string $cap): string
+    {
+        $caps = $this->getCapabilities($this::getType());
+
+        return $caps[$cap];
+    }
+
+    /**
+     * @unreleased
+     */
+    protected function getCapabilities(string $type): array
+    {
+        return [
+            // Post type.
+            "edit" => "edit_{$type}s",
+            "edit_others" => "edit_others_{$type}s",
+            "publish" => "publish_{$type}s",
+            "read_private" => "read_private_{$type}s",
+            "delete" => "delete_{$type}s",
+            "delete_private" => "delete_private_{$type}s",
+            "delete_published" => "delete_published_{$type}s",
+            "delete_others" => "delete_others_{$type}s",
+            "edit_private" => "edit_private_{$type}s",
+            "edit_published" => "edit_published_{$type}s",
+
+            // Terms / taxonomies.
+            "manage_terms" => "manage_{$type}_terms",
+            "edit_terms" => "edit_{$type}_terms",
+            "delete_terms" => "delete_{$type}_terms",
+            "assign_terms" => "assign_{$type}_terms",
+
+            // Custom capabilities.
+            "view_stats" => "view_{$type}_stats",
+            "import" => "import_{$type}s"
+        ];
+    }
+}

tests/Unit/Framework/Permissions/Facades/TestUserPermissions.php

@@ -2,7 +2,7 @@
 
 namespace Give\Tests\Unit\Framework\Permissions\Facades;
 
-use Give\Framework\Permissions\DonationFormsPermissions;
+use Give\Framework\Permissions\DonationFormPermissions;
 use Give\Framework\Permissions\Facades\UserPermissions;
 use Give\Tests\TestCase;
 use Give\Tests\TestTraits\RefreshDatabase;
@@ -20,7 +20,7 @@ final class TestUserPermissions extends TestCase
     public function testDonationForms(): void
     {
         $this->assertInstanceOf(
-            DonationFormsPermissions::class,
+            DonationFormPermissions::class,
             UserPermissions::donationForms()
         );
     }