Prestashop | Hervé Hennes

Prestashop : Restreindre un transporteur par code postal

22 avril 2021 30 mars 2022 / Par herve / Prestashop

On pourrait également compléter le titre également par : « Ville / Nom … «

C’est une demande qui revient assez régulièrement et qui est d’autant plus d’actualité avec le confinement actuel.
Comment restreindre un transporteur à un certain code postal ?

Ceci permets par exemple de créer un transporteur de clic and collect délimité à certains codes postaux.

C’est très facile à faire dans Prestashop, mais cela nécessite la création ou l’achat d’un module.

Nous allons voir comment procéder techniquement pour faire cela.
Ce tutoriel est valide à la fois pour les versions 1.6.x et 1.7.x de prestashop

Principe de fonctionnement général

Dans Prestashop les activations ou prix des transporteurs sont définis par zones géographiques :
Celles-ci sont visibles dans l’administration via « International / Zones Géographique »

Il est ensuite possible de voir la corrélation entre les 2 lorsque nous allons éditer un transporteur.
Via « Livraison / Transporteur » , éditer un transporteur et dans l’onglet « Destination d’expéditions et coûts »
Par exemple le transporteur de la capture ci-dessous est actif uniquement pour les zones « Europe » et « Amérique du Nord »

Comme le nom des zones est très explicite on peut aisément comprendre que les clients habitant en France feront automatiquement partie de la zone Europe , et c’est bien le cas dans la configuration de prestashop

Cependant il existe une possibilité disponible uniquement via le code qui est d’assigner automatiquement une zone à une adresse en fonction de ses paramètres.…

24 commentaires

Prestashop : Ajouter un captcha sur l’inscription à la newsletter

15 mars 2021 24 avril 2021 / Par herve / Prestashop

Ces derniers mois ( voir depuis plus longtemps :/ ) les spams se sont attaqués en masse au formulaire d’inscription à la newsletter sur Prestashop.

J’ai déjà fait un module de captcha qui permets de régler le problème des spams sur le formulaire de contact et la création des clients depuis plusieurs années.
La demande de pouvoir rajouter un captcha sur la newsletter était déjà récurrente, mais il n’y avais pas de solution simple et rapide pour le mettre en place.

