Traitement avancé des commandes : installation et aide

1. Importez le ZIP de mprorderworkflow via Modules > "Module Manager".
2. Ouvrez "Configure" et vérifiez les paramètres ci-dessous.
3. Ouvrez Workflow de commande et créez une équipe avec des employés actifs.
4. Ajoutez des statuts de workflow dans "WF Statuses" et choisissez leurs équipes responsables.
5. Ouvrez une commande de test et vérifiez que le panneau de workflow apparaît.
6. Changez son statut interne, ajoutez un commentaire et vérifiez les notifications des employés concernés.

Nécessite PrestaShop 1.6.1 ou une version ultérieure et PHP 7.1 ou une version ultérieure.

Le produit est présenté sous le nom Advanced Order Fulfilment et apparaît dans le back-office sous le nom Advanced Order Workflow. Son menu comprend Workflow de commande pour les équipes, "WF Orders", "WF Comments", "WF Statuses", "WF Dashboard", "WF Notifications" et Paramètres > Configuration.

Les états de commande natifs de PrestaShop restent le cycle de vie visible par les clients. Les statuts de workflow, commentaires et rappels sont des données internes. Changer un statut de workflow ne met pas à jour le paiement, l'expédition ou l'état natif de la commande.

Équipes

Dans Workflow de commande, ajoutez une équipe et définissez :

Par exemple, créez Préparation des commandes, sélectionnez vos employés d'entrepôt et associez "Payment accepted" et "Preparation in progress" si ces états doivent attirer leur attention sur la commande.

Créez les équipes dans le contexte de la boutique concernée. Une nouvelle équipe utilise l'identifiant de la boutique courante si aucun identifiant n'est fourni. Les recherches d'équipes peuvent être filtrées par boutique.

"WF Statuses"

Créez d'abord tous les statuts si vous devez les relier comme étapes suivantes recommandées ou suggérées. Par exemple, créez En attente de réponse du client, affectez Service client, puis recommandez Prêt pour l'emballage et suggérez Vérification du responsable. Les sélections de statuts suggérés sont enregistrées sous forme d'identifiants, comme [3,5,8] ; utilisez le sélecteur plutôt que de modifier directement ce JSON.

Les champs d'étapes suivantes guident les choix des employés. Ils ne font pas avancer automatiquement une commande et n'imposent pas un graphe complet de transitions.

Un commentaire ordinaire reste interne au back-office. Un commentaire privé est visible uniquement par son auteur. Un commentaire non privé associé à une équipe est limité aux membres de cette équipe et à son auteur. Les commentaires non privés sans équipe sont visibles par les employés ayant accès à la commande. N'interprétez pas le choix public du fil comme une publication visible des clients. Vous pouvez uniquement associer un commentaire à une équipe dont vous êtes membre.

Utilisez @ suivi d’au moins deux caractères dans le panneau de commande pour trouver les employés actifs, puis choisissez l’employé dans la liste de suggestions. Les mentions créent des notifications internes de workflow. Le module recherche le prénom ou le nom complet d’un employé après @ dans le texte du commentaire enregistré. Un texte correspondant saisi sans sélectionner de suggestion peut donc notifier des employés. Le module n’envoie aucun e-mail de notification.

Les pièces jointes prennent en charge JPG/JPEG, PNG, GIF, WebP, BMP, TIFF/TIF, PDF, DOC/DOCX, XLS/XLSX, CSV, TXT, RTF, ODT/ODS/ODP, PPT/PPTX et EML. Le validateur vérifie la taille, l'extension et le type MIME détecté. Les vérifications des documents Office ZIP nécessitent PHP ZipArchive et la détection MIME doit être disponible.

Le validateur des fichiers impose actuellement une limite fixe de 5 MB par fichier. Modifier Taille maximale des pièces jointes ne change pas cette limite.

Le processus PHP doit pouvoir écrire dans modules/mprorderworkflow/uploads/. La fonction utilitaire y écrit une règle Apache de refus d'accès dans .htaccess et un fichier index. Si votre serveur n'applique pas .htaccess, configurez un refus d'accès direct équivalent. Le fichier est destiné à être téléchargé via le contrôleur authentifié du back-office, qui vérifie l'accès à son commentaire. Votre serveur web doit appliquer le refus d'accès direct.

Notifier les changements de statut contrôle actuellement les notifications de changement d’état natif des commandes PrestaShop. Les changements de statut interne du workflow notifient toujours l’équipe responsable lorsque ce réglage est désactivé. Les commentaires privés ne déclenchent pas le flux habituel de notifications d'équipe, de fil ou de mention. Chaque employé peut couper ses propres notifications dans le panneau de workflow. Testez en tant que destinataire, car l'auteur peut être exclu des notifications.

Paramètres de diffusion

Consultez les notifications dans "WF Notifications". Le badge de l'en-tête est affiché au chargement de la page ; le panneau de commande actualise le nombre de notifications non lues à son ouverture et après un changement de statut, un commentaire ou une action sur les rappels. Rechargez la page pour voir les changements effectués par les autres employés. Les réglages des notifications du navigateur et des sons sont sans effet dans cette version.

