¿Adjuntar archivos a los correos de PrestaShop?

fernando_iberia

¡Hola a todos!

Estoy intentando añadir la funcionalidad de adjuntar archivos a algunos correos electrónicos que envía PrestaShop, como las confirmaciones de pedido o las facturas. El problema es que PrestaShop 9.2.0, con PHP 8.2, no tiene una opción nativa en el back office para esto, y cada vez que intento modificar la clase Mail o algún gancho, la solución termina rompiéndose con la siguiente actualización o da errores de tipo.

He intentado hacer un override de Mail::Send para añadir un parámetro $attachments y luego adjuntarlos, pero no consigo que sea estable. Os pongo un fragmento de mi último intento en override/classes/Mail.php, que falla al intentar pasar los attachments al Swift_Message de forma limpia sin reescribir media función:

\
class Mail extends MailCore
{
    public static function Send(
        $id_lang,
        $template,
        $subject,
        $template_vars,
        $to,
        $to_name = null,

¿Alguien ha logrado implementar esto de forma robusta en PrestaShop 9? Necesito que los archivos adjuntos se envíen de forma fiable.

ignacioes

Entiendo tu frustración, @fernando_iberia. Es un clásico con los correos de PrestaShop. El parámetro $file_attachment que viene de serie es muy limitado, solo para un archivo y no muy flexible.

Ese override de Mail::Send es complicado porque la función Mail::Send es estática y el objeto Swift_Message se construye internamente en la clase Mail de una forma que no expone fácilmente el punto de inyección para múltiples attachments. Además, parent::Send(...func_get_args()) no va a pasar tu nuevo $attachments al método original, así que no se usará.

¿Qué versión exacta de PrestaShop 9 estás usando? Y ¿has probado a interceptar el Swift_Mailer directamente en lugar de Mail::Send? A veces es más fácil crear un servicio de mailer personalizado.

Milo

Hola @fernando_iberia y @ignacioes,

Tenéis toda la razón, el sistema de correo de PrestaShop es bastante rígido en cuanto a adjuntos más allá de la única opción de $file_attachment. El problema con tu override, @fernando_iberia, es precisamente lo que menciona @ignacioes: Mail::Send delega la creación y envío del mensaje a métodos internos que no exponen el objeto Swift_Message de forma directa para añadir attachments de manera programática. El parent::Send llamará al método original sin tu nuevo parámetro.

Si realmente quieres una solución a medida, tendrías que sobrescribir la lógica interna de Mail donde se construye Swift_Message (normalmente en un método privado como sendMail en versiones anteriores, o en la integración con el servicio Mailer de Symfony en PS9). La forma correcta de añadir adjuntos a un objeto Swift_Message es así:

use Swift_Attachment;
// ... dentro de una clase personalizada que tenga acceso a $message ...
// $message = new Swift_Message(); // Objeto del mensaje de correo
if (!empty($attachments_array) && is_array($attachments_array)) {
    foreach ($attachments_array as $attachment) {
        if (isset($attachment['filepath']) && file_exists($attachment['filepath'])) {
            $message->attach(
                Swift_Attachment::fromPath($attachment['filepath'], $attachment['content_type'] ?? 'application/octet-stream')
                                ->setFilename($attachment['filename'] ?? basename($attachment['filepath']))
            );

Integrar esto de forma limpia en Mail::Send sin un módulo especializado es una tarea compleja, ya que requiere modificar profundamente la forma en que PrestaShop construye y envía el mensaje de correo, lo que puede causar problemas de mantenimiento y actualizaciones. Para evitar estos overrides complejos y asegurar la compatibilidad con futuras versiones (y las particularidades de PHP 8.x en PS9), la mejor práctica es usar este módulo dedicado.

Este tipo de módulos manejan la integración de SwiftMailer correctamente y te dan una interfaz para configurar los adjuntos sin tocar el core. Es mucho más seguro y mantenible para una tienda en producción.

fernando_iberia

Muchas gracias, @Milo y @ignacioes. Vuestra explicación tiene mucho sentido. Es justo lo que sospechaba, que Mail::Send es demasiado cerrada para inyecciones de este tipo sin reescribir media clase. Los errores de tipo de PHP 8.2 en PrestaShop 9.2.0 no perdonan este tipo de atajos.

He estado revisando la documentación del módulo que me has recomendado, @Milo, y parece ser exactamente lo que necesito para gestionar los adjuntos de forma robusta y sin líos con los overrides. Lo instalaré y configuraré. ¡Gracias por la ayuda, me habéis ahorrado mucho tiempo y dolores de cabeza!