La bonne nouvelle est que depuis la sortie de la version 2.6.0 du module ps_emailsubscription grâce à une pull request de l’inévitable Jean-François Viguier ( https://github.com/PrestaShop/ps_emailsubscription/pull/49/files )

Il est possible via des nouveaux hooks d’implémenter facilement un captcha sur l’inscription newsletter.

Le hook à utiliser est displayNewsletterRegistration et il est implémenté dans le fichier modules/ps_emailsubscription/views/templates/hook/ps_emailsubscription.tpl

<div class="email_subscription block_newsletter" id="blockEmailSubscription_{$hookName}">
  <h4>{l s='Newsletter' d='Modules.Emailsubscription.Shop'}</h4>
  {if $msg}
    <p class="notification {if $nw_error}notification-error{else}notification-success{/if}">{$msg}</p>
  {/if}
  <form action="{$urls.current_url}#blockEmailSubscription_{$hookName}"

…

14 commentaires

Prestashop : gérer les images produits via l’api

12 mars 2021 14 février 2022 / Par herve / Prestashop

En compléments des informations déjà disponible sur la documentation développeur de prestashop sur la gestion globale des images : https://devdocs.prestashop.com/1.7/webservice/tutorials/advanced-use/image-management/
Cet article détaille brièvement la gestion des images des produits via l’api sous Prestashop.

Les tests ont été fait sur une version 1.7.6.x de prestashop mais l’api ayant assez peu bougé cela doit être fonctionnel sans doute sur les versions 1.6 également.

Le point essentiel à retenir dans les api étant qu’une url peut avoir un comportement différent en fonction de la méthode par laquelle elle est appellée ( GET / POST / PUT )

Je pars du principe que les accès nécessaire à l’api sont déjà définis, et la gestion de l’api est effectuée via la librairie proposée par Prestashop en php ( cf. https://devdocs.prestashop.com/1.7/webservice/tutorials/prestashop-webservice-lib/ )

Pour mon exemple d’illustration je me sers d’une version démo de prestahop avec les produits de base.
Dont l’url sera http://www.prestashop.local/tests/1769/
Et on va jouer avec l’identifiant produit 19 , le « mug personnalisable »

Les appels webservice qui seront exécuté via la lib Prestashop seront wrappés dans le code suivant
Et je rajoute également une fonction qui va permettre de simplifier les appels à la librairie curl .…

Pas de commentaires

Prestashop : gérer les emails dans vos modules

1 février 2021 24 avril 2021 / Par herve / Prestashop

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ûr, mais nous verrons ensuite qu’il est très facile d’interagir avec les emails systèmes via les hooks.

Ce tutoriel s’applique à la version 1.7 de Prestashop, certains hooks n’existent pas dans la version 1.6 dont le hook hookActionEmailSendBefore , il reste cependant assez facile de les implémenter manuellement en surchargeant la classe Mail

Pour illustrer et tester tout ça nous allons passer par la création d’un module de POC hh_demoemails

L’archive sera disponible en fin d’article, mais je précise bien que c’est un module de démo et d’apprentissage et pas du tout en module destiné à être mis en production 😉

Fonctionnement général

La gestion de l’envoi dans Prestashop est relativement basique car elle est centralisée dans une seule fonction qui est la fonction send de la classe Mail voici ses paramètres, la signature de la fonction est relativement explicite

/**
     * Send Email.

…

14 commentaires

Prestashop : Ajout des conditions à valider dans le tunnel de commande

11 décembre 2020 1 février 2021 / Par herve / Prestashop

Petite découverte de la semaine d’une possibilité relativement pratique d’ajouter des conditions à valider dans le tunnel de commande.

La bonne nouvelle c’est que c’est très facile à faire via un module puisqu’il existe un hook pour cela 🙂
Voyons donc cela dans un module hhcgv dont voici le code

<?php
if (!defined('_PS_VERSION_')) {
    exit;
}
 
//Attention à bien include ceci
use PrestaShop\PrestaShop\Core\Checkout\TermsAndConditions;
 
class Hhcgv extends Module
{
 
    public function __construct()
    {
        $this->name = 'hhcgv';
        $this->tab = 'others';
        $this->version = '0.1.0';
        $this->author = 'hhennes';
        $this->bootstrap = true;
        parent::__construct();
 
        $this->displayName = $this->l('Module de demo cgv');
        $this->description = $this->l('Ajout de cgv personnalisées');
    }
 
    /**
     * Installation du module
     * @return bool
     */
    public function install()
    {
        if (
            !

…

6 commentaires

Prestashop : Ajout rapide des droits pour un groupe utilisateur

10 novembre 2020 10 novembre 2020 / Par herve / Prestashop

Lors de la création d’un nouveau groupe client,
par défaut celui-ci n’aura aucun droit de visualisation sur l’ensemble des catégories du site.

Cela peut poser problème dans le cas ou c’est le seul groupe d’un client.
( La bonne pratique est de laisser par défaut tous les clients dans le groupe « visiteur » également. )

Dans ce cas on obtient une belle page d’erreur lorsqu’on souhaite accéder à une catégorie sur laquelle le groupe n’a pas les droits d’accès

Voici une petite requête qui permettra de corriger cela facilement.
Attention il est nécessaire de récupérer l’identifiant du groupe client à modifier.
Dans mon exemple l’identifiant du groupe « Pro » est 4

INSERT INTO ps_category_group ( SELECT id_category,4 FROM ps_category WHERE id_category NOT IN ( SELECT id_category FROM ps_category_group WHERE id_group = 4 ))

…

2 commentaires

Prestashop : bloquer les mises à jour de modules dans l’administration

12 octobre 2020 29 octobre 2022 / Par herve / Prestashop, Trucs et astuces

Présentation du problème et solution

C’est un comportement bien connu et assez embêtant auquel je m’attaque aujourd’hui.

Qui n’a jamais pesté d’avoir mis à jour un module dans le back office de Prestashop alors qu’on souhaitait uniquement le configurer ..

Par défaut lorsqu’une mise à jour d’un module est disponible, c’est l’action « Upgrade » qui est l’action par défaut.

Un clic trop rapide et on se retrouve avec une version non testée et donc potentiellement des erreurs sur son site.

J’ai donc créé un petit module qui permets de désactiver l’action du bouton de mise à jour et qui affiche un autre message à la place.

Il est possible de configurer le comportement ( normal ou bloqué ) directement depuis la configuration du module.

Fonctionnement technique

Pour gérer cela nous allons créer un module hh_modulesupdater

Ce module va utiliser la possibilité de surcharger les templates symfony du core en reprenant simplement leur chemin dans un module.

Nous allons donc créer un fichier :
modules/hh_modulesupdater/views/PrestaShop/Admin/Module/Includes/action_button.html.twig…

6 commentaires

Prestashop : gagnez du temps lors la personnalisation des fichiers pdf ( factures / livraisons … )

13 juillet 2020 8 avril 2021 / Par herve / Prestashop

Une petite note rapide pour donner et historiser une astuce bien pratique dans le cas ou vous souhaitez faire des modifications sur les fichiers pdfs générés par Prestashop dans l’administration.

Ceci concerne tout ceux qui sont générés par le controller : controllers/admin/AdminPdfController.php

Les factures
Les livraisons
Commandes fournisseurs

Par défaut le comportement est que le fichier pdf est téléchargé par le navigateur, ce qui devient relativement pénible lorsque les modifications sont assez lourdes et qu’on doit télécharger pleins de fois le fichier pour voir le résultat.

Pour forcer l’affichage du pdf dans le navigateur il vous suffit de modifier la fonction generatePDF du controller controllers/admin/AdminPdfController.php et de rajouter l’option « I » dans l’appel à la fonction render

public function generatePDF($object, $template)
    {
        $pdf = new PDF($object, $template, Context::getContext()->smarty);
        $pdf->render('I'); //Changement de code ici
    }

Le contenu du fichier pdf sera ensuite affiché directement dans le navigateur ce qui fera gagner un temps précieux dans la visualisation des modifications pdf 🙂

Cette astuce a été testée sur une 1.7.4 et une 1.7.6.x…

2 commentaires

Prestashop : Utilisation avancée des AdminController – Les options

8 juin 2020 8 juin 2020 / Par herve / Prestashop

Cet article fait partie d’une série d’articles qui présentent les fonctionnalités avancées disponibles dans un controller d’administration Prestashop. ( adminController )
Les exemples sont réalisés dans le cadre d’un module mais s’appliquent également à tous les anciens controllers de l’administration qui n’utilisent pas encore l’infrastructure symfony
Vous pouvez-consulter les autres articles de la série :

Dans cet article nous allons à présent nous intéresser à la gestion des options de notre controller et voir les cas suivants :

Ensemble des cas d’affichage d’options
Traitement spécifique d’une option

Les options sont définies dans la fonction __construct() du controller
Voici un code qui génère une grande partie des cas avec les commentaires explicatifs de leur fonctionnement.

Attention car les valeurs des options seront stockées dans la table globale de configuration de Prestashop.
Pensez donc à bien supprimer ces informations lors de la désinstallation de votre module.…

Pas de commentaires

Prestashop : utilisation avancée des AdminController – Les formulaires

8 juin 2020 1 juillet 2020 / Par herve / Prestashop

Cet article est encore d’écriture et présente les informations spécifiques aux formulaires

Informations générales

Les formulaires dans les controllers d’administration sont gérés par la classe HelperForm dont le code complet est visible ici :

https://github.com/PrestaShop/PrestaShop/blob/develop/classes/helper/HelperForm.php

Le rendu est ensuite affiché à partir du template : admin-dir/themes/default/template/helpers/form/form.tpl

Les types de champs possibles

La bonne nouvelle et qu’il existe une page de démonstration de l’ensemble des possibilités de ces champs dans tous les sites prestashop 🙂

Pour y accéder il faut aller dans votre administration et saisir l’adresse :

http://www.votre-site.comt/admin-dir/index.php?controller=…

2 commentaires