Override customer PrestaShop

1. À quoi sert ce fichier ?

E-connecteur crée et met à jour les comptes clients de votre boutique au travers du webservice PrestaShop. Selon la version de PrestaShop, ce webservice présente deux comportements qui perturbent la synchronisation :

L'override Customer.php corrige ces deux points :

• les champs last_passwd_gen et secure_key envoyés par le webservice sont ignorés : PrestaShop conserve ses propres valeurs ;
• les valeurs existantes en base sont préservées lors de chaque mise à jour ;
• le mot de passe du client n'est jamais modifié par erreur:
  • s'il est vide, le mot de passe existant est conservé ;
  • s'il est identique à celui en base, rien ne change ;
  • s'il est déjà chiffré (format bcrypt ou md5 PrestaShop), il est enregistré tel quel ;
  • sinon, il est chiffré avec le mécanisme standard de PrestaShop.

Le fichier ne modifie aucun autre comportement de la boutique : l'inscription, la connexion, le back-office et les modules ne sont pas concernés.

2. Prérequis

• Un accès FTP, SFTP ou SSH aux fichiers de la boutique.
• Le fichier Customer.php fourni par Vaisonet.
• Dans le back-office, sous Paramètres avancés > Performances > Mode debug, l'option « Désactiver tous les overrides » doit être sur Non.

3. Installation

Étape 1 : vérifier qu'aucun override Customer n'existe déjà

Ouvrez le dossier override/classes/ à la racine de votre boutique.

• Le fichier Customer.php n'existe pas : passez à l'étape 2.
• Le fichier Customer.php existe déjà, installé par un autre module : ne l'écrasez pas, reportez-vous au paragraphe 6.

Étape 2 : déposer le fichier

Copiez Customer.php dans :

<racine de la boutique>/override/classes/Customer.php

Étape 3 : régénérer l'index des classes

PrestaShop garde en cache la liste des overrides. Supprimez les fichiers suivants, qui sont recréés automatiquement :

<racine de la boutique>/var/cache/prod/class_index.php
<racine de la boutique>/var/cache/dev/class_index.php     (s'il existe)

Vous pouvez aussi vider le cache depuis le back-office : Paramètres avancés > Performances > Vider le cache.

Étape 4 : vérifier

1. Affichez n'importe quelle page de la boutique et du back-office : elles doivent s'afficher normalement.
2. Lancez une synchronisation depuis E-connecteur.
3. Vérifiez qu'un client modifié dans votre logiciel de gestion est bien mis à jour sur la boutique, sans erreur 93 dans le rapport du connecteur.
4. Test conseillé : depuis la boutique, utilisez « Mot de passe oublié » avec un compte client synchronisé. L'e-mail de réinitialisation doit arriver et son lien doit fonctionner.

4. En cas de problème

5. Désinstallation

1. Supprimez override/classes/Customer.php.
2. Supprimez var/cache/prod/class_index.php, ainsi que var/cache/dev/class_index.php s'il existe.

La boutique retrouve immédiatement son comportement d'origine.

6. Un fichier Customer.php existe déjà

PrestaShop n'accepte qu'un seul override par classe. Si un module a déjà installé un override/classes/Customer.php, les deux fichiers doivent être fusionnés par votre webmaster :

• reprendre dans le fichier existant les éléments de l'override Vaisonet : la propriété $webserviceParameters et les méthodes setWsLastPasswdGen, setWsSecureKey, setWsPasswd et updateWs ;
• si l'override existant définit déjà l'une de ces méthodes ou la propriété $webserviceParameters, fusionner le contenu au lieu de le dupliquer : PHP refuse deux méthodes du même nom ;
• supprimer ensuite class_index.php comme indiqué à l'étape 3.

En cas de doute, contactez le support Vaisonet en joignant le contenu de votre fichier override/classes/Customer.php actuel.

7. Questions fréquentes

Faut-il réinstaller l'override après une mise à jour de PrestaShop ?

Non, les fichiers du dossier override/ sont conservés lors des mises à jour. Après une mise à jour majeure, par exemple de 8.x vers 9.x, videz simplement le cache et vérifiez qu'une synchronisation client passe sans erreur.

L'override a-t-il un impact sur la sécurité des mots de passe ?

Non. Les mots de passe en clair sont chiffrés avec le mécanisme natif de PrestaShop (bcrypt). Seul le webservice, déjà protégé par votre clé d'API, peut transmettre un mot de passe déjà chiffré.

L'override ralentit-il la boutique ?

Non. Il n'intervient que lors des mises à jour de clients par le webservice, avec une seule lecture en base supplémentaire par client mis à jour.

Est-il utile sur PrestaShop 1.7 ?

Ce fichier a été validé pour PrestaShop 8.x et 9.x. Pour une version antérieure, contactez le support avant de l'installer.