Download the PHP package heimrichhannot/contao-advanced-dashboard-bundle without Composer

Contao Advanced Dashboard Bundle

A bundle to add more flexibility to the contao backend dashboard.

Features

• replaces the contao dashboard with a more customizable one
• customize the dashboard versions list to your need, like changing the visibility of user and tables or add custom columns

Usage

Install

1. Install with composer or contao manager

   composer require heimrichhannot/contao-advanced-dashboard-bundle

2. Update database

Customize dashboard versions list.

A main feature of this bundle is the customization of the versions log in the contao dashboard. After installing this bundle, you'll find, that there is no difference to the original contao dashboard, as the default configurations are the same. But now you can create configurations thats specify which logs are displayed to a user filtered by user or table. You can also specify which columns are displayed.

1. Setup a versions_right configuration in your projekt config, typically config/config.yml

2. Clear your cache if not in dev mode

3. Apply the created right in user or user group settings to a user or user group.

Additional notes:

• If no configuration is defined, or a user has no configuration added, a default configuration is used. You can customize the default configuration by creating a configuation with the name default.
• Restriction are not applied to admin user.

Add custom content/sections to backend template

The dashboard template comes with this bundle contains some customization options. You can add custom section or content and disable existing sections.

Following postions are available (as template variables):

• positionTop
• positionBeforeShortcuts
• positionBeforeVersions
• positonBottom

Skip existing sections by settings these variables to false (available as template variables:

• showMessages
• showShortcuts
• showVersions

To set these template variables, you can use the contao parseTemplate hook or the BeforeParseTwigTemplateEvent and BeforeRenderTwigTemplateEvent events of Twig Support Bundle. For the twig support bundle events, the template name is be_advanced_dashboard.

If you use the parseTemplate hook to add your custom content, keep in mind it should have a priority higher than -10!

Developers

Add new columns or change the appearance of existing columns

There are two events to add custom columns to the versions log or change existing columns.

Maybe you have an extension that expands the version table and adds more information to a version database log entry and want to output that information in the dashboard version log. We recommend creating a Subscriber for VersionListDatabaseColumnsEvent and VersionListTableColumnsEvent.

Configuration reference