Skip to main content
Version: 2024.1

Installation of the Backend Power Tools Bundle

info

This bundle is only supported on Pimcore Core Framework 11.

Installation​

To install the Backend Power Tools bundle, follow the three steps below:

  1. Install the required dependencies:
composer require pimcore/backend-power-tools-bundle
  1. Make sure the bundle is enabled in the config/bundles.php file. The following lines should be added:
use Pimcore\Bundle\BackendPowerToolsBundle\PimcoreBackendPowerToolsBundle;
// ...
return [
    // ...
    PimcoreBackendPowerToolsBundle::class => ['all' => true],
    // ...
];
  1. Install the bundle:
bin/console pimcore:bundle:install PimcoreBackendPowerToolsBundle

Bundle Configuration​

The Alternative Element Tree features is based on the Symfony Messenger queue. If activated, the processing is automatically kicked off as soon as a Configuration or Data Object is saved.

Messages are dispatched via pimcore_alternative_element_trees transport. Please ensure you have workers processing this transport when using this feature.

Deployment hint:

For deployments of applications with this bundle via deployment pipelines without actual database access, the Symfony cache warming process could fail as doctrine ORM tries to determine the database version on cache warm-up to build its cache. Therefore, it is recommended to configure the database server version in the default DBAL connection like this:

doctrine:
    dbal:
        default_connection: default
        connections:
            default:
                ...
                server_version: mariadb-10.11.0

Uninstallation​

Uninstalling the bundle does not clean up the bundle_backend_power_tools_* tables. After uninstalling, make sure to clean them up manually.