Sprout Documentation

Upgrading to Data Studio v4.44.444

Sprout Reports is now Sprout Data Studio and now includes integrated Commerce Data Sets and Date Range Helper classes. Data Sets now support a custom field layout and element sources can be customized based on a Data Source condition rule or any custom fields in your field layout.

# Breaking Changes

WARNING

Due to this plugin's name change (Reports => Data Studio) you will need to manually install it and manually update to your new license key after upgrading to Craft 4 to trigger its migrations. If you have any Report-related dashboard widgets you may see an error when you first login to your Craft 4 control panel. Navigate directly to the plugins page /admin/settings/plugins to install the plugin.

# License Migrations

Existing Sprout Reports license holders have received a new Sprout Data Studio Pro license in the same Craft Console account for the old Sprout Reports license key. Once installing Data Studio, you will need to manually add your new licenses key to your Craft installation. Your new Data Studio license will have the same expiration as the old Sprout Reports license and you will need to manually re-select the auto-renew option in your Craft Console.

# Data Studio

  • Sprout Reports has been renamed to Sprout Data Studio
  • Sprout Data Studio now has a Lite and Pro Edition.
  • Updated variable craft.sproutReports => sprout.twigDataSet
  • Twig Template Data Sources that use a Craft DateTime picker in their templates will need to update the date syntax to use Twig the date function
  • Twig Template Data Sources should update {%- includejs %} => {%- js %}
  • Any references to the Project Config settings key should be updated sprout-reports => sprout-module-data-studio
  • Custom DataSources should use BarrelStrength\Sprout\datastudio\datasources\DataSource (See vendor/barrelstrength/sprout/src/datastudio/components/datasources for examples)
  • Access Data Source permissions have been removed in favor of Craft User permissions. Confirm any permissions that were previously assigned to Data Sources are now assigned to the User Groups appropriately.
  • Date Sources used as email lists will need to be migrated manually to Audience Types (once the email module is released)

# Framework