frosh/flow-builder-insights

Extends the Shopware 6 Flow Builder with history and error tracking

Maintainers

Package info

github.com/FriendsOfShopware/FroshFlowBuilderInsights

Type:shopware-platform-plugin

pkg:composer/frosh/flow-builder-insights

Statistics

Installs: 11

Dependents: 0

Suggesters: 0

Stars: 0

Open Issues: 1

Security

Advisories: 0

Aikido package health analysis

1.0.0 2026-05-15 07:49 UTC

Requires

Requires (Dev)

MIT d510aa756b8ff3292375d054bafb158dd28db093

This package is auto-updated.

Last update: 2026-06-15 08:59:58 UTC

README

This plugin extends the Shopware 6 Flow Builder with execution history and error tracking.

The current feature set consists of:

  • Flow Execution History
    • Records every flow execution (success and error) in a dedicated frosh_flow_state table
    • Adds a history tab to the Flow detail page in the administration
    • Captures which user, integration or customer triggered the flow
    • Stores the event payload
  • Error Inspection
    • Persists exception message, file, line and class for failed flow executions
    • Modal viewer to inspect the stored event data and error details
  • Automatic Cleanup
    • Scheduled task removes old flow history entries based on a configurable retention time
    • Default retention: 30 days (configurable in plugin configuration)
  • FroshTools Integration (optional)
    • Health check that reports the number of failed flow executions in the system status
    • Activates automatically when frosh/tools is installed

Installation

Git

  • Clone this repository into custom/plugins of your Shopware 6 installation
  • Install composer dependencies shopware-cli extension prepare custom/plugins/FroshFlowBuilderInsights
  • Build the assets with shopware-cli extension build custom/plugins/FroshFlowBuilderInsights
  • Install and activate via bin/console plugin:refresh && bin/console plugin:install --activate FroshFlowBuilderInsights

Packagist

composer require frosh/flow-builder-insights
bin/console plugin:refresh
bin/console plugin:install --activate FroshFlowBuilderInsights

Configuration

Configure the plugin via the administration (Settings → Extensions → Frosh Flow Builder Insights) or via system config:

Key Default Description
retentionTime 30 Number of days after which flow history entries are deleted by the cleanup scheduled task

Requirements

  • Shopware 6.7 or higher

Scheduled Tasks

Task Description
Frosh\FlowBuilderInsights\ScheduledTask\CleanupFlowStateTableTask Deletes flow execution history entries older than the configured retention time