ObaydaAlesawi / ExtendableAction

ExtendableAction

Laravel packages that allows you to make your laravel project extendable and easy to include new features without touching old code throgh using Extendable Actions .

Why ExtendableAction?

Having large a code base, and having dynamic features leads to have a missy code base with huge maintainability headache, so this package implements main of Wordpress pluggable features by using of Filters and Actions ( see Wordpress Hooks ), so it allows you to expand your code base in a pluggable way.

Installation

1. Add to your repositories in composer.json

{
  "type": "vcs",
  "url": "https://github.com/Attia-Ahmed/ExtendableAction"
}

2. via composer

$ composer require attia-ahmed/extendable-action

or add it by hand to your composer.json file.

3. You can publish the config file with:

php artisan vendor:publish --provider="AttiaAhmed\ExtendableAction\ExtendableActionBaseServiceProvider"

Usage

1. make your extendable action:

Which is the main functionality that needs to be extended. You can make your extendable action by extending ExtendableAction class and define the run method that take any number of parameters (will be modified by filters) and return result (will be modified by actions) then it will be called as Invokable Class Example:

class ExampleExtendableAction extends ExtendableAction
{
    public function run($name)
    {
        return "Hello " . $name;
    }
}

2. make your filters:

Which are classes that modifies the ExtendableAction input parameters or do some logic/check before running the main functionality. You can make your Filter by extending Filter class and override the apply method that takes run method parameters of ExtendableAction as an array and returns array of parameters to be modified with another filters or to be passed to main ExtendableAction Example:

class ExampleFilter extends Filter
{
    public function apply(array $args): array
    {
        $args["name"] = "Mr. " . $args["name"];
        return $args;
    }
}

3. make your actions:

Which are classes that modifies the ExtendableAction result or do some logic/check after running the main functionality. You can make your Action by extending Action class and override the apply method that takes the result ofrun method of ExtendableAction and returns new result to be modified with another actions or to be final return result of ExtendableAction functionality. Example:

class ExampleAction extends Action
{
    public function apply($result)
    {
        return "<h1>{$result}</h1>";
    }
}

4. Link your Filters and Actions to your Extendable action :

You can link your Filters and Action to your Extendable Action by adding new element to extendable-action.php or by your custom implementation by overriding getFilters and getFilters of ExtendableAction class Example extendable-action.php:

return [
    ExampleExtendableAction::class => [
        "filters" => [
            ExampleFilter::class
        ],
        "actions" => [
            ExampleAction::class
        ]
    ],
];

5. Call your Extendable action :

ExtendableAction is an Invokable Class and can be called by as one of following examples:

//RECOMMENDED so it automatically be executed it while injecting its dependencies
$result = app(ExampleExtendableAction::class)(...$args);

or

$result = (new ExampleExtendableAction())(...$args);

Usage Notes

⚠️This package is a proof of concept and IS NOT READY for production.⚠️