Ce livre sur PrestaShop (en version 8.0.0 au moment de l’écriture) s’adresse aux développeurs ayant des connaissances en PHP. Il a pour objectif de vous plonger au cœur de ce CMS e-commerce afin d’acquérir les notions nécessaires au développement de nouvelles fonctionnalités en explorant des concepts souvent méconnus. La connaissance du framework Symfony utilisé par PrestaShop (en version 4.4) est un plus mais n’est pas requise. Une brève introduction à ses composants est réalisée dès que nécessaire.

Vous apprenez à concevoir une boutique e-commerce sous PrestaShop sous tous ses aspects – excepté la gestion du catalogue – en explorant l’architecture du système, la personnalisation graphique des éléments d’affichage (édition de thèmes, modification de fichiers PDF et emails) ainsi que la conception de fonctionnalités par le biais de modules. En fin de lecture, vous serez également en mesure de modifier l’existant du système pour le faire correspondre à votre besoin.

PrestaShop reposant sur un système hybride – subtil mélange entre son propre framework (le legacy) et l’utilisation de Symfony (le moderne) – la présentation et l’exploration de l’ensemble des concepts utiles au développement et à la personnalisation seront étudiés dans un chapitre dédié.

Enfin, concept clé de PrestaShop oblige, un chapitre concernant la conception de modules aura pour objectif de vous guider tout au long de la conception d’une nouvelle fonctionnalité : un blog. Vous serez ainsi amené à développer une extension en utilisant l’ensemble des concepts legacy que vous ferez évoluer vers la modernité en étant guidé pas à pas tout au long du chapitre.

Des liens vers le guide de référence ainsi que le champ lexical utilisé donneront les clés nécessaires pour approfondir les connaissances sur un sujet précis.
Des éléments complémentaires sont en téléchargement sur le site www.editions-eni.fr.


Quizinclus dans
la version en ligne !

• Testez vos connaissances à l'issue de chaque chapitre
• Validez vos acquis

Téléchargements

• Des fichiers complémentaires (1 193 Ko)

Introduction

1. Avant-propos
2. À qui s'adresse cet ouvrage ?
3. Prérequis
4. Objectif du livre
5. Architecture
   1. 1. Modèle MVC
   2. 2. Smarty
   3. 3. Symfony
   4. 4. Twig
6. Conception dirigée par le domaine
   1. 1. Préambule
   2. 2. Les domaines de services (Domain services)
   3. 3. Data Transfer Objects
   4. 4. Les objets-valeur (Value Objects)
   5. 5. Exceptions de domaine (Domain Exceptions)
   6. 6. CQRS
      1. a. Validation des données
      2. b. Commandes (Command)
      3. c. Gestionnaire de commande (CommandHandler)
      4. d. Requête (Query)
      5. e. Gestionnaire de requête (QueryHandler)
      6. f. Bus de commandes
      7. g. Outils de développement
      8. h. Utilisation au sein des modules
7. Installer PrestaShop
   1. 1. Prérequis
      1. a. Serveur
      2. b. Version de PHP
      3. c. Extensions
      4. d. Réglages
      5. e. Outil de vérification automatique
   2. 2. Manuellement
      1. a. Via une version packagée
      2. b. Via GitHub
   3. 3. En ligne de commande
      1. a. Via Composer
      2. b. Via l’interface en ligne de commande (CLI)
   4. 4. Création d’une release
8. Mode développeur
   1. 1. Préambule
   2. 2. Activation du mode
   3. 3. La fonction dump() et dd()
      1. a. Utilisation dans les fichiers Twig
   4. 4. Le cache
   5. 5. Console Smarty
   6. 6. Le profiler
   7. 7. Les avertissements de compatibilité
9. Mettre à jour PrestaShop
   1. 1. Manuellement
   2. 2. Automatique via le module 1-Clik Upgrade
   3. 3. En ligne de commande via le module 1-Click Upgrade
      1. a. Mise à jour de la configuration
      2. b. Effectuer la mise à jour
      3. c. Effectuer un retour en arrière
10. Le back-office
    1. 1. Informations
    2. 2. Paramètres généraux
    3. 3. Mode multiboutique
    4. 4. Mode maintenance
    5. 5. Performances
       1. a. Cache
       2. b. Mode debug
    6. 6. Employés et profils
11. Les fichiers de configuration

Au cœur de PrestaShop

1. Introduction
2. Conventions de code
   1. 1. Introduction
   2. 2. Conventions génériques
   3. 3. PHP
      1. a. Documenter son code
      2. b. Normes utilisées
      3. c. Types stricts
      4. d. Déprécier une portion de code
   4. 4. JavaScript
   5. 5. HTML et CSS
3. Base de données
   1. 1. Structure
   2. 2. Classe Db
      1. a. Connexion à la base de données
      2. b. Utilisation d’un serveur tiers
      3. c. Déclaration d’un serveur tiers
      4. d. Prévenir de l’injection SQL
      5. e. Constante _DB_PREFIX_
      6. f. Méthode execute()
      7. g. Méthode executeS()
      8. h. Méthode Insert_ID()
      9. i. Méthode Affected_Rows()
      10. j. Méthode getRow()
      11. k. Méthode getValue()
      12. l. Méthode numRows()
      13. m. Méthode nextRow()
      14. n. Méthode insert()
      15. o. Méthode update()
      16. p. Méthode delete()
   3. 3. Classe DbQuery
      1. a. Introduction
      2. b. Type
      3. c. Clause SELECT
      4. d. Clause FROM
      5. e. Jointures
      6. f. Clause WHERE
      7. g. Clause ORDER
      8. h. Clause GROUP BY
      9. i. Clause HAVING
      10. j. Limites
   4. 4. Classe ObjectModel
      1. a. Définir la ressource
      2. b. Gestion de la ressource
      3. c. La suppression douce (Soft Delete)
      4. d. Gestion de l’image associée
      5. e. Hooks dynamiques
4. Table des configurations
   1. 1. Utilisation
      1. a. Lire une configuration
      2. b. Enregistrer une configuration
      3. c. Supprimer une configuration
      4. d. Utiliser une configuration en tant qu’argument deservice
   2. 2. Multiboutique (ShopConstraint)
5. Notion de contexte (Context)
   1. 1. Introduction
   2. 2. Composition du contexte
   3. 3. Initialisation du contexte
   4. 4. Récupération du contexte
   5. 5. Utilisation du contexte
6. Routes (Dispatcher)
   1. 1. Utilisation des routes
      1. a. En PHP
      2. b. Via TypeScript
      3. c. Via JavaScript
7. Smarty
8. Console
   1. 1. Listes des commandes
   2. 2. Ajouter une commande
   3. 3. Le contexte legacy
9. Hooks
   1. 1. Utilisation au sein d’un template
      1. a. Smarty
      2. b. Twig
   2. 2. Appeler un hook
   3. 3. Événements Symfony
      1. a. Enregistrer un écouteur (listener)
      2. b. Enregistrer une souscription (subscriber)
10. Helpers
    1. 1. HelperCalendar
    2. 2. HelperView
    3. 3. HelperList
       1. a. En-tête avancé
       2. b. Colonnes d’actions
    4. 4. HelperOptions
    5. 5. HelperForm
    6. 6. HelperUploader et HelperImageUploader
    7. 7. HelperKPI et HelperKpiRow
    8. 8. HelperTreeCategories
    9. 9. HelperShop et HelperTreeShops
11. Formulaires (Form)
    1. 1. Types additionels
    2. 2. Aide au rendu
    3. 3. Thème des formulaires
12. Grille (Grid)
    1. 1. Définir une grille
       1. a. Concept
       2. b. Fabrique de conception
       3. c. Fabrique des données
       4. d. Association des fabriques
    2. 2. Hooks associés
13. PrestaShopCollection
14. LazyArray
    1. 1. Introduction
    2. 2. Classe abstraite : AbstractLazyArray
    3. 3. Annotation @arrayAccess
    4. 4. Utilisation des offsets
       1. a. Vérification de l’existence
       2. b. Récupération
       3. c. Modification
       4. d. Suppression
    5. 5. Méthode appendArray()
    6. 6. Autres méthodes
       1. a. appendClosure()
       2. b. getArrayCopy()
       3. c. intersectKey()
    7. 7. Exemples d’utilisation
       1. a. Hook actionPresentProduct
       2. b. Hook actionPresentOrder
15. Composants JavaScript
    1. 1. Utilisation
    2. 2. Composants Grid et GridExtensions

Modules

1. Introduction
2. Organisation des modules
3. Composer
4. Classe principale
   1. 1. Test préalable
   2. 2. Héritage
   3. 3. Constructeur
5. Installation et désinstallation
   1. 1. Méthode install()
   2. 2. Méthode uninstall()
   3. 3. Méthode postInstall()
   4. 4. Modification de la base de données
6. Configuration du module
   1. 1. Effectuer un rendu
   2. 2. Ajout d’un formulaire
   3. 3. Traitement des données
7. Hooks
   1. 1. Préambule
   2. 2. Alias
   3. 3. Enregistrement d’un hook
   4. 4. Implémentation
8. Widgets
9. Modèles
   1. 1. Introduction
   2. 2. Définition du modèle
   3. 3. Multilangue et multiboutique
   4. 4. Doctrine
      1. a. Préambule
      2. b. Définition de l’entité
      3. c. Bien d’autres annotations
      4. d. Création des tables
      5. e. Gestion du multilangue
      6. f. Utilisation
      7. g. Repository
10. Contrôleurs
    1. 1. Introduction
    2. 2. Front-office
       1. a. Définir une route personnalisée
       2. b. Restreindre son accès
       3. c. Placer le contrôleur en maintenance
    3. 3. Back-office (Legacy)
    4. 4. Vue Symfony pour le back-office
       1. a. Introduction
       2. b. Déclarer le contrôleur
       3. c. Définir une route
       4. d. Modifier la méthode getContent()
       5. e. Définir la vue
       6. f. Utiliser l’UI Kit
    5. 5. Back-office (Symfony)
       1. a. Préambule
       2. b. Adaptation du menu
       3. c. Définition
11. Mises à jour
12. Traductions
    1. 1. Préambule
    2. 2. Système legacy
    3. 3. Système moderne
       1. a. Créer le dictionnaire
       2. b. Exporter vos traductions
13. Services
    1. 1. Préambule
    2. 2. Ajouter un service
    3. 3. Utiliser le service
    4. 4. Surcharger un service existant
    5. 5. Décorer un service existant
    6. 6. Utiliser un service dans un contexte legacy
14. Utilisation des grilles
    1. 1. Définition de la grille
    2. 2. Filtres
    3. 3. Récupération des données(QueryBuilder)
    4. 4. Fabrique de grille
    5. 5. Rendu
    6. 6. Utilisation avancée
       1. a. Affichage par défaut (EmptyState)
       2. b. Actions en masse
15. Utilisation des formulaires
    1. 1. Conception du formulaire
16. Commandes de console
    1. 1. Introduction
    2. 2. Définir une commande
    3. 3. Enregistrer une commande
    4. 4. Utiliser une commande
    5. 5. Définition des arguments et options
17. Utilisation du CQRS
    1. 1. Création des commandes
       1. a. Command handler
    2. 2. Dans les formulaires
       1. a. Form Data Handler
       2. b. Form Data Provider
18. Cas particulier
    1. 1. Module de paiement
       1. a. Déclaration d’un module comme module de paiement
       2. b. Ajout des modes de paiement
       3. c. Traitement et retour
       4. d. Mode binaire
       5. e. Mode debug
    2. 2. Module de livraison
       1. a. Préambule
       2. b. Ajout de transporteurs
       3. c. À propos de la référenced’un transporteur
       4. d. Association du module au type de module de transport
       5. e. À propos d’un transporteur sans tranches
       6. f. Hooks et méthodes associées
19. Cas avancés : utilisation de Vue.js
    1. 1. Préambule
    2. 2. Créer son application
    3. 3. Nettoyer son installation
    4. 4. Configuration propre à l’environnement PrestaShop
    5. 5. Afficher l’application
    6. 6. Transmettre des données du PHP à Vue.js
    7. 7. Régler les conflits avec Bootstrap ou l’UIKit embarqué

Personnalisation

1. Traductions
   1. 1. Introduction
      1. a. Les différentes ressources de catalogue
      2. b. Le format XLIFF
   2. 2. Traduction des messages issus du cœur
   3. 3. Traduction d’un thème front-office
   4. 4. Domaines
      1. a. Les domaines existants
      2. b. Les sous-domaines
   5. 5. Utiliser le service Translator
      1. a. Dans un service
      2. b. Dans un contrôleur
      3. c. Dans un template Smarty
      4. d. Dans un template Twig
2. Fichiers PDF
   1. 1. Introduction
   2. 2. Modifier le style global des PDF
   3. 3. Altérer un template PDF existant
   4. 4. Fonctions disponibles
   5. 5. Utilisation des hooks
   6. 6. Concevoir un template PDF
      1. a. Conception du HTMLTemplate
      2. b. Conception avancée
      3. c. Génération du PDF
   7. 7. Cas particulier : ajouter un modèlede facture
3. E-mails
   1. 1. Introduction
   2. 2. Concepts clés
   3. 3. Thème d’e-mails
      1. a. Architecture
      2. b. Variables
      3. c. Traductions
      4. d. Génération
      5. e. Ajout par le biais d’un module
   4. 4. Ajouter un gabarit
      1. a. Déclaration du hook
      2. b. Conception du gabarit
   5. 5. Surcharger un gabarit existant
   6. 6. Ajouter de nouvelles variables
   7. 7. Transformations
      1. a. Définir une transformation
      2. b. Enregistrer une transformation
   8. 8. Convertisseur MJML
      1. a. Préambule
      2. b. Installer le convertisseur
      3. c. Lancer la conversion
   9. 9. Utiliser le SDK
      1. a. Préambule
      2. b. Installer le SDK
      3. c. Lancer la conversion
      4. d. Prise en main

Webservice

1. Introduction
2. Activation du webservice
   1. 1. Préambule
   2. 2. Via l’interface
   3. 3. Via la ligne de commande
3. Création d'une clé d'accès
   1. 1. Via l’interface
   2. 2. En PHP
4. Accéder au webservice
5. Gestion des erreurs
6. Schéma d'une ressource
   1. 1. Schéma blank
   2. 2. Schéma synopsis
7. Format JSON
8. Lire une ressource
9. Paramètres d'URL
   1. 1. Paramètre ps_method
   2. 2. Paramètre display
   3. 3. Paramètre date
   4. 4. Paramètre filter
   5. 5. Paramètre language
   6. 6. Paramètre limit
   7. 7. Paramètre sort
   8. 8. Paramètre sendemail
   9. 9. Paramètres id_shop et id_group_shop
10. Créer une ressource
11. Mettre à jour une ressource
12. Mise à jour partielle d'une ressource
13. Supprimer une ressource
14. Déclarer une nouvelle ressource
15. Gestion des images
16. Gestion des prix spécifiques
17. Gestion de la recherche
18. Gestion des fichiers (attachments)
19. Gestion des configurations
20. Utilisation de la librairie PHP
    1. 1. Installation et configuration
    2. 2. Gestion des erreurs
    3. 3. Lister les ressources disponibles
    4. 4. Traitement du retour
    5. 5. Lire une ressource
    6. 6. Créer une ressource
    7. 7. Mettre à jour une ressource
    8. 8. Supprimer une ressource
    9. 9. Gestion des images et des fichiers
    10. 10. Multiboutique

Thèmes

1. Introduction
2. Structure d'un thème
3. Fichier de configuration
   1. 1. Paramètres généraux
   2. 2. Paramètres spécifiques
      1. a. Configuration
      2. b. Modules
      3. c. Hooks
      4. d. Types d’image
      5. e. Layouts
      6. f. Dépendances
      7. g. Assets
   3. 3. Paramètres requis
4. Fichiers requis
   1. 1. Valider son thème
5. Gestions des assets
   1. 1. Décharger un asset
   2. 2. Webpack
      1. a. Installation
      2. b. Configuration
6. Core.js
   1. 1. Fonctions utiles
   2. 2. prestashop.checkPasswordScore
7. Les thèmes enfants
   1. 1. Créer un thème enfant
   2. 2. Charger les assets du thème parent
   3. 3. Réaliser des modifications
8. Smarty
   1. 1. Hooks
   2. 2. Widgets
   3. 3. Plugins
      1. a. Ajouter une fonction
      2. b. Ajouter un modificateur
      3. c. Ajouter des plug-ins via un module
9. Événements JavaScript
   1. 1. Transmettre un événement
   2. 2. Écouter un événement
10. Sélecteurs JavaScript
11. Prise en charge du RTL
12. Utilisation de templates spécifiques

Pour aller plus loin

1. Surcharges
   1. 1. Objectifs
   2. 2. Principes de base
   3. 3. Surcharge de classes
   4. 4. Surcharge de contrôleur
      1. a. Front-office
      2. b. Back-office
   5. 5. Surcharge de formulaires
      1. a. Formulaire back-office
      2. b. Template back-office
   6. 6. Surcharge de module
      1. a. Fichier principal
      2. b. Contrôleurs
      3. c. Templates
   7. 7. Surcharge de services
   8. 8. Note à propos du cache
2. TinyMCE
   1. 1. Introduction
   2. 2. Modification de la configuration
   3. 3. Utilisation dans le composant Form
3. Différer un appel de module lors de l'import produits, accessoires
4. Export de données au format CSV
5. Description et image de produits