ScheduledReports modify theme email

Rash · December 17, 2020, 2:49pm

Hi everyone, I have recently been using matomo.
I need to email reports and I have seen that ScheduledReports via email works fine.
I just wanted to ask you if it was possible to change the email template, it is set as 100% width and I would like to change it and I would like to change something else.

Is it possible to do this?
Thanks

Lukas · December 17, 2020, 3:43pm

Hi,

I think this is set here for all Matomo E-Mails:

github.com

matomo-org/matomo/blob/7edc2c9864f1b2fe43324f247ea82564d1112319/plugins/CoreHome/templates/_htmlEmailHeader.twig#L13


<head>
    <meta charset="utf-8">
    <meta name="robots" content="noindex,nofollow">
    <meta name="generator" content="Matomo Analytics">
</head>

<body style="{{fontStyle|raw}} line-height: 24px; margin:0 auto; max-width:1000px; background-color:rgb(255, 255, 255);box-shadow: 0px 0px 5px 1px rgba(0,0,0,0.75);">

<a name="reportTop"></a>

<table style="width:100%; background-color: {{ themeStyles.colorHeaderBackground|e('html_attr') }}; color: {{ themeStyles.colorHeaderText|e('html_attr') }}; padding:10px 0; margin: 0 0 25px 0; height:64px;">
    <tr>
        <td>
            <a style="{{ fontStyle|raw }}; font-size:16px;padding:0 15px;{% if not isCustomLogo or not logoHeader %}padding-bottom: 8px;{% endif %}color: {{ themeStyles.colorHeaderText|e('html_attr') }};height: 22px;display: inline-block;vertical-align: inherit;" rel="noreferrer noopener" target="_blank" href="{{ piwikUrl }}">
                {% if isCustomLogo and logoHeader %}
                    <img src="{{ logoHeader }}" height="20px" width="auto" />
                {% else %}
                    <img src="{{ piwikUrl }}/plugins/Morpheus/images/logo-email.png" height="30px" width="auto" alt="{{ emailStyles.brandNameLong|e('html_attr') }}" />
                {% endif %}
            </a>
        </td>

You can overwrite this template file in a custom theme as explained here:
https://developer.matomo.org/guides/theming#twig-the-template-engine

Rash · December 18, 2020, 11:54am

Ok perfect, thank’s!

Rash · December 22, 2020, 12:14pm

I made the changes to the email template but can’t make them permanent after the update.
I followed this guide: https://developer.matomo.org/guides/theming#twig-the-template-engine, and I inserted the modified templates as indicated, in my case:
plugins/CoreHome/templates/plugins/CoreHome/_htmlEmailHeader.twig

but it doesn’t work and after the update the folder was also deleted.
What am I doing wrong? Can you help me please?

Lukas · December 22, 2020, 1:37pm

Hi,

The idea of the guide is that you create your own theme and then put the modified file in plugins/YourTheme/templates/plugins/CoreHome/_htmlEmailHeader.twig. This way a Matomo update can overwrite the CoreHome directory, but your theme will stay and continue to overwrite the template.

Rash · December 22, 2020, 6:38pm

i created a new theme and now it works. thanks!