Feature Wiki
Tabs
Default-HTML-Frame for Mail in System Style
Page Overview
[Hide]An earlier version of the article has been updated and a separate request has been formulated for the Improvement of Mail Signature.
1 Initial Problem
ILIAS (system) mails use the basic HTML template with ILIAS logo and the default installation header title "Open Source eLearning". Changing the mail template is only possible by overwriting the corresponding template file in the system style. This HTML frame must always be created, compiled and provided again independently of the system style.
2 Conceptual Summary
A separate UI component was already created with the release of ILIAS 11: ‘Mail Page’.
With this feature the UI-Component is to be used when sending mails.
See https://test11.ilias.de/go/stys/21/LayoutPageMailMail/default/delos
Central changes to the system style, which are also used by the ‘Mail Page’ UI component, therefore have a direct impact on the design of mails.
Using UI-Component 'Mail Page'Changes in Administration:
- New Default of Setting "HTML Frame" in Mail-Administration is "activated". Existing ILIAS-Installations use the current setting status.
- Change the Byline of 'HTML-Frame‘ from
Embed the body of external e-mails in an HTML frame. The corresponding template can be customised by creating a copy of './Services/Mail/templates/default/tpl.html_mail_template.html' at './Customizing/global/skin/[SKIN]/Services/Mail/tpl.html_mail_template.html‘to the following text:If enabled, the body of external e-mails will be embedded in a HTML frame. If activated vaules of default System Style e.g. its logo, header title and colors of header, background and footer will be used. - If HTML Frame is enabled, the global defined signature of the ILIAS Installation is placed in the Footer of HTML Frame. An additional Byline
If HTML frame is activated this signature is shown in the footer area of the HTML mail template. is shown.
3 User Interface Modifications
3.1 List of Affected Views
- Administration » Communication » Mail »»» Settings » External
- sent Mails with HTML-Frame
3.2 User Interface Details
Using the new UI Compont 'Mail Page'.
3.3 New User Interface Concepts
None.
3.4 Accessibility Implications
None.
4 Technical Information
–
5 Privacy
There are no new or further privacy implications.
6 Security
There are no new or further security implications.
7 Contact
- Author of the Request: Jansen, Kelly [kjansen] and Samoila, Oliver [oliver.samoila]
- Maintainer: Jansen, Michael [mjansen]
- Implementation of the feature is done by: {The maintainer must add the name of the implementing developer.}
8 Funding
If you are interest in funding this feature, please add your name and institution to this list.
9 Discussion
Mix, Eva [emix], 6 DEC 2023: This feature seems like a great improvement to the ILIAS mails. From our point of view it would be important that the user-skin (not the default skin) is used for the HTML-frame. The background is that we have several ILIAS clients with multiple targed groups who all have their own skin. And further using the user-skin for the frame would align with the behaviour of mail placeholders since they are filled with regards to the users language.
Samoila, Oliver [oliver.samoila], 11 DEC 2023: The requirement is understandable, but such a change would result in much higher requirements in terms of performance. We have therefore actively decided against this change.
JourFixe, ILIAS [jourfixe], 11 DEC 2023: Suggestion is highly appreciated and feature accepted for ILIAS 10.
JourFixe, ILIAS [jourfixe], 09 MAR 2026: We highly appreciate this feature and accept it for trunk.
10 Implementation
{ The maintainer has to give a description of the final implementation and add screenshots if possible. }
Test Cases
- {Test case number linked to Testrail} : {test case title}
Approval
- Approved at 12 MAR 2026 by Vorkauf, Klaus [KlausVorkauf] for FH Dortmund.
- Approved at 13 MAR 2026 by Samoila, Oliver [oliver.samoila] for Databay AG.
Last edited: 18. Mar 2026, 11:17, Vorkauf, Klaus [KlausVorkauf]