{"id":2210,"date":"2021-02-01T23:10:05","date_gmt":"2021-02-01T21:10:05","guid":{"rendered":"https:\/\/www.h-hennes.fr\/blog\/?p=2210"},"modified":"2021-04-24T15:06:06","modified_gmt":"2021-04-24T13:06:06","slug":"prestashop-gerer-les-emails-dans-vos-modules","status":"publish","type":"post","link":"https:\/\/www.h-hennes.fr\/blog\/2021\/02\/01\/prestashop-gerer-les-emails-dans-vos-modules\/","title":{"rendered":"Prestashop : g\u00e9rer les emails dans vos modules"},"content":{"rendered":"\n

Dans cet article nous allons creuser tout de qui concerne la gestion des emails dans les modules prestashop.

Dans un premier temps comment envoyer un email bien s\u00fbr, mais nous verrons ensuite qu’il est tr\u00e8s facile d’interagir avec les emails syst\u00e8mes via les hooks.

Ce tutoriel s’applique \u00e0 la version 1.7 de Prestashop, certains hooks n’existent pas dans la version 1.6  dont le hook hookActionEmailSendBefore<\/strong> , il reste cependant assez facile de les impl\u00e9menter manuellement en surchargeant la classe Mail<\/em><\/p>\n

Pour illustrer et tester tout \u00e7a nous allons passer par la cr\u00e9ation d’un module de POC hh_demoemails<\/strong><\/p>\n

L’archive sera disponible en fin d’article, mais je pr\u00e9cise bien que c’est un module de d\u00e9mo et d’apprentissage et pas du tout en module destin\u00e9 \u00e0 \u00eatre mis en production \ud83d\ude09<\/p>\n\n\n\n

Fonctionnement g\u00e9n\u00e9ral<\/h3>\n\n\n\n

La gestion de l’envoi dans Prestashop est relativement basique car elle est centralis\u00e9e dans une seule fonction qui est la fonction send<\/strong> de la classe Mail<\/strong> voici ses param\u00e8tres, la signature de la fonction est relativement explicite<\/p>\n\n\n\n

\/**\n     * Send Email.\n     *\n     * @param int $idLang Language ID of the email (to translate the template)\n     * @param string $template Template: the name of template not be a var but a string !\n     * @param string $subject Subject of the email\n     * @param string $templateVars Template variables for the email\n     * @param string $to To email\n     * @param string $toName To name\n     * @param string $from From email\n     * @param string $fromName To email\n     * @param array $fileAttachment array with three parameters (content, mime and name).\n     *                              You can use an array of array to attach multiple files\n     * @param bool $mode_smtp SMTP mode (deprecated)\n     * @param string $templatePath Template path\n     * @param bool $die Die after error\n     * @param int $idShop Shop ID\n     * @param string $bcc Bcc recipient address. You can use an array of array to send to multiple recipients\n     * @param string $replyTo Reply-To recipient address\n     * @param string $replyToName Reply-To recipient name\n     *\n     * @return bool|int Whether sending was successful. If not at all, false, otherwise amount of recipients succeeded.\n     *\/\n    public static function send(\n        $idLang,\n        $template,\n        $subject,\n        $templateVars,\n        $to,\n        $toName = null,\n        $from = null,\n        $fromName = null,\n        $fileAttachment = null,\n        $mode_smtp = null,\n        $templatePath = _PS_MAIL_DIR_,\n        $die = false,\n        $idShop = null,\n        $bcc = null,\n        $replyTo = null,\n        $replyToName = null\n    ) {\n \/\/Code de la fonction\n} \n<\/pre>\n\n\n\n
Les templates des emails syst\u00e8mes par d\u00e9faut sont situ\u00e9s dans le dossier \/mails\/<\/strong> \u00e0 la racine de prestashop et rang\u00e9 ensuite par code langue ( fr\/ en )

Dans le cas ou voulez changer le contenu d’un email pour juste changer un texte, il ne faut surtout pas modifier ces emails de la racine , mais il n’est pas n\u00e9cessaire de passer par un module

Le plus simple est tout simplement de copier les fichiers .html et .txt du mod\u00e8le souhait\u00e9 dans le dossier mails du th\u00e8me.

Par exemple si vous souhaitez changer le contenu de l’email de paiement par ch\u00e8que<\/strong> en fran\u00e7ais<\/strong> et que votre th\u00e8me utilis\u00e9 est classic <\/strong>
Il faut copier les fichiers :<\/p>\n