In order to be able to use these settings optimally, advanced technical understanding and knowledge of HTML and CSS are helpful.
It is possible to change the template variant of an existing website at a later date. For example, it is possible to switch from the Standard (or Agency) variant to the Burger variant. After changing the template variant, it may be necessary to manually adjust the element settings for individual pages to ensure optimal display.
The following variants of the Mercury template are included in the Mercury extension package:
- Standard (Variant: standard)
- Burger (Variant: burger)
- Agentur (Variant: agency)
A separate master configuration can also be created for each installation.
This master configuration controls which formatters and functions are used in a template variant. Various customer-specific settings are also made through the master configuration.
The default master configurations are stored in the following files:
/system/modules/alkacon.mercury.customer.generic/configuration/generic.{name}.master.xml
The master configuration of the “Standard” template variant is therefore:
/system/modules/alkacon.mercury.customer.generic/configuration/generic.standard.master.xml
Es gibt die folgenden Varianten des Mercury-Templates:
- Standard (Variante: standard)
- Burger (Variante: burger)
- Agentur (Variante: agency)
Für jede Kundeninstallation existiert pro Template-Variante außerdem eine eigene Master-Konfiguration. Aktuell sind dies:
- Aachen (name: aachen)
- Bamberg (name: bamberg)
- Köln (name: ebk)
- Mainz (name: mainz)
Diese Master-Konfiguration steuert, welche Formatter bzw. Funktionen in einer Template-Variante verwendet werden. Außerdem werden über die Master-Konfiguration verschiedene kundenspezifische Einstellungen vorgenommen.
Die Master-Konfigurationen sind in den folgenden Dateien hinterlegt:
/system/modules/alkacon.mercury.bistuemer.{name}/configuration/{name}.agency.master.xml
/system/modules/alkacon.mercury.bistuemer.{name}/configuration/{name}.burger.master.xml
/system/modules/alkacon.mercury.bistuemer.{name}/configuration/{name}.standard.master.xml
Die Master-Konfiguration der Template-Variante „Standard“ z.B. für Köln ist demnach:
/system/modules/alkacon.mercury.bistuemer.ebk/configuration/ebk.standard.master.xml
To ensure that the template variant change runs smoothly, a website must be prepared.
First, the entire website and all content contained within it has to be published. There must be no unpublished content on the website.
After ensuring that all content has been published on the website, open the sitemap configuration of the website for which the template variant is to be changed.
The easiest way to access the sitemap configuration of a website is to open the sitemap editor and select “Advanced” > “Sitemap configuration” from the toolbar menu.
In the editor, switch to the Formatters tab in the sitemap configuration. Activate the Use formatter keys option by checking the box.
Save the sitemap configuration and exit the editor.
Switch to the Explorer view. Go to the “parent folder” of the website you want to customize.
Open the context menu of the folder containing the website you want to change. This will open the "Advanced" > "Touch" dialog box.
In the dialog box that appears, check both options, i.e. Modify all sufolders/files and Rewrite content must be selected.
Confirm the dialog box with OK.
The CMS will now automatically rewrite the website content to enable a change of template variant.
Note: This step only needs to be performed once per website. If the template variant is changed repeatedly, this step can be omitted if it has already been performed once before.
To change the template variant of a prepared website, the sitemap configuration needs to be adjusted again first.
In the editor for the sitemap configuration, you will find the currently active configuration on the first tab, Content Elements, as Master Configuration. This should correspond to one of the configurations mentioned above.
Change the configuration by overwriting the previous file path with the one for the desired template variant.
Save the sitemap configuration and exit the editor.
If you switch from the Standard (or Agency) variant to the Burger variant - or vice versa - you will also have to regenerate the CSS using the theme generator.
Open the theme generator for the relevant website. In the theme settings on the first tab, you need to select or deselect the “Burger” template variant option.
Generate the CSS according to the newly selected template variant.
The website will now be displayed in the selected template variant.
To be on the safe side, check the pages again in the editor to make sure that everything looks as desired.
If you have switched between the Standard and Burger variants, you should check the header area in particular, as the possible element settings differ significantly between the variants. Adjust the header settings if necessary to optimize the appearance according to your preferences.
If you notice any problems when checking the website, you still have the option of undoing the template variant change at this point.
To undo the changes, open the context menu of the folder containing the modified website. Select the Undo changes entry and then select the On this folder and all resources contained in this folder option in the dialog box that appears.