youwe/workflow-gui

Workflow Configuration UI for Pimcore

Installs: 65 586

Dependents: 0

Suggesters: 0

Security: 0

Stars: 29

Watchers: 5

Forks: 15

Open Issues: 3

Language:JavaScript

Type:pimcore-bundle

v2.2.0 2024-07-22 08:04 UTC

README

Requirements

  • Pimcore 10.6.x - 11.x

Workflow GUI adds a User Interface for configuring Pimcore Workflows.

Getting started

Pimcore 10.6

  • Install via composer composer require youwe/workflow-gui
  • Enable via command-line (or inside the pimcore extension manager): bin/console pimcore:bundle:enable WorkflowGuiBundle
  • Install via command-line (or inside the pimcore extension manager): bin/console pimcore:bundle:install WorkflowGuiBundle
  • Make sure that the Bundles generated config is loaded (config/config.yaml): ../var/bundles/workflow-gui/workflow.yml

Pimcore 11

  • Install via composer composer require youwe/workflow-gui
  • Make sure the bundle is enabled in the config/bundles.php file. The following lines should be added:
return [
   // ...
   Youwe\Pimcore\WorkflowGui\WorkflowGuiBundle::class => ['all' => true],
   // ...
];
  • Install via command-line (or inside the pimcore extension manager): bin/console pimcore:bundle:install WorkflowGuiBundle
  • Make sure that the Bundles generated config is loaded (config/config.yaml): ../var/bundles/workflow-gui/workflow.yml

Example workflow

Put the workflow below in the following location var/bundles/workflow-gui/workflow.yml and change the class Pimcore\Model\DataObject\Test to the dataobject you want to apply it to.

pimcore:
    workflows:
        exampleWorkflow:
            enabled: true
            priority: 1
            label: 'Example workflow'
            initial_markings: placeA
            type: workflow
            audit_trail:
                enabled: true
            marking_store:
                type: state_table
            support_strategy:
                type: expression
                arguments:
                    - Pimcore\Model\DataObject\Test
                    - is_fully_authenticated()
            places:
                placeA:
                    visibleInHeader: true
                    title: 'Place A'
                    label: 'Place A'
                    color: '#eb0058'
                placeB:
                    title: 'Place B'
                    visibleInHeader: true
                    label: 'Place B'
                    color: '#00800f'
            transitions:
                placeAtoB:
                    from:
                        - placeA
                    to:
                        - placeB
                    options:
                        label: 'Place A to B'
                        changePublishedState: no_change
                        notes:
                            commentEnabled: false
                            additionalFields: {  }
            globalActions: {  }

Configuration

  • Inside your project, go to settings -> Workflows
  • Click in Add Workflow and enter the name of the new Workflow
  • At the Settings tab, the Label property is a required field
  • At the Supports tab, the Class property is a required field
  • At the Places tab, the Places are a required field
  • At the Transitions tab, the Transitions are a required field

For more information about the available options and description of the fields, go to the following URL: Pimcore-Documentation/WorkflowManagement/ConfigurationDetails

Workflow History

In the "Notes & Events" tab, there is a list with every action used on the object via the Workflow module.

Workflow Overview

If workflows are configured for a Pimcore element, an additional tab with workflow details like all configured workflows, their current places, and a workflow graph is added to Pimcore element detail page.

To render the graph, Graphviz is needed as an additional system requirement.