Workflows add Drag & Drop automation's to your Laravel application.

The Workflow Package adds Drag & Drop Workflows to your Laravel Application. A Workflow consists of Triggers and Tasks. The Trigger is responsible for starting a Workflow. The Tasks are single nodes of code execution. The package comes with some handy tasks bundled, but you can easily write your own as well.

If you are interested in news and updates

Follow me on Twitter && || register to our Newsletter

Video Tutorial

Installation

You can install the package via composer:

composer require the42coders/workflows

You need to register the routes to your web.php routes File as well. Since the Workflow Package is very powerful make sure to secure the routes with whatever authentication you use in the rest of your app.

Route::group(['middleware' => ['auth']], function () {
    \the42coders\Workflows\Workflows::routes();
});

You need to publish the assets of the Package

php artisan vendor:publish --provider="the42coders\Workflows\WorkflowsServiceProvider"  --tag=assets

Usage

The Workflow Package is working out of the Box in your Laravel application. Just go to the route /workflows to get started.

Workflows

A Workflow is gets started by a Trigger and then executes the Tasks in the Order you set them. To pass information between the Tasks we have the DataBus.

Triggers

A Trigger is the Starting Point and defines how a Workflow gets called. More Triggers coming soon.

ObserverTrigger

The Observer Trigger can listen to Eloquent Model Events and will then pass the Model which triggered the Event to the Workflow.

To make it Work add the WorkflowObservable to your Eloquent Model.

 use WorkflowObservable;

Tasks

A Task is a single code execution Node in the Workflow.

Task	Description
HtmlInput	The HtmlInput Task offers you a Trix Input Field which is able to render Blade. You can put in placeholders for dynamic content in two Ways. From the Model passed through the Workflow or from the DataBus.
Execute	The Execute Task offers you to execute Shell Commands and is able to push the output of them to the DataBus.
PregReplace	The PregReplace Task offers you a way to to a preg replace on a Value from the Model or a DataBus Variable.
DomPDF	The DomPDF Task offers you a way to generate a PDF from HTML and put it to the DataBus (Works great with the HtmlInput Task).
SaveFile	The SaveFile Task allows you to save Data to a File. Works easily with your registered Storage defines.
SendMail	The SendMail Task allows you to send a Mail. You can pass the Content and Attachments to it. (Works great with HtmlInput and DomPDF)
HttpStatus	The HttpStatus offers you a way to receive the Http Status of a given URL.

DataBus

The DataBus is a way to pass information between the single Tasks. This keeps the Tasks independent of each other.

Resource	Description
ValueResource	The Value Resource is the simplest Resource. You can just write your Data in an input field.
ConfigResource	The Config Resource lets you access values from your Config Files.
ModelResource	The ModelResource lets you access the Data from the passed Eloquent Model.
DataBusResource	The DataBusResource lets you access the Data from the DataBus. This means all values which got set by a previous Task are access able here.

Testing

composer test

Changelog

Please see CHANGELOG for more information about what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email max@42coders.com instead of using the issue tracker.

hhfa1990 / workflows