Ouvrez une commande de test. Sélectionnez un statut de workflow, consultez l'historique, définissez son score et ajoutez un commentaire. Le panneau actualise ses données via le contrôleur AJAX du module. Si un autre employé a changé la version, actualisez et vérifiez l'état le plus récent avant de soumettre à nouveau.

Le panneau de commande crée les rappels pour l'étape actuelle du workflow ou, si la commande n'a pas encore d'étape, pour la commande elle-même. Choisissez une heure et un employé ou une équipe. Les choix rapides comprennent Dans 1 heure, Dans 2 heures, Demain, Dans 2 jours et Dans 1 semaine.

Les rappels arrivés à échéance sont traités au chargement des pages du back-office lorsque Activer le workflow et Activer les rappels sont activés. Le traitement s'exécute au plus une fois par minute, par lots limités. Après une période sans activité dans le back-office, les rappels échus sont traités lors d'un chargement de page ultérieur. Aucune commande cron ou CLI n'est nécessaire.

Un rappel arrivé à échéance crée des notifications de workflow pour ses destinataires et est automatiquement marqué terminé après son traitement. La création des notifications respecte le réglage de mise en sourdine du destinataire. Le module n’envoie aucun e-mail de rappel et ne change pas automatiquement la commande. Le nettoyage des notifications lues est déclenché par l’activité du back-office au plus une fois par jour.

Utilisez "WF Orders" comme Centre de contrôle des commandes pour filtrer par statut de workflow, équipe, score, informations de commentaire ou de fin et état natif. Utilisez "WF Comments" pour le flux de commentaires, "WF Dashboard" pour les nombres d'équipes, de commentaires et d'activités et "WF Notifications" pour vos notifications.

Les actions sur les commandes nécessitent un employé connecté, une commande valide, la permission PrestaShop de consultation des commandes et l’accès à la boutique de cette commande. Les actions AJAX actuelles ne vérifient pas en plus la permission PrestaShop de modification des commandes. Seul l’auteur d’un commentaire peut le modifier ou changer ses pièces jointes. Les rappels peuvent être modifiés, supprimés et terminés par leur créateur, l’employé affecté ou un membre de l’équipe affectée. Les règles des commentaires privés et d’équipe s’appliquent à la lecture des commentaires et au téléchargement des fichiers. Terminer un rappel lié à un commentaire nécessite aussi l'accès à ce commentaire.

• Avec deux employés de test, vérifiez le panneau et les commentaires ordinaires, d'équipe et privés. Confirmez que chacun ne voit que le périmètre de commentaires prévu.
• Changez séparément un statut interne et un état de commande natif associé. Vérifiez que les employés responsables reçoivent les bonnes notifications internes.
• Créez un rappel bientôt dû. Chargez une page du back-office après l'heure prévue et le délai de limitation d'une minute, puis vérifiez les notifications et la préférence de mise en sourdine du destinataire.
• Importez un fichier autorisé de moins de 5 MB et téléchargez-le en tant qu'employé autorisé. En cas d'échec, examinez les limites d'import PHP, la prise en charge MIME/ZipArchive et les permissions du répertoire.
• Si le panneau est absent, vérifiez Activer le workflow, Afficher le panneau de commande, l'accès de l'employé à la commande et à la boutique, ainsi que les hooks de consultation des commandes. Le module prend en charge displayAdminOrder et displayAdminOrderMainBottom avec protection contre les panneaux en double.
• Si une notification manque, vérifiez le réglage concerné, l'appartenance à l'équipe, la visibilité privée ou d'équipe, l'exclusion de l'auteur et la mise en sourdine de l'employé.

Le module n'interroge pas les transporteurs, ne remplace pas le processus de commande et ne crée pas d'intégrations de paiement ou de transporteur. Les personnalisations CSS peuvent cibler .mprwf-order-panel .mprwf-card, .mprwf-comment-private, .mprwf-team-label, .mprwf-current-status et .mprwf-score-widget.

Désactivez le workflow pour suspendre ses hooks habituels. Sauvegardez les tables du module et les fichiers importés avant la désinstallation si vous devez conserver l'historique opérationnel. La désinstallation supprime les tables d'équipes, de statuts, d'historique, de commentaires, de rappels, de notifications et de préférences, ainsi que la configuration du module et ses entrées de menu. Le répertoire d'import est conservé après la désinstallation. Les commandes natives restent dans PrestaShop.

Le module possède les 10 tables de workflow suivantes, indiquées sans le préfixe de votre base de données. Incluez-les toutes dans votre sauvegarde :

mprwf_team, mprwf_team_employee, mprwf_team_status, mprwf_status, mprwf_status_lang, mprwf_order_history, mprwf_order_comment, mprwf_reminder, mprwf_notification, mprwf_employee_preference.