Le module Maillog pour OpenMage

N'oubliez pas que cette documentation ne concerne que la dernière version du module.
N'oubliez pas de lire cette page entièrement.

🌟🌟🌟🌟🌟 par Jérôme,
le 01/04/2020 Ce module n'est pas premium, n'est pas ultimate, n'est pas pro, il ne contient pas un mouchard ni un jolie panneau de publicité, et il n'augmentera pas votre ROI de 165%. Il est tout simplement mieux que tout ce que vous avez pu voir ailleurs. C'est une révolution !

Présentation du module

Description

Ce module permet :

• d'afficher la liste des email envoyés
• d'importer les adresses emails désabonnées et invalides dans OpenMage
• de synchroniser les données des clients de OpenMage vers votre Système (Emarsys ou Mautic, multithread)
• d'envoyer les emails en arrière plan (sans affecter le temps de chargement de la page)
• d'envoyer le bon email pour les emails de la newsletter lors de l'envoi depuis le back-office
• d'ajouter le support des opérateurs de comparaison aux conditions et de la boucle foreach dans les emails
• de recevoir un rapport quotidien, hebdomadaire ou mensuel sur l'état de l'envoi des emails, des synchronisations et des imports

Le rapport est envoyé par email dans la nuit en fonction de la configuration.
La file d'attente est désactivée lorsque le module est actif et chaque email envoyé avec la classe Zend_Mail est « capturé » par le module.

Accès et configuration

Configuration disponible dans Système » Configuration » Outils » Emails transactionnels et dans Synchronisation des clients.
Disponible dans Outils » Emails transactionnels et dans Synchronisation des clients.

Configuration disponible aussi dans Système » Configuration » Clients » Newsletter.
Disponible aussi dans l'onglet Emails transactionnels des commandes et des clients.

Durée de vie de l'historique

La durée de vie se configure facilement via un nombre de jour (ou de mois ou d'années).
Pour chaque ligne :

• la première liste déroulante correspond à la durée de vie du contenu de l'email et de ses pièces jointes (s'il est supprimé, on conserve le reste)
• la seconde correspond à la durée de vie de l'email (s'il est supprimé, il ne reste rien)
• la première case couleur correspond à la couleur d'arrière plan de l'entête (lorsqu'il est affiché en ligne)
• la seconde correspond à la couleur du texte de l'entête

...

Sécurité

...

Compatible avec OpenFileEditor

Lorsque l'extension pour navigateur OpenFileEditor est installée, lors de l'affichage d'une trace d'erreur PHP, les chemins des fichiers sont cliquables, afin de les ouvrirs dans votre éditeur de fichier préféré.

Installation et désinstallation

Rien de plus simple avec composer (ou en décompressant l'archive du module).
Pour obtenir la clef, continuez votre lecture :) ...

Then apply: openmage.diff

Pour permettre les emojis dans le sujet et le contenu des emails, dans le fichier local.xml, il faut utiliser SET NAMES utf8mb4 pour initStatements (voir OpenMage#430).

Enfin, n'oubliez pas de configurer le crontab pour exécuter le fichier maillog.sh chaque minute.

autumn
borland
bw
colorful
default
emacs
friendly
fruity
github
manni
monokai
murphy
native
pastie
perldoc
tango
trac
vim
vs
zenburn
crontab* * * * *  www-data  bash /path/to/maillog.sh

Pour la désinstallation, après avoir désinstallé le module, supprimé les changements dans lib/Zend/Mail/Transport/Sendmail.php et lib/Varien/Filter/Template.php, et arrêté le crontab du maillog.sh, il ne reste plus qu'à effacer la configuration et les données :

autumn
borland
bw
colorful
default
emacs
friendly
fruity
github
manni
monokai
murphy
native
pastie
perldoc
tango
trac
vim
vs
zenburn
sqlDELETE FROM core_config_data WHERE path LIKE "maillog%";
DELETE FROM core_config_data WHERE path LIKE "crontab/jobs/maillog_%";
DELETE FROM core_config_data WHERE path LIKE "newsletter/%/%send";
DELETE FROM core_resource WHERE code = "maillog_setup";
DELETE FROM eav_attribute WHERE attribute_code = "is_bounce";
DROP TABLE IF EXISTS luigifab_maillog;
DROP TABLE IF EXISTS luigifab_maillog_sync;
DROP TABLE IF EXISTS luigifab_maillog_bounce;

Directives emails et wysiwyg

...

Configuration des emails

Liste des variables :

• #uniqid#
• #mailid#xyz#
• #online# / #online#storeId#
• #readimg#

...

Configuration de la synchronisation

La synchronisation permet de synchroniser les données des clients de OpenMage vers votre Système.
Elle est réalisée chaque minute via une tâche cron sur les événements suivants (que ce soit depuis le front-office ou depuis le back-office) :

• lors de la connexion d'un client,
• lors de l'enregistrement ou de la suppression d'un client,
• lors de l'enregistrement ou de la suppression d'un abonné,
• lors de l'enregistrement de l'adresse de livraison ou de facturation d'un client,
• lors de la facturation d'une commande.

...

Téléchargement du module

Installation avec composer : composer require luigifab/openmage-maillog

Téléchargement de la dernière version : openmage-maillog-5.9.0.tar.gz
Voir aussi : github - composer - geany - phpstorm

• Version actuelle : 5.9.0 (01/01/2024)
• Compatibilité : OpenMage 19.x / 20.x / 21.x, PHP 7.2 / 7.3 / 7.4 / 8.0 / 8.1 / 8.2 / 8.3 (avec exec)
• Compatibilité client : Firefox 36+, Chrome 32+, Opera 19+, Edge 16+, Safari 9+
• Traductions : allemand (de), anglais (en), espagnol (es), français (fr-FR/fr-CA), italien (it), portugais (pt-PT/pt-BR) / chinois (zh), grec (el), hongrois (hu), japonais (ja), néerlandais (nl), polonais (pl), roumain (ro), russe (ru), slovaque (sk), tchèque (cs), turc (tr), ukrainien (uk)
• Licence : GNU GPL 2.0+
• À lire absolument : le fichier README

5.9.0

Testé avec Firefox 36/114, Chrome 32/109, Edge 109, Opera 19/95 sur OpenMage 21.3.0 avec PHP 7.2 - 8.3 et MariaDB 10.11.

Si vous aimez ce module, prenez un peu de votre temps pour améliorer les traductions.