action canRunWhen

Author: ilvalerione

docs/_sidebar.md

@@ -18,6 +18,7 @@
     - [Predefined Field Types](development/fields/predefined/)
     - [Resolution / Formatting](development/fields/resolution.md)
     - [Validation](development/fields/validation.md)
+    - [Fill Underlying Attribute](development/fields/fill.md)
 * [**Authorization**](development/authorization/)
     - [Policies](development/authorization/policies.md)
     - [Hiding Resource](development/authorization/hiding-resource.md)

docs/development/fields/fill.md

@@ -0,0 +1,14 @@
+# Fill Underlying Attribute
+
+When you create or update a resource every attribute on the model will be filled with given attribute values sent in the request to update the underlying database table.
+
+The `fillUsing` method allows you to customize how a field is filled before it is saved on the database. This method accepts a callback which receives the request, the eloquent model instance and the name of the given attribute:
+
+```php
+use Carisma\Fields\Field;
+
+Field::make('name')->fillUsing(function($request, $model, $attribute){
+    $model->name = ucfirst($request->name);
+}),
+```
+

src/Actions/Action.php

@@ -127,6 +127,21 @@ public function canRun(Closure $runCallback)
         return $this;
     }
 
+    /**
+     * Authorize the action on the given model based on resource gate permission.
+     *
+     * @param  string $ability
+     * @return $this
+     */
+    public function canRunWhen($ability)
+    {
+        $this->canRun(function ($request, $model) use ($ability) {
+            return $request->user()->can($ability, $model);
+        });
+
+        return $this;
+    }
+
     /**
      * Determine if the action is executable for the given request.
      *