{"id":2270,"date":"2021-04-22T21:12:42","date_gmt":"2021-04-22T19:12:42","guid":{"rendered":"https:\/\/www.h-hennes.fr\/blog\/?p=2270"},"modified":"2022-03-30T22:22:23","modified_gmt":"2022-03-30T20:22:23","slug":"prestashop-restreindre-un-transporteur-par-code-postal","status":"publish","type":"post","link":"https:\/\/www.h-hennes.fr\/blog\/2021\/04\/22\/prestashop-restreindre-un-transporteur-par-code-postal\/","title":{"rendered":"Prestashop : Restreindre un transporteur par code postal"},"content":{"rendered":"\n

On pourrait \u00e9galement compl\u00e9ter le titre \u00e9galement par : \u00ab\u00a0Ville \/ Nom … \u00ab\u00a0

C’est une demande qui revient assez r\u00e9guli\u00e8rement et qui est d’autant plus d’actualit\u00e9 avec le confinement actuel.
Comment restreindre un transporteur \u00e0 un certain code postal ?<\/strong><\/p>\n

Ceci permets par exemple de cr\u00e9er un transporteur de clic and collect d\u00e9limit\u00e9 \u00e0 certains codes postaux.

C’est tr\u00e8s facile \u00e0 faire dans Prestashop, mais cela n\u00e9cessite la cr\u00e9ation ou l’achat d’un module.

Nous allons voir comment proc\u00e9der techniquement pour faire cela.
Ce tutoriel est valide \u00e0 la fois pour les versions 1.6.x et 1.7.x de prestashop<\/p>\n\n\n\n

Principe de fonctionnement g\u00e9n\u00e9ral<\/h3>\n\n\n\n

Dans Prestashop les activations ou prix des transporteurs sont d\u00e9finis par zones g\u00e9ographiques :
Celles-ci sont visibles dans l’administration via \u00ab\u00a0International \/ Zones G\u00e9ographique\u00a0\u00bb<\/p>\n\n\n\n

\"\"<\/a>
Zones de livraisons <\/figcaption><\/figure>\n\n\n\n

Il est ensuite possible de voir la corr\u00e9lation entre les 2 lorsque nous allons \u00e9diter un transporteur.
Via \u00ab\u00a0Livraison \/ Transporteur\u00a0\u00bb , \u00e9diter un transporteur et dans l’onglet \u00ab\u00a0Destination d’exp\u00e9ditions et co\u00fbts\u00a0\u00bb
Par exemple le transporteur de la capture ci-dessous est actif uniquement pour les zones \u00ab\u00a0Europe\u00a0\u00bb et \u00ab\u00a0Am\u00e9rique du Nord\u00a0\u00bb<\/p>\n\n\n\n

\"\"<\/a>
Zones de livraison sur un transporteur<\/figcaption><\/figure>\n\n\n\n

Comme le nom des zones est tr\u00e8s explicite on peut ais\u00e9ment comprendre que les clients habitant en France<\/strong> feront automatiquement partie de la zone Europe ,<\/strong> et c’est bien le cas dans la configuration de prestashop<\/p>\n

 <\/p>\n\n\n\n

\"\"<\/a>
La France est bien en zone Europe<\/figcaption><\/figure>\n\n\n\n

Cependant il existe une possibilit\u00e9 disponible uniquement via le code qui est d’assigner automatiquement une zone \u00e0 une adresse en fonction de ses param\u00e8tres.
Cette fonctionnalit\u00e9 est g\u00e9r\u00e9e via le hook actionGetIDZoneByAddressID<\/strong><\/p>\n\n\n\n

Mise en \u0153uvre concr\u00e8te<\/h3>\n\n\n\n

Maintenant que le fonctionnement global est connu c’est parti pour un exemple concret d’impl\u00e9mentation.
L’objectif va \u00eatre le suivant :
Cr\u00e9er un nouveau transporteur \u00ab\u00a0Clic and collect\u00a0\u00bb et le rendre disponible uniquement pour les clients qui habitent dans dans le bas-rhin <\/strong>( donc un code postal qui commence par 67 )<\/p>\n\n\n\n

Pour commencer il faut donc cr\u00e9er :
– une nouvelle zone g\u00e9ographique \u00ab\u00a0Click and Collect\u00a0\u00bb en allant dans le menu \u00ab\u00a0Internationnal \/ Zones g\u00e9ographique\u00a0\u00bb et r\u00e9cup\u00e9rer son identifiant technique qu’on va r\u00e9utiliser plus tard
– cr\u00e9er un nouveau transporteur \u00ab\u00a0Click and collect\u00a0\u00bb qui est uniquement actif sur la zone \u00ab\u00a0click and collect\u00a0\u00bb<\/p>\n\n\n\n

\"\"<\/a><\/figure>\n\n\n\n

C’est parti ensuite pour la cr\u00e9ation d’un module qui va g\u00e9rer le rattachement de la zone.
Nous allons l\u2019appeler hh_clicandcollectdelivery

<\/strong>Pour ce module nous allons nous concentrer sur l\u2019essentiel uniquement, toute la logique sera cod\u00e9e en dur pour expliquer le principe.
Le point  essentiel est l’impl\u00e9mentation du hook actionGetIDZoneByAddressID<\/strong> que je d\u00e9taille ici<\/p>\n\n\n\n

   \n     \/**\n     * R\u00e9cup\u00e9ration de l'identifiant de la zone\n     * @see classes\/Address.php:282\n     * @param array $params\n     * @return mixed\n     *\/\n    public function hookActionGetIDZoneByAddressID($params)\n    {\n\t\/\/Chargement de l'objet adresse \u00e0 partir de son identifiant\n\t$address = new Address($params['id_address']);\n\t\t\n        \/\/Identifiant de la zone g\u00e9ographique clic and collect\n        $id_zone = 9;\n        \n        \/\/Dans mon cas je veux que la zone soit renvoy\u00e9e uniquement pour les codes postaux du type\n        \/\/ 67xxx (bas-rhin )    \n\tif (preg_match('#^67[0-9]{3}$#', $address->postcode)) {\n\t\t\treturn $id_zone; \/\/L'important est de retourner la zone ici\n\t}\n\t\t\n\t\/\/Par contre ici vous avez acc\u00e8s \u00e0 l'ensemble des champs de l'adresse\n\t\/\/Du coup vous pouvez conditionner la zone \u00e0 n'importe quel champ\n\t\/\/Par exemple si la ville (city = 'Paris', le nom  = 'Herv\u00e9' ) ect ...\n       \n    }\n<\/pre>\n\n\n\n
Si on test en tant que client on peut voir que c’est bien fonctionnel :
Code postal qui commence par 67000
(Note : Comme vous le voyez les autres transporteurs ne sont pas disponibles , il faut penser \u00e0 les activer \u00e9galement pour cette nouvelle zone )<\/p>\n\n\n\n
\"\"<\/a><\/figure>\n\n\n\n
Code postal qui commence par autre chose , seuls les autres transporteurs sont affich\u00e9s.<\/p>\n\n\n\n
\"\"<\/a><\/figure>\n\n\n\n
Module basique<\/h3>\n\n\n\n
Voici donc le code le plus basique<\/strong> du module qui permets de g\u00e9rer \u00e7a.<\/p>\n\n\n\n
   \n    class Hh_clicandcollectdelivery extends Module\n{\n\n    public function __construct()\n    {\n        $this->name = 'hh_clicandcollectdelivery';\n        $this->tab = 'others';\n        $this->version = '0.1.0';\n        $this->author = 'hhennes';\n        $this->bootstrap = true;\n        parent::__construct();\n\n        $this->displayName = $this->l('Hh Clic and collect delivery');\n        $this->description = $this->l('Allow clic and collect to certain postcode');\n    }\n\n    \/**\n     * Installation du module\n     * @return bool\n     *\/\n    public function install()\n    {\n        if (\n            !parent::install()\n            || !$this->registerHook('actionGetIDZoneByAddressID')\n        ) {\n            return false;\n        }\n\n        return true;\n    } \n\n    \/**\n     * R\u00e9cup\u00e9ration de l'identifiant de la zone\n     * @see classes\/Address.php:282\n     * @param array $params\n     * @return mixed\n     *\/\n    public function hookActionGetIDZoneByAddressID($params)\n    {\n\t\/\/Chargement de l'objet adresse \u00e0 partir de son identifiant\n\t$address = new Address($params['id_address']);\n\t\t\n        \/\/Identifiant de la zone g\u00e9ographique clic and collect\n        $id_zone = 9;\n        \n        \/\/Dans mon cas je veux que la zone soit renvoy\u00e9e uniquement pour les codes postaux du type\n        \/\/ 67xxx (bas-rhin )    \n\tif (preg_match('#^67[0-9]{3}$#', $address->postcode)) {\n\t\t\treturn $id_zone; \/\/L'important est de retourner la zone ici\n\t}\n\t\t\n\t\/\/Par contre ici vous avez acc\u00e8s \u00e0 l'ensemble des champs de l'adresse\n\t\/\/Du coup vous pouvez conditionner la zone \u00e0 n'importe quel champ\n\t\/\/Par exemple si la ville (city = 'Paris', le nom  = 'Herv\u00e9' ) ect ...\n       \n    }\n}\n<\/pre>\n\n\n\n
Module plus complet<\/h3>\n\n\n\n
C’est fonctionnel mais j’en conviens ce n’est pas vraiment adapt\u00e9 \u00e0 une utilisation directement en production.
Car un peu trop manuel, vous pouvez donc t\u00e9l\u00e9charger ci-dessous un module un peu plus complet qui va ajouter les fonctionnalit\u00e9s suivantes :<\/p>\n