Skip to main content

Appearance & Branding

In the appearance & branding settings (Settings > Appearance & Branding) system-wide settings for OpenDXP Admin Interface can be made. Changes should be made with care and only by developers. These settings are saved in var/config/admin_system_settings/admin_system_settings.yaml or in the settings store based on your configuration.

To switch from the Symfony configuration to the settings store for the first time, please follow these steps:

  1. Set your write target to settings-store:
opendxp_admin:
    config_location:
        admin_system_settings:
            write_target:
                type: 'settings-store'
  1. Save your system settings via admin user interface (Settings > Appearance & Branding).
  2. Set your read target to settings-store as well:
opendxp_admin:
    config_location:
        admin_system_settings:
            write_target:
                type: 'settings-store'
            read_target:
                type: 'settings-store' 

Colors​

Settings regarding colors of OpenDXP admin interface like login screen color, Admin interface color, Admin interface background etc.

Settings allowing to customize the logo in OpenDXP admin interface.

Custom Login Background Image​

Settings allowing to customize the background image in OpenDXP login screen.

Assets​

Settings for assets like disabling tree preview or hiding edit image tab in the admin interface.

Access admin config in PHP Controller​

You can access the admin settings configuration like in the following example:

<?php

namespace App\Controller;

use OpenDxp\Bundle\AdminBundle\System\AdminConfig;
use OpenDxp\Controller\FrontendController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;

class DefaultController extends FrontendController
{
    public function defaultAction(Request $request, AdminConfig $config): Response
    {
        // use type-hinting to inject the config service
        $config = $config->getAdminSystemSettingsConfig();
        $bar = $config['branding']['color_login_screen'];
    }
}