Temas de Email modernos en PrestaShop 8/9

modules/mymodule/
├── mails/
│   ├── themes/
│   │   └── my_custom_theme/     # Nombre del tema
│   │       ├── assets/           # CSS, imagenes del tema
│   │       └── layouts/          # Plantillas Twig del tema
│   └── layouts/                  # Layouts que extienden el core
│       └── extended_order_conf.html.twig
└── mymodule.php

<?php

use PrestaShop\PrestaShop\Core\MailTemplate\FolderThemeScanner;

public function install(): bool
{
    return parent::install()
        && $this->registerHook('actionListMailThemes')
        && $this->registerHook('actionGetMailLayoutTransformations')
        && $this->registerHook('actionBuildMailLayoutVariables');
}

/**
 * Registra el tema personalizado del modulo.
 * PrestaShop escaneara el directorio del tema y lo añade a la lista
 * disponible en BO > Diseno > Tema de email.
 */
public function hookActionListMailThemes(array $params): void
{
    /** @var \PrestaShop\PrestaShop\Core\MailTemplate\ThemeCollectionInterface $themes */
    $themes = $params['mailThemes'];

    $themePath = _PS_MODULE_DIR_ . $this->name . '/mails/themes/my_custom_theme';

    $scanner = new FolderThemeScanner();
    $myTheme = $scanner->scan($themePath);

    if (null !== $myTheme) {
        $themes->add($myTheme);
    }
}

<?php

use PrestaShop\PrestaShop\Core\MailTemplate\Layout\Layout;

/**
 * Reemplaza o extiende layouts del tema 'modern' del core.
 * Util para personalizar emails especificos sin crear un tema completo.
 */
public function hookActionListMailThemes(array $params): void
{
    $themes = $params['mailThemes'];

    foreach ($themes as $theme) {
        // Solo modificar el tema 'modern' del core
        if ($theme->getName() !== 'modern') {
            continue;
        }

        // Obtener el layout original de confirmacion de pedido
        $orderConf = $theme->getLayouts()->getLayout('order_conf', '');

        if ($orderConf) {
            $index = $theme->getLayouts()->indexOf($orderConf);

            // Reemplazar con nuestra version extendida
            $theme->getLayouts()->offsetSet($index, new Layout(
                'order_conf',
                '@Modules/mymodule/mails/layouts/extended_order_conf.html.twig',
                '@Modules/mymodule/mails/layouts/extended_order_conf.txt.twig'
            ));
        }
    }
}

{# Extender el layout base del tema modern #}
{% extends '@MailThemes/modern/layouts/order_conf.html.twig' %}

{# Sobreescribir el bloque del footer para añadir logo de la empresa #}
{% block footer %}
  <table width="100%">
    <tr>
      <td align="center" style="padding: 20px;">
        <img src="{{ shop.logo }}" alt="{{ shop.name }}" height="40" />
      </td>
    </tr>
    <tr>
      <td align="center" style="font-size: 12px; color: #666;">
        {{ parent() }}
      </td>
    </tr>
  </table>
{% endblock %}

<?php

/**
 * Añade variables custom disponibles en todos los templates Twig de email.
 * Se llama en el momento de generar cada email.
 */
public function hookActionBuildMailLayoutVariables(array $params): void
{
    // $params['mailLayoutVariables'] es el array de variables del email

    // Añadir informacion de la empresa
    $params['mailLayoutVariables']['mymodule_company_slogan'] =
        Configuration::get('MY_MODULE_SLOGAN');

    // Añadir URL de redes sociales
    $params['mailLayoutVariables']['mymodule_facebook'] =
        Configuration::get('MY_MODULE_FACEBOOK_URL');

    // Añadir numero de soporte
    $params['mailLayoutVariables']['mymodule_support_phone'] =
        Configuration::get('MY_MODULE_SUPPORT_PHONE');
}

<?php

use PrestaShop\PrestaShop\Core\MailTemplate\Transformation\AbstractTransformation;

/**
 * Aplica transformaciones al HTML del email antes de enviarlo.
 * Ejemplo: cambiar colores corporativos.
 */
public function hookActionGetMailLayoutTransformations(array $params): void
{
    $transformations = $params['layoutTransformations'];

    // Reemplazar el color principal del tema por el color de la tienda
    $shopColor = Configuration::get('PS_SHOP_COLOR');
    if ($shopColor) {
        // Puedes usar tu propia clase de transformacion
        // o usar las transformaciones del core
        $transformations->add(
            new class($shopColor) extends AbstractTransformation {
                private string $color;

                public function __construct(string $color) {
                    parent::__construct('text/html');
                    $this->color = $color;
                }

                public function apply(
                    \Twig\Environment $twig,
                    array $templateVariables
                ): array {
                    // Inyectar variable de color en el template
                    $templateVariables['shop_color'] = $this->color;
                    return $templateVariables;
                }
            }
        );
    }
}