Prestashop

Logo PrestashopPrestashop est une solution e-commerce facile et pratique à mettre en œuvre.
C’est également une plateforme sur laquelle je travaille quotidiennement depuis presque 10 ans.
A travers une centaines d’articles écrits durant cette période, j’ai creusé de nombreuses problématiques liées à cette solution, des versions 1.4.x jusqu’aux dernières versions 1.7
J’ai également partagé des canevas de modules et creusé des points spécifiques de la solution, essentiellement une vision orientée module ( ç’est à dire comment interagir le plus simplement avec Prestashop via un module )

Prestashop : Imports des clients avec le webservice

Après la mise en place de la structure globale pour utiliser les webservices, nous allons à présent importer les clients.

La structure du fichier sera la suivante.

structure-csv

L’email client étant la clé unique.

Pour gérer l’import nous allons créer une classe spécifique qui va hériter de la classe HhPrestashopWebservice
Celle-ci permettra les opérations basiques : Ajouter, modifier, supprimer un utilisateur prestashop via le webservice.

Voici son code commenté :

 /**
 * Gestion webservice des clients
 *
 * @author hhennes <[email protected]>
 */
class HhCustomerWs extends HhPrestashopWebservice {
 
    protected $_resource = 'customers';
 
    /**
     * Création d'un client via le webservice
     * @param array $datas : données du client
     */
    public function createCustomer($datas) {
 
        $schema = $this->getEmptyObject();
        $customerAttributes = $schema->children()->children();
 
        //Parcours des attributs du client, si une data existe on l'associe
        foreach ($customerAttributes as $attribute => $values) {
 
            if (array_key_exists($attribute, $datas))
                $schema->children()->children()->{$attribute} = $datas[$attribute];
 
            //Si le champ est nécessaire et qu'il n'est pas associé cela ne fonctionnera pas, on envoie une exception
            if ($schema->children()->children()->{$attribute}->attributes()->required && !

Prestashop : Imports des clients avec le webservice Lire la suite »

Prestashop : Mise en place webservices

Voici donc le début de notre série sur les webservices prestashop ( Sommaire )

Pour cette série nous allons écrire les appels au webservice via des scripts php, basé sur la librairie fournie par Prestahop  : https://github.com/PrestaShop/PrestaShop-webservice-lib

Le projet global est disponible sur github : https://github.com/nenes25/prestashop_hhwebservices

Pour ce premier article je vais vous détailler le mode de fonctionnement de l’import

Structure globale et installation

La structure du projet sera la suivante :

Structure projet

Nos classes spécifiques de gestion seront dans le dossier « classes », et les fichiers d’imports dans le dossier « files/imports ».
L’appel des fonctions se fera via le fichier imports.php

Le module utilise composer pour gérer les dépendances et l’autoload des classes, avant toute chose il est donc nécessaire d’installer le projet via la commande

composer install

Gestion des données de l’import

Pour faciliter la gestion des données de l’import, l’objectif est de récupérer l’ensemble des données à importer sous la forme d’un tableau associatif tel que l’exemple ci-dessous

[0] => Array
        (
            [email] => [email protected]

Prestashop : Mise en place webservices Lire la suite »

Prestashop : Synchronisez vos données avec les webservices

Si vous souhaitez synchroniser les données de votre ERP avec votre site prestashop, la plateforme propose des webservices, qui permettent cela, nous allons voir tout cela dans une nouvelle série d’articles.

Pour cette série nous allons écrire les appels au webservice via des scripts php, basé sur la librairie fournie par Prestahop  : https://github.com/PrestaShop/PrestaShop-webservice-lib .

Le postulat global étant que les données à importer / exporter seront stockées au format csv

Les étapes suivantes seront détaillées :

Les liens seront mis à jour au fur et à mesure de l’avancée des articles 🙂…

Prestashop : Synchronisez vos données avec les webservices Lire la suite »

Prestashop : Envoyer des fichiers lors de la création du compte client

Lors de la création d’un compte client sur votre site, vous aurez peut-être besoin de récupérer des fichiers du client pour justifier certaines situations ( justificatif de situation , cv, ect … )
Nous allons voir comment faire pour récupérer des fichiers lors de la création du compte.

Edit : Le fonctionnement change avec prestashop 1.7 , consulter l’article pour le tutoriel actualisé : Prestashop 1.7 : Ajouter des champs clients

Avant toute chose il va falloir modifier le template du formulaire de création de compte.
Et trouver la ligne : ( sur la version 1.6.1.4 : ligne 428 ) dans le fichier authentication.tpl de votre thème.

<form action="{$link->getPageLink('authentication', true)|escape:'html':'UTF-8'}" method="post" id="account-creation_form" class="std box">

et rajouter l’attribut : enctype= »multipart/form-data »

Ce qui donne le code suivant :

<form action="{$link->getPageLink('authentication', true)|escape:'html':'UTF-8'}" method="post" id="account-creation_form" class="std box" enctype="multipart/form-data">

Ceci permettra de gérer les envois de fichiers depuis le formulaire.…

Prestashop : Envoyer des fichiers lors de la création du compte client Lire la suite »

Prestashop : Ajouter vos traductions dans les fichiers de traductions

J’ai encore rencontré récemment le problème bien connus des utilisateurs de prestashop qui souhaitent changer les traductions depuis le back-office.

L’erreur d’affichage des champs de formulaire « max_input_vars » qui empeche d’afficher les traductions, et donc de les modifier depuis l’administration.

J’avais apporté une solution il y’a plusieurs années pour corriger ce problème sur un hébergement mutualisé ovh : Prestashop problème max_input_vars en hébergement mutualisé chez ovh ( Elle ne doit plus fonctionner malheureusement )

Dans le cas de ceux qui disposent d’un serveur dédié avec les accès nécessaires, la modification du php.ini corrige rapidement ce problème.

Pour mon problème j’avais uniquement quelques traductions à réaliser, l’ajout des informations de traductions directement dans les fichiers de traductions est donc une solution envisageable.

Le fonctionnement est assez simple , la clé de traduction est construite de la manière suivante

<{nomModule}nomTheme>nomFichier_md5(cleTraduction)

Cette clé de traduction est ajoutée dans la variable $_MODULE , qui contient toutes les traductions.…

Prestashop : Ajouter vos traductions dans les fichiers de traductions Lire la suite »

Prestashop : Ajouter des champs au formulaire de contact

C’est une demande assez régulière , comment ajouter facilement des nouveaux champs sur le formulaire de contact prestashop ?
Avec le code de base il n’est pas évident de rajouter des champs car il n’existe aucun hook particulier qui permets d’utiliser un module sur cette page.

J’ai donc réalisé un nouveau module qui va permettre de rajouter des éléments de manière plus simple.
Ces nouveaux champs seront ensuite envoyés dans l’email récapitulatif au marchand.
( C’est une version basique de preuve de concept qui peut encore grandement évoluer 🙂 , testé uniquement sur la dernière version 1.6.1.4)

Vous pouvez le télécharger depuis github : https://github.com/nenes25/prestashop_contactformfields

Cependant il est pour l’instant nécessaire de comprendre son fonctionnement, et d’éditer du code pour pouvoir ajouter les nouveaux champs.

Avant d’installer le module , il faut éditer le fichier contact-form.tpl de votre thème.
Rajouter le code suivant à l’endroit ou vous souhaitez que les nouveaux champs apparaissent

{* Nouveaux champs pour le formulaire de contact : ce code créé un nouveau hook pour les modules *}
{hook h='contactFormAdditionnalFields'}

Vous pouvez à présent installer le module et sur la page du formulaire de contact vous devez avoir le visuel suivant :

Nouveaux champs

Ajout visuel des nouveaux champs

Le visuel et les noms des nouveaux champs sont éditables dans le fichier

contactformfields/views/templates/hook/hookContactFormAdditionnalFields.tpl…

Prestashop : Ajouter des champs au formulaire de contact Lire la suite »

Prestashop : Ajouter automatiquement les clients à un groupe lors de l’inscription

Afin de segmenter vos clients dans prestashop, il est utile de les ranger dans des groupes clients spécifique.
Ce nouveau module Prestashop, vous permettra d’assigner automatiquement les clients aux groupes souhaités dès leur inscription en fonction de paramètres prédéfinis.

Pour l’installation, comme pour tous mes modules hébergés sur github, l’installation par zip ne fonctionne pas.
Il est nécessaire de déposer le dossier « customerautogroups » , dans le dossier « modules » de votre site via FTP.

Une fois le module installé, un nouvel onglet est disponible dans l’administration, dans « client/ Customer Auto Groups »

Autogroups menu

Vous pouvez ensuite accéder à la liste des règles et créer vos nouvelles règles.

Liste règles auto groupes

 

Les règles sont cumulables et priorisables.

Voici par exemple le formulaire d’édition d’une règle, qui ajouter automatiquement tous les client  qui sont des hommes ( çad dont le champ Client « id_gender » = 1 ) dans un groupe client « Hommes »

customerautogroups

Les conditions possibles sont liées à tous les champs des classes Customer et Address.…

Prestashop : Ajouter automatiquement les clients à un groupe lors de l’inscription Lire la suite »

Prestashop : Ajouter des champs dans l’édition client

En complément de mon précédent article, Prestashop : Ajouter des champs à l’inscription , voici comment rajouter des champs sur le formulaire d’édition d’un client. ( IdentityController )

L’exemple reste le même, à savoir que le client peut choisir son groupe client.
J’ai retiré le code qui était relatif à l’ajout des champs sur le formulaire d’inscription pour plus de clareté, mais les 2 peuvent bien évidemment cohabiter.

La procédure est un peu plus complexe car elle nécessite la création d’un nouveau hook pour pouvoir sauvegarder les données souhaitées.
Le module va être greffé sur le hook prestashop displayCustomerIdentityForm ( attention il n’existe qu’à partir de la version 1.6.0.11 ), et nous allons créer un nouveau hook actionCustomerIdentityFormSubmit

Voici le code du module

<?php
class hhregistration extends Module {
 
    public function __construct() {
        $this->name = 'hhregistration';
        $this->tab = 'hhennes';
        $this->author = 'hhennes';
        $this->version = '0.1.0';
        $this->need_instance = 0;
 
        parent::__construct();
 
        $this->displayName = $this->l('HH Registration');
        $this->description = $this->l('Sample module which show how to add fields to identity controller');
    }
 
    /**
     * Installation du module : Installation Standard + greffe sur les hooks nécessaires
     * @return boolean
     */
    public function install() {
        if (
                !

Prestashop : Ajouter des champs dans l’édition client Lire la suite »

Prestashop : Utiliser l’arbre des catégories dans le formulaire d’administration d’un module

Si vous souhaitez utiliser l’arbre des catégories de Prestashop dans le formulaire d’administration d’un module.

Voici un petit snippet qui vous permettra de le faire facilement avec Prestashop 1.6 et supérieurs lors de la déclaration des paramètres de votre formulaires :
( Cette solution est nativement implémentée )

 $fields_form = array(
            'form' => array(
                //Entête du formulaire
                'legend' => array(
                    'title' => $this->l('Form Name'),
                    'icon' => 'icon-cogs'
                ),
                //Champs du formulaire
                'input' => array(
                    array(
                        'type' => 'categories', //Type de champ à mettre à catégories
                        'label' => $this->l('Category'),
                        'name' => 'category_tree',
                        'desc' => $this->l('Select category to display'),
                        'required' => true,
                        'empty_message' => $this->l('Please fill the category id'),
                        //Informations spécifiques de l'arbre
                        'tree' => array(
                            'id' => 'category_tree',
                            'selected_categories' => $selected_categories) // Catégorie sélectionnées ( variable array )
                        ),
                    ),  
                ),
                //Boutons de soumission du formulaire
                'submit' => array(
                    'title' => $this->l('Save'),
                    'class' => 'button btn btn-default pull-right',
                )
            ),
        );

Le rendu obtenu est ensuite le suivant :

Catégories admin form prestashop

Prestashop : Utiliser l’arbre des catégories dans le formulaire d’administration d’un module Lire la suite »

Optimiser le développement de modules Prestashop : Tester fonctionnellement vos modules avec Phpunit et Selenium

Cet article fait partie de la série : Optimiser le développement de modules Prestashop

  1. Mise en place de l’environnement de développement
  2. Industrialiser l’installation de Prestashop et des modules
  3. Tester fonctionnellement vos modules avec Phpunit et Selenium
  4. Éviter les régressions avec l’intégration continue

3ème étape de notre série sur l’optimisation du développement de module prestashop.

Après la configuration de l’environnement et l’industrialisation des installations qui ont permis de mettre en place la structure de développement, il est temps de passer aux tests fonctionnels de nos modules.
Ceci nous permettra de vérifier que le comportement utilisateur est bien celui attendu.

Configuration de l’environnement pour exécuter les tests

Pour cela nous allons déjà installer les programmes suivants sur le serveur

  • Xvfb : permettra de lancer une application graphique sans serveur X
  • Firefox : navigateur
  • Java : JDk

Pour installer ces éléments saisissez les commandes suivantes

sudo apt-get install xvfb
sudo apt-get install firefox
sudo apt-get install default-jdk

Nous allons ensuite installer également phpunit et selenium, cependant ces éléments peuvent être installé de manière globale ou via composer

Installation globale

PhpUnit

#Téléchargement de phpunit
wget https://phar.phpunit.de

Optimiser le développement de modules Prestashop : Tester fonctionnellement vos modules avec Phpunit et Selenium Lire la suite »