Starting from 2023.3.0, Starter kit provides a user interface for managing logos and colors. It is now possible to change the logos/pictures and the colors used on portal.
A new menu called “Appearance” has been added to wedia-config, it leads us to the “Logos & Colors” view.
On this view we can change :
LOGO : Portail (Header)
LOGO : Backoffice (Header)
LOGO: Portal (Login page)
Will be used as header in the emails
LOGO : Portal (Homepage) and backoffice (login page)
Favicon
Main color
Secondary color
Colors
Under the new “Appearance” menu we will now find inputs allowing us to change colors.
To enable the color switch feature we have to :
Add a new parameter inside the used wediaportalrc configuration and set it to true =>
"useServerStyles": true,
"environments": { "starter-kit": { "": { "useServerStyles": true, "useServerConfigResolution": true, "deploy_server": "https://starter-kit.wedia-group.com", "vue_app_config_path": "portal", "appConfigs": { "portal": "starter-kit", "wediaConfig": "__wedia_config", "portal@picker": "starter-kit@$starter-kit-picker", "portal@picker@office": "starter-kit@$starter-kit-picker@office", "portal@picker@office@outlook": "starter-kit@$starter-kit-picker@office@outlook", "_postProcessors": [ [ "", "starter-kit-mobile" ] ] } }, "development": { "vue_app_api_path": "https://starter-kit.wedia-group.com" } } }
set jspMode to true
The above-mentioned conditions are also used to enable the favicon switch. The favicon changes can be done from wedia-config “Appearance” / “Logos & Colors”, but will only be effective if the conditions are fulfilled.
Then after editing colors from wedia-config under “Appearance” / “Logos & Colors” menu, the new chosen colors will be applied to portal and the main color will also be used in the emails generated by the app.
The colors switch is allowed by endpoints added with PACKAGED_Appearance_Config. Therefore to use this new feature the plugin must be activated
Logos
Under the new “Appearance” menu we will now find inputs allowing us to change logos.
For the logos and the favicon the behaviour is the same as if the change has been made from the old admin
=> we write values for i18n keys of bov3/wcm
The written values are paths to the files under the san : san/bov3/css/v11/customerupload/filename.ext
There are some rules to be followed for the uploaded files. They are always specified for each logo by the 'Authorized formats' information on the view.
After saving the modifications, the view will be reloaded to apply the new logos and pictures on the actual screen as well.
FAVICON & Colors :
To apply changes to the portal’s favicon and portal’s colors, you need to fulfill two conditions :
Add a new parameter inside the used wediaportalrc configuration and set it to true =>
"useServerStyles": true,
(at the same level asuseServerConfigResolution)
set jspMode to true
Emails templates & customization
More details about the new behaviour of the emails provided by the application : Email templates & customization