--- title: Templates de email personalizados — crear desde cero section: email slug: custom-templates description: "Como crear templates de email completamente personalizados en modulos PrestaShop: estructura HTML+TXT, variables dinamicas, multiidioma y envio con Mail::Send()." keywords: "prestashop email template personalizado HTML TXT multiidioma variables Mail::Send modulo custom" last_updated: 2024-12-01 source_url: "https://ayudaprestashop.es/email/custom-templates" --- # Templates de email personalizados — crear desde cero > Como crear templates de email completamente personalizados en modulos PrestaShop: estructura HTML+TXT, variables dinamicas, multiidioma y envio con Mail::Send(). Crear templates de email personalizados en un modulo requiere seguir la convencion de directorios de PrestaShop. Cada template debe tener una version HTML y una version TXT. Las variables se definen como `{variable}` en el template. ## Estructura de templates de email *Estructura de directorios para templates de email* ```text modules/mymodule/ └── mails/ ├── es/ │ ├── my_notification.html ← Template HTML en español │ ├── my_notification.txt ← Template texto plano en español │ └── subject.tpl ← (Opcional) Asunto multiidioma ├── en/ │ ├── my_notification.html ← Template HTML en ingles │ └── my_notification.txt ├── fr/ │ ├── my_notification.html │ └── my_notification.txt └── de/ ├── my_notification.html └── my_notification.txt # IMPORTANTE: # - El nombre del archivo = nombre del template (sin extension) # - El directorio = ISO del idioma (es, en, fr, de, it, pt...) # - PrestaShop usa el idioma del cliente para elegir el directorio # - Si no existe el idioma, usa 'en' como fallback ``` ## Template HTML base *mails/es/my_notification.html — template HTML* ```html {subject}
{shop_name}

Hola {firstname} {lastname},

Nos complace informarte de que tu solicitud ha sido procesada correctamente.

Detalles de tu notificacion

Referencia: {reference}
Fecha: {date}
Estado: {status}

Ver mi cuenta

Si tienes alguna pregunta, no dudes en contactarnos.

Un saludo,
{shop_name}

{shop_name} — {shop_url}
Visitar la tienda
``` ## Template TXT (version texto plano) *mails/es/my_notification.txt — version texto plano* ```text Hola {firstname} {lastname}, Nos complace informarte de que tu solicitud ha sido procesada correctamente. Detalles de tu notificacion: - Referencia: {reference} - Fecha: {date} - Estado: {status} Puedes ver los detalles en tu cuenta: {customer_url} Si tienes alguna pregunta, no dudes en contactarnos. Un saludo, {shop_name} {shop_url} ``` ## Variables disponibles y personalizadas | Variable | Valor | Siempre disponible | | --- | --- | --- | | {shop_name} | Nombre de la tienda (Configuration::PS_SHOP_NAME) | Si | | {shop_url} | URL de la tienda | Si | | {shop_logo} | URL del logo de la tienda | Si | | {shop_logo_url} | URL del logo (alternativo) | Si | | {subject} | Asunto del email | Si | | {firstname} | Nombre del cliente | Si se pasa en templateVars | | {lastname} | Apellido del cliente | Si se pasa en templateVars | | {email} | Email del cliente | Si se pasa en templateVars | | {date} | Fecha actual formateada | Si | | {today} | Fecha de hoy | Si | ## Enviar con Mail::Send() *Enviar el email personalizado desde el modulo* ```php id_lang); // Path al directorio de templates del modulo $templateDir = _PS_MODULE_DIR_ . $this->name . '/mails/'; // Variables disponibles en el template $templateVars = [ '{firstname}' => $customer->firstname, '{lastname}' => $customer->lastname, '{email}' => $customer->email, '{reference}' => $reference, '{date}' => date('d/m/Y H:i'), '{status}' => $status, '{customer_url}' => Context::getContext()->link->getPageLink('my-account'), ]; return (bool) Mail::Send( (int) $customer->id_lang, 'my_notification', // Nombre del template (sin extension) 'Tu solicitud ha sido procesada', // Asunto $templateVars, $customer->email, $customer->firstname . ' ' . $customer->lastname, null, // Reply-to email null, // Reply-to name null, // Adjunto null, $templateDir, // Directorio de templates del modulo false, // No usar die() si falla (int) Context::getContext()->shop->id ); } ``` ## Soporte multiidioma *Crear directorios de idioma automaticamente al instalar* ```php name . '/mails/'; foreach (Language::getLanguages(false) as $lang) { $langDir = $mailsDir . $lang['iso_code'] . '/'; if (!is_dir($langDir)) { mkdir($langDir, 0755, true); } $htmlFile = $langDir . 'my_notification.html'; $txtFile = $langDir . 'my_notification.txt'; // Copiar desde el template de 'en' si no existe el del idioma if (!file_exists($htmlFile) && file_exists($mailsDir . 'en/my_notification.html')) { copy($mailsDir . 'en/my_notification.html', $htmlFile); } if (!file_exists($txtFile) && file_exists($mailsDir . 'en/my_notification.txt')) { copy($mailsDir . 'en/my_notification.txt', $txtFile); } } return true; } ``` --- *Fuente: [https://ayudaprestashop.es/email/custom-templates](https://ayudaprestashop.es/email/custom-templates). Version Markdown generada automaticamente para consumo por LLMs.*