Planète JulienD

Par juliendubreuil
julien dubreuil
Drupal since 2009

6 conseils pour savoir si Drupal est fait pour votre futur projet

Drupal est un très bon outil, il est réputé, modulable et est utilisé par beaucoup d’entreprises et organisations. J’ai eu la chance de participer à beaucoup de projets ces 5 dernières années, et j’ai pu constater à quel point on pouvait en user et en abuser.
La réalisation d’un projet web est un subtil dosage entre les contraintes métiers et les contraintes de l’outil.
La flexibilité de Drupal conduit malheureusement parfois à vouloir trop l’adapter et à le tordre pour répondre au besoin tout en espérant que cela n’aura pas d’impact. Un outil reste un outil, c’est pourquoi dans ce post, j’essaie de vous donner quelques pistes afin que vous puissiez définir si oui ou non Drupal est un bon choix pour votre projet.

Quels sont les besoins métiers que vous devez réaliser ?

Avant de savoir si Drupal est fait pour vous, il est important de comprendre ce qui doit être fait. Trop souvent j’ai vu des entreprises se ruer sur le choix de la technologie avant d’avoir pleinement défini les problèmes à résoudre. Définissez ce que vous avez besoin de faire, ce que votre client veut, les problématiques métiers à résoudre et ce que les utilisateurs finaux attendent.

Le diable se cache dans les détails, ne vous contentez pas simplement d’une petit phrase expliquant ce qui doit être fait. Voici un exemple client que j’ai rencontré : « L’outil doit fournir un système de modération des contenus ». Rien de terrifiant en soi, néanmoins de la simple checkbox, au workflow complexe avec validation et rôle utilisateur, il existe des dizaines de solutions pour implémenter cela. Il est donc important que vous définissiez comment les choses doivent fonctionner et non pas simplement ce qu’elles doivent faire pour pouvoir évaluer si l’outil est adapté.

Est-ce que vous devez faire du E-commerce, Gérer des milliers de contenus, une disponibilité proche des 100% ou constuire une application affichant des données en temps réel ? C’est autant de questions que vous devez vous poser.

Quelle est la part du projet qui est réalisée nativement ?

Drupal dispose d’un coeur minimaliste qu’il est possible d’étendre avec ce que l’on appelle des modules. Ainsi, si votre besoin n’est pas natif, il existe surement dans un module. Avec le nombre de projets réalisés sous Drupal, il y a fort à parier que quelqu’un a déjà rencontré le même besoin et qu’il ait avec un peu de chance créé un module sur drupal.org.
Pour savoir si Drupal est fait pour vous, vous devez apprendre à le connaitre, découvrir ses forces et ses faiblesses. Arpenter la liste de modules afin de trouver ceux qui vous conviennent le mieux, inspecter le coeur pour savoir ce qu’il s’y cache.
Bien souvent un module réalise entre 60 et 80% de ce que vous souhaitez faire, ne négligez surtout pas la part manquante à réaliser. Ajouter un besoin supplémentaire à un module existant sans le hacker ou l’ endommager n’est pas toujours une mince affaire. Attention toutefois, certains modules nécessitent d’autres modules pour fonctionner et certains modules ne sont pas compatibles entre eux. N’hésitez pas à lire : [comment choisir un module Drupal en seulement 5 étapes]. De même que, si vous n’avez pas besoin de l’améliorer ou de le modifier, il y aura toujours une part de « Glue code », permettant de l’intégrer pleinement à votre site à estimer.

Avez-vous une idée de la part de sur-mesure à réaliser ?

Drupal est développé en PHP et est facilement extensible par le biais de modules. En utilisant les forces du langage on peut développer ce que l’on veut et ainsi le transformer en n’importe quoi. Pour la petite anecdote, il m’est arrivé par le passé de déconseiller l’utilisation de Drupal à un client. L’équipe technique a fait le choix de ne pas suivre mon conseil et a choisi d’adapter Drupal au besoin. Résultat, le développement du projet a été un fiasco complet, problème de performance, code spaghetti et retard de livraison pour finalement tout arrêter et repartir sur un framework comme je l’avais préconisé quelques mois avant. La leçon à retenir est que si la part des développements sur-mesure à faire est trop grande par rapport aux avantages de l’outil, il faut prendre conscience que ce n’est certainement pas le meilleur choix pour vous.

Vous devez donc comprendre et estimer ce qui relève du natif, ce qui peut être réalisé facilement grâce à un module et ce qui approche les limites de l’outil (limites de performances, de maintenabilités, d’architectures…).

Est-ce que votre équipe maitrise Drupal ou pas ?

Depuis longtemps maintenant, il est admis que la courbe d’apprentissage de Drupal (en comparaison avec d’autres CMS) est longue. Il faut compter entre 1 et 3 mois pour qu’un développeur s’y retrouve facilement entre ce qui est fourni par le coeur de Drupal et ce qu’il est possible de faire grâce aux modules contribs. Prenez en compte le niveau d’expérience de votre équipe. N’hésitez pas à faire appel à un architecte ou à un lead dev (nb, l’auteur est freelance) pour vous épauler dans le cas où votre équipe serait novice.

A noter qu’il n’y a pas seulement l’équipe technique à prendre dans l’équation, il est important que les chefs de projet et product owner connaissent aussi l’outil.

Quel est votre budget ?

Et oui, il faut parler argent quand on parle de projet Drupal. Même s’il n’y pas de coût de licence, vous aurez d’autres coût auxquels il faudra faire face. Côté infrastructure, Drupal est assez gourmand, il vous faudra donc un hébergement de qualité et bien dimensionné. Coté développeurs c’est comme partout, les bons s’arrachent à prix d’or et sont souvent occupés des mois à l’avance. De plus, il y a plus d’offre que de demande, ce qui fait qu’il n’est pas toujours simple de constituer une équipe de qualité.

Quel est la taille de votre projet ?

Il faut être honnête, Drupal est conçu pour faire des gros sites et pas pour de simples sites vitrines. La robustesse de l’outil nécessite beaucoup de choses, du temps, des moyens, des connaissances. Or, je trouve que le retour sur investissement réalisé sur des petits projets n’est pas à la hauteur de ce qui pourrait être fait avec un wordpress par exemple.

Conclusion

Il n’existe pas de formule miracle pour déterminer si Drupal est un bon choix ou non pour un projet, cela dépend de plusieurs facteurs. A vous de mesurer les avantages et inconvénients entre le planning, le budget, l’engouement technologique, la motivation de l’équipe et leur capacité à apprendre.

Par juliendubreuil
julien dubreuil
Drupal since 2009

6 conseils pour savoir si Drupal est fait pour votre futur projet

Drupal est un très bon outil, il est réputé, modulable et est utilisé par beaucoup d’entreprises et organisations. J’ai eu la chance de participer à beaucoup de projets ces 5 dernières années, et j’ai pu constater à quel point on pouvait en user et en abuser.
La réalisation d’un projet web est un subtil dosage entre les contraintes métiers et les contraintes de l’outil.
La flexibilité de Drupal conduit malheureusement parfois à vouloir trop l’adapter et à le tordre pour répondre au besoin tout en espérant que cela n’aura pas d’impact. Un outil reste un outil, c’est pourquoi dans ce post, j’essaie de vous donner quelques pistes afin que vous puissiez définir si oui ou non Drupal est un bon choix pour votre projet.

Quels sont les besoins métiers que vous devez réaliser ?

Avant de savoir si Drupal est fait pour vous, il est important de comprendre ce qui doit être fait. Trop souvent j’ai vu des entreprises se ruer sur le choix de la technologie avant d’avoir pleinement défini les problèmes à résoudre. Définissez ce que vous avez besoin de faire, ce que votre client veut, les problématiques métiers à résoudre et ce que les utilisateurs finaux attendent.

Le diable se cache dans les détails, ne vous contentez pas simplement d’une petit phrase expliquant ce qui doit être fait. Voici un exemple client que j’ai rencontré : « L’outil doit fournir un système de modération des contenus ». Rien de terrifiant en soi, néanmoins de la simple checkbox, au workflow complexe avec validation et rôle utilisateur, il existe des dizaines de solutions pour implémenter cela. Il est donc important que vous définissiez comment les choses doivent fonctionner et non pas simplement ce qu’elles doivent faire pour pouvoir évaluer si l’outil est adapté.

Est-ce que vous devez faire du E-commerce, Gérer des milliers de contenus, une disponibilité proche des 100% ou constuire une application affichant des données en temps réel ? C’est autant de questions que vous devez vous poser.

Quelle est la part du projet qui est réalisée nativement ?

Drupal dispose d’un coeur minimaliste qu’il est possible d’étendre avec ce que l’on appelle des modules. Ainsi, si votre besoin n’est pas natif, il existe surement dans un module. Avec le nombre de projets réalisés sous Drupal, il y a fort à parier que quelqu’un a déjà rencontré le même besoin et qu’il ait avec un peu de chance créé un module sur drupal.org.
Pour savoir si Drupal est fait pour vous, vous devez apprendre à le connaitre, découvrir ses forces et ses faiblesses. Arpenter la liste de modules afin de trouver ceux qui vous conviennent le mieux, inspecter le coeur pour savoir ce qu’il s’y cache.
Bien souvent un module réalise entre 60 et 80% de ce que vous souhaitez faire, ne négligez surtout pas la part manquante à réaliser. Ajouter un besoin supplémentaire à un module existant sans le hacker ou l’ endommager n’est pas toujours une mince affaire. Attention toutefois, certains modules nécessitent d’autres modules pour fonctionner et certains modules ne sont pas compatibles entre eux. N’hésitez pas à lire : [comment choisir un module Drupal en seulement 5 étapes]. De même que, si vous n’avez pas besoin de l’améliorer ou de le modifier, il y aura toujours une part de « Glue code », permettant de l’intégrer pleinement à votre site à estimer.

Avez-vous une idée de la part de sur-mesure à réaliser ?

Drupal est développé en PHP et est facilement extensible par le biais de modules. En utilisant les forces du langage on peut développer ce que l’on veut et ainsi le transformer en n’importe quoi. Pour la petite anecdote, il m’est arrivé par le passé de déconseiller l’utilisation de Drupal à un client. L’équipe technique a fait le choix de ne pas suivre mon conseil et a choisi d’adapter Drupal au besoin. Résultat, le développement du projet a été un fiasco complet, problème de performance, code spaghetti et retard de livraison pour finalement tout arrêter et repartir sur un framework comme je l’avais préconisé quelques mois avant. La leçon à retenir est que si la part des développements sur-mesure à faire est trop grande par rapport aux avantages de l’outil, il faut prendre conscience que ce n’est certainement pas le meilleur choix pour vous.

Vous devez donc comprendre et estimer ce qui relève du natif, ce qui peut être réalisé facilement grâce à un module et ce qui approche les limites de l’outil (limites de performances, de maintenabilités, d’architectures…).

Est-ce que votre équipe maitrise Drupal ou pas ?

Depuis longtemps maintenant, il est admis que la courbe d’apprentissage de Drupal (en comparaison avec d’autres CMS) est longue. Il faut compter entre 1 et 3 mois pour qu’un développeur s’y retrouve facilement entre ce qui est fourni par le coeur de Drupal et ce qu’il est possible de faire grâce aux modules contribs. Prenez en compte le niveau d’expérience de votre équipe. N’hésitez pas à faire appel à un architecte ou à un lead dev (nb, l’auteur est freelance) pour vous épauler dans le cas où votre équipe serait novice.

A noter qu’il n’y a pas seulement l’équipe technique à prendre dans l’équation, il est important que les chefs de projet et product owner connaissent aussi l’outil.

Quel est votre budget ?

Et oui, il faut parler argent quand on parle de projet Drupal. Même s’il n’y pas de coût de licence, vous aurez d’autres coût auxquels il faudra faire face. Côté infrastructure, Drupal est assez gourmand, il vous faudra donc un hébergement de qualité et bien dimensionné. Coté développeurs c’est comme partout, les bons s’arrachent à prix d’or et sont souvent occupés des mois à l’avance. De plus, il y a plus d’offre que de demande, ce qui fait qu’il n’est pas toujours simple de constituer une équipe de qualité.

Quel est la taille de votre projet ?

Il faut être honnête, Drupal est conçu pour faire des gros sites et pas pour de simples sites vitrines. La robustesse de l’outil nécessite beaucoup de choses, du temps, des moyens, des connaissances. Or, je trouve que le retour sur investissement réalisé sur des petits projets n’est pas à la hauteur de ce qui pourrait être fait avec un wordpress par exemple.

Conclusion

Il n’existe pas de formule miracle pour déterminer si Drupal est un bon choix ou non pour un projet, cela dépend de plusieurs facteurs. A vous de mesurer les avantages et inconvénients entre le planning, le budget, l’engouement technologique, la motivation de l’équipe et leur capacité à apprendre.

Par juliendubreuil
julien dubreuil
Drupal since 2009

Définissez une langue système pour traduire proprement Drupal

Préparez Drupal pour la traduction

L’un des avantages majeurs à utiliser Drupal est de bénéficier d’un système de traduction avancé. En effet, avec l’ajout de quelques modules il devient facile de traduire contenus et interfaces. La langue par défaut que vous avez choisie lors de l’installation servira alors de base lors de la création des différentes entités sur votre site.

Néanmoins il existe une faiblesse dans le système. Drupal n’attribue pas de nom machine pour une chaine de caractères disponible pour la traduction et ne fait que faire le mapping entre la valeur de la chaine et de potentielles traductions. Cela a pour conséquence que lorsque vous changez la valeur de la chaine de caractères, Drupal n’est plus capable de faire le lien et votre traduction ne sert plus à rien.

Pour éviter cela, l’idée est d’installer votre site en Anglais et de se servir de cette langue comme langue système, puis d’ajouter d’autres langues pour traduire votre site. Ainsi si vous avez besoin de traduire votre site en Anglais, vous aurez deux langues Anglaises sur votre site, une pour le système et une pour vos utilisateurs.

Il m’arrive souvent, pendant la phase de développement d’un site, que le wording ne soit pas validé. Le choix cornélien de devoir appeler un bouton « Acheter » ou « sors ta CB » est long. L’autre avantage d’utiliser une langue système est que vous pouvez vous passer de cela, plus besoin d’attendre le label parfait pour CTA. Vous aurez simplement à traduire cette valeur lors de la phase de traduction.

Voici donc en 8 étapes comment configurer l’anglais par défaut comme langue système et ajouter d’autres langues (même de l’Anglais) comme traduction.

  1. Rendez-vous sur la page des modules et activez le module Locale.

  2. Une fois installé, rendez-vous sur la page d’administration des langues (/admin/config/regional/language).

  3. Cliquez sur le lien edit pour la langue Anglais. Ajoutez un path prefix “en-sys” et sauvegardez. Cette langue nous servira de langue système

  4. Une fois redirigé sur l’interface d’administration des langues cliquez sur le lien en haut Add a language.

  5. Dépliez le fieldset Custom language (oui c’est bien caché) et renseignez la configuration suivante. Cette langue sera l’anglais qui sera affiché à vos visiteurs.

    • language name = English customized
    • Native language code = English
    • Path prefix = en
    • Direction = left to right
  6. Ajoutez la langue FR à la liste des langues. Dans le cas où le Français sera la langue par défaut de votre site vous pouvez supprimer le “path prefix” dans les options de configuration de la langue FR.

  7. Activez les langues “French” et “English customized”, désactivez la langue “English” par défaut et cochez la le Français comme langue par défaut.

  8. Rendez-vous sur la page de détection des langues (/admin/config/regional/language/configure) et activez le mode de détection par “url”.

A ce stade il ne vous reste alors plus qu’à traduire les éléments d’interfaces en Français et en Anglais.

L’intérêt de cette solution est de permettre à la fois de traduire l’anglais par défaut et de ne pas se préoccuper de la traduction pendant le développement.

Par juliendubreuil
julien dubreuil
Drupal since 2009

Drupal 8, la métamorphose du CMS

Drupal 8, la métamorphose du CMS

C’est indéniable le web bouge et c’est certainement l’une des industries ou les outils évoluent aussi vite et sont aussi éphémères, ce qui est à la mode aujourd’hui ne le sera potentiellement plus demain. Le monde des CMS/CMF n’est pas épargné et subit son lot d’évolutions. Le problème n’est plus de savoir si telle ou telle fonctionnalité existe mais bel est bien de savoir si l’outil est capable de communiquer et de s’intégrer avec d’autres applications. Cette mutation du web a permis l’apparition de nouveaux usages tels que les SPA (single Page Application) ou MBaaS (Mobile Backend as a Service) dont le but est d’afficher des données dans un front web désolidarisé du backend.

Dans les articles précédents sur l’évolution des sites web et sur pourquoi Drupal 8 a subit une telle évolution Frédéric G. Marand et moi avons évoqué les applications orientées composants ou services. Par le passé, Drupal a prouvé qu’il était un excellent système de stockage de données et qu’il était capable d’exposer ces informations. Drupal 8 ira plus loin en intégrant cette capacité à s’associer de façon transparente avec d’autres applications externes à son coeur.

Drupal 8, l’impact sur les applications futures

L’application monolithique est un grand classique pour les projets réalisés avec Drupal, pour autant ce n’est pas parce qu’on peut tout faire avec que c’est une forcément une bonne idée. Est-ce que si votre boulanger se mettait à vendre des voitures et des outils de bricolage dans sa boutique vous ne trouveriez pas ça étrange ?

Comme l’a dit Frédéric, l’heure de gloire de la publication simple est derrière nous, aujourd’hui les attentes du marketing portent sur la personnalisation de l’expérience utilisateur en fonction des données acquises. Cela implique que les utilisateurs soient connectés et aient une identité persistante multisupport. On parle alors de session multi-device qui permet de reprendre la navigation ou encore vos achats là où vous en étiez et ce quel que soit le support.

Or lorsque Drupal fabrique ses pages pour un utilisateur connecté (pages générées à la volée et non chargées depuis le cache) cela consomme beaucoup de ressources. Il est rare de voir des pages de front web fabriquées avec moins de 50 requêtes SQL et autant de chargements de cache. Drupal est un outil performant pour la gestion de contenus néanmoins il n’est pas réputé pour ses performances d’affichage (cas pour un Drupal de base sans optimisation).

Ainsi la partie affichage à l’utilisateur final est susceptible d’être déplacé hors de Drupal en tant qu’application distincte basée sur des Javascript tels que AngularJs ou React afin de servir à la fois du web et du mobile qui ne cesse de grandir. C’est ce que l’on appelle le « headless Drupal ». Laissons à Drupal ce qu’il sait très bien faire, stocker et manipuler les données et déportons le front vers des technologies plus souple et plus rapide à mettre en place. Pour vous donner un exemple d’utilisation, on pourrait créer un B.O. unifié pour vos utilisateurs qui centraliserait vos contenus et vos produits puis différents sites web ayant chacun une thématique particulière qui viendraient consommer un webservice de façon à proposer des contenus ou produits à l’utilisateur.

Ainsi il faudra repenser Drupal comme un service de backend utilisé par des applications tiers qui consommeront des webservices pour servir l’expérience utilisateur, tout en gardant des temps de réponses performant grâce à la paralellisation.

Cette séparation entre le front et le back de l’application va nous offrir l’opportunité de raccourcir les cycles de développement et augmenter son efficacité tout en utilisant les dernières technologies et methodologies. La mutation de Drupal en API de contenus va permettre de réduire les problématiques multi-devices que l’on rencontre couramment.

Drupal 8 est à un point important de son évolution, ça passe où ça casse. Cette métamorphose à venir est de loin la plus grosse refonte qui ait été faite. Et vous, comment voyez-vous le futur des applications Drupal ? Comment comptez-vous vous y prendre ?

Par juliendubreuil
julien dubreuil
Drupal since 2009

Drupal 8, la refonte majeure

Drupal 8, la refonte majeure

Comme les Frameworks, Drupal a évolué tout au long de ces dernières années afin de suivre la demande et les tendances. Ces ajouts de fonctionnalités ont considérablement fait augmenter sa taille et complexifié l’outil. Toutefois, Drupal ne devrait plus être considéré comme un CMS mais comme un CMF (Content Management Framework). En fait c’est le cas depuis la version 4.7 avec l’apparition de CCK, la form API et views.

Pourquoi une telle refonte ?

Quand on regarde un peu sous le capot on s’aperçoit qu’il y a énormément de composants et librairies externes utilisés dans cette nouvelle version. Côté PHP pur, c’en est fini de la programmation procédurale qui rebutait tant de développeurs, aujourd’hui Drupal est pleinement orienté objet avec l’utilisation des Namespaces, des Traits et j’en passe. L’interopérabilité des composants a grandement été facilitée grâce aux standards du FIG avec PSR-4 (PSR-0), PSR-3 ainsi que Composer.

Non, Drupal n’a pas été réécrit en Symfony2, mais des composants SF2 ont été utilisés dans Drupal 8. D’ailleurs il existe aussi des composants provenants de Zend Framework comme le rappelle Frédéric G. Marand lors de notre présentation.

D8 aurait pu faire le même choix d’architecture qui a été fait pour Wordpress 4. C’est à dire, ne rien casser et ne faire que des évolutions axées sur la partie fonctionnelle et éditoriale. Or c’est une refonte en profondeur qui a été faite, en rupture totale avec les précédentes éditions. Le but a été de créer un framework Full-stack en n’écrivant que le minimum de code tout en réutilisant les meilleurs composants disponibles. C’est pour cela que des librairies de code telles que Twig, Guzzle ou encore EasyRDF ont été intégrées. Le gain de temps à ne pas maintenir ces composants pourra être utilisé efficacement à la conception du coeur de Drupal.

Le ton est donné, la volonté de cette nouvelle version est de se professionnaliser et de ne plus être vue comme une simple platforme de blog mais bel et bien comme un framework pour réaliser des applications.

Drupal 8, la baffe

Il ne faut pas se leurrer, cette nouvelle version va tout chambouler. Bien plus complexe que les précédentes, il va falloir apprendre de nouvelles choses et comprendre les nouveaux paradigmes et composants avant de se sentir efficace.
Néanmoins sur le long terme, cela permettra de créer du code plus maintenable, plus facile à faire évoluer et beaucoup plus simple à déployer.

N’attendez pas pour regarder de près ce qui se cache dans cette nouvelle version, les changements sont tellement nombreux et majeurs que cela peut prendre du temps avant d’être pleinement opérationnel avec les différents composants et librairies intégrés à Drupal 8.

Faut-il avoir peur de Drupal 8 ?

Non, même si l’on parle beaucoup du loup sans le voir, il n’est pas à craindre, bien au contraire. Bien sûr cela voudra dire de passer par une nouvelle phase d’apprentissage mais cela est courant pour tout développeur et je ne connais pas de bon dev qui refuse d’apprendre quelque chose de nouveau. Cette nouvelle version, si elle est utilisée comme composant d’une application va nous permettre de réaliser des applications plus maintenables et plus fun à réaliser. Peut-être que cela deviendra le backend privilégié pour les applications SF2.
Personnellement j’ai vraiment hâte de travailler sur des projets orientés services ou composants avec Drupal 8 de façon à pouvoir utiliser d’autres technologies bien plus performantes là où Drupal n’est pas adapté.

Références et articles sur le sujet :

Par juliendubreuil
julien dubreuil
Drupal since 2009

L’avenir des applications webs, des développeurs et des DSI

L’avenir des applications webs, des développeurs et des DSI

Il y a un mois de cela, lors de l’appel aux sessions pour Drupagora j’ai proposé plusieurs sujets en relation avec le thème de l’année qui était le E-commerce, malheureusement aucune session n’a passé la sélection. Néanmoins le comité de pilotage est revenu vers moi en me demandant de parler de l’avenir de Drupal, de l’impact sur le développement web et du futur des applications.

Dans ce sujet on ne peut plus vaste, qui touche à la fois à Drupal, aux technologies actuelles et à l’architecture logicielle j’ai souhaité ne pas uniquement donner mon point de vue et c’est pourquoi j’ai demandé à Frédéric G. Marand de co-animer cette session avec moi afin d’être le plus proche de la réalité. Difficile de trouver mieux comme co-présentateur en terme d’expérience et de contribution que ce soit dans la communauté Drupal ou ailleurs.

Nous avons donc passé quelques heures à confronter nos idées et points de vues afin de présenter notre vision du futur. Voici la synthèse de notre session résumée en quelques billets de blog :

La présentation de notre session :

Par juliendubreuil
julien dubreuil
Drupal since 2009

Liste des modules pour Drupal Commerce

Liste de module pour Drupal Commerce

Que vous soyez à la recherche d’un module pour un but précis, ou simplement à la recherche de nouvelles fonctionnalités pour votre site e-commerce il n’est pas simple de s’y retrouver dans tous ces modules. Ainsi chercher un module peu vite s’avérer long et fastidieux. Voici donc une petite liste de modules qui vous permettront de trouver votre chemin.

Comme avec le guide des modules pour Drupal 7, j’ai reparti les modules dédiés au e-commerce en différentes sections. Cette liste est une liste collaborative, ainsi, n’hésitez pas à commenter si vous trouvez des modules à ajouter !

E-commerce

Drupal Commerce est une suite de modules dédié au e-commerce qui s’est imposée sur Drupal.

Commerce VAT et Commerce EU VAT pour gérer les taxes en fonction du pays de votre client. Pensez à ne pas utiliser le module Taxe si vous utilisez ces deux modules. Ils sont bien maintenus et prennent en comptes les changements de lois.

Address book pour simplifier la vie de vos clients en leur permettant de créer un carnet d’adresse de façon ce qu’ils réutilisent leurs adresses dans le tunnel d’achat.

Shipping fourni un système de calcul de prix de frais de port. Ce module est un framework que vous devrez utiliser avec les modules de livraisons de votre transporteur préféré.

Commerce billy et Commerce billy mail pour générer des factures depuis votre site au format PDF afin que vos clients puissent les télécharger.

Commerce search api couplé à Search api vous permettra d’indexer les entités Drupal Commerce dans un moteur de recherche. Vous pourrez alors construire vos pages de catalogues robustes et performantes.

Search API ranges pour donner à vos visiteurs la possibilité de réduire les résultats entre deux prix.

Commerce backoffice afin d’avoir une meilleure expérience utilisateur dans la gestion et l’administration de votre boutique. Si vous avez déjà installé Commerce Kickstart v2 vous avez pu noter que le backoffice était plus beau que la version précédente et c’est principalement grâce à ce module.

Commerce reports permet aux marchands d’avoir une idée de ce qu’il se passe sur leur site. Ce module fourni un dashboard de statistiques sur l’évolution des commandes, clients…

Google analytics pour Commerce couplé à Google analytics vous permettra de traquer vos ventes en plus de vos statistiques de visites depuis le dashboard Google Analytics.

Cart and Checkout

Commerce checkout redirect redirige vos utilisateurs non connectés vers une page de création de compte ou de login avant de rentrer dans le tunnel d’achat. Notez que forcer les utilisateurs à créer un compte peut être source d’abandon de paniers.

Commerce checkout complete registration offre la possibilité aux clients de compléter le tunnel d’achat en anonyme et de créer un compte après le paiement s’ils le souhaitent.

Commerce checkout progress affichera dans votre checkout une barre en haut de la page de façon à indiquer à vos clients à quelle étape du checkout ils sont.

Commerce cart expiration permet de définir une durée de validité pour un panier. Par défaut les paniers n’ont pas de limite de validité, or il peut être intéressant d’en définir une de façon à faire un peu de ménage tous les 15 jours. Ce module vous permettra de supprimer les paniers selon vos critères. Pensez à avertir vos clients qu’ils ont laissé un panier histoire de les relancer.

Commerce add to cart confirmation affichera une pop-in lors de l’ajout au panier d’un produit. Cette pop-in offrira à vos clients le choix de poursuivre leurs achats ou de commencer le tunnel d’achat.

Commerce ajax cart donnera à vos clients la possibilité d’avoir une idée de leur panier via un bloc en Ajax. Cette fonctionnalité est bien moins intrusive que la pop-in de confirmation.

Products

Commerce stock vous aidera à gérer vos stocks et ainsi les produits disponibles à la vente.

Commerce stock notification pour ne plus louper une vente lorsque vous êtes en rupture de stock ! En cas de rupture de produit, le champ stock de la fiche de produit sera remplacé par un formulaire afin que le client puisse soumettre son email afin d’être notifié lors du réapprovisionnement.

Retour de marchandises Il arrive des fois où tout ne se passe pas comme prévu dans la vente à distance. Ce module permettra à vos clients de faire une demande de retour de leurs produits directement depuis leur commande. Notez qu’avec la loi Hamon, vous devez permettre à vos clients de pouvoir faire une demande de retour via un formulaire sur votre site.

Wishlist est utile lorsque vous voulez permettre à vos visiteurs de créer des listes d’envies afin d’acheter plus tard. Un lien permettant d’ajouter le produit dans une liste de souhaits sera inséré sur chaque fiche produit. L’utilisateur pourra par la suite retrouver ses produits préférés depuis son compte.

Commerce productpopularity vous permettra d’afficher un bloc des produits les plus populaires sur votre site.

Commerce rec permet d’afficher une liste de produits que d’autres clients ont acheté en commandant ce produit. Pratique pour booster le panier moyen, cette fonctionnalité vous demandera d’avoir déjà réalisé un certain nombres de vente pour être efficace.

Marketing

Discounts et Coupon 2.x vous permettront de créer des offres spéciales pour vos clients. Vous pourrez alors faire des réductions sur des produits, des profils de clients avec ou sans limite dans le temps.

Imports / Exports

Si vous utilisez le module Features pour exporter la configuration de votre site, vous pourrez ajouter Commerce Features à votre projet pour exporter ce qui est relatif au module Commerce.

Deux solutions s’offrent à vous si vous voulez importer des données. La plus simple des solutions consiste à utiliser Feeds, Commerce Feeds, voir même Xpathparser pour Feeds. Simple et efficace vous pourrez créer un import pas trop compliqué.
Si vous souhaitez quelque chose de plus robuste je vous conseille d’utiliser le couple Migrate et Commerce Migrate. Plus compliqué à prendre en main vous pourrez néanmoins réaliser des imports/exports complexes.

Performances et développement

Commerce Devel et un module additionnel pour Devel qui vous aidera dans votre développement de tous les jours.

Commerce Entitycache vous permettra en complément de Entitycache d’améliorer les performances de votre site en ajoutant aux caches les entités Drupal Commerce.

Par juliendubreuil
julien dubreuil
Drupal since 2009

Développeurs, êtes-vous prêts pour Drupal 8 ?

Développeurs, soyez prêt pour Drupal 8 et les dernières nouveautés ajoutées au CMS

“It’s ready, when it’s ready!” Nous connaissons tous cette citation, qui fait partie de la communauté Drupal. Ce n’est un secret pour personne, Drupal 8 sera bien plus compliqué à appréhender que les versions précédentes. Malheureusement il est encore impossible de définir une date de sortie, néanmoins on peut se dire qu’il nous reste encore quelques mois devant nous. Utilisons ainsi ce temps pour comprendre et découvrir tous les pré-requis de cette nouvelle version.

Depuis quelques mois maintenant j’ai commencé à agréger une liste d’articles de façon à être au point sur les dernières nouveautés apportées par D8. Du coup, voici un résumé des meilleurs ressources que j’ai pu trouver.

Notez que dans ce billet je ne parlerai pas des nouveautés de Drupal 8 mais plutôt des bases à avoir pour commencer à développement avec Drupal 8.

Programmation PHP moderne

POO, Classes et objets.

La Programmation Orientée Objet n’a rien de nouveau et s’est standardisée dans tous les languages de développement et frameworks, pourtant c’est assez nouveau dans le monde de Drupal. Jusqu’à maintenant réservée à quelques spécificités, la POO fera partie intégrale de Drupal 8. Rien de tel que de revoir ses bases pour être au courant des dernières nouveautés, voici quelques liens qui pourront vous aider.

Ressources :

Namespace

Les namespaces sont arrivés avec PHP 5.3 afin de résoudre deux problèmes avec les fonctions et les classes quand on veut écrire du code réutilisable. Premièrement, la collision de même nom entre portion de code et deuxièmement la possibilité de créer des alias pour les noms longs de fonction ou de classe à rallonge. Avec cette nouvelle version de Drupal, vous trouverez l’utilisation des namespaces un peu partout.

Ressources :

Autoloaders, PSR-0 et PSR-4

PSR–0 est un standard de chargement de classe (l’autoloading) permettant de définir une façon automatique d’inclure des classes PHP sans avoir à utiliser les fonctions telles que require() ou include(). PSR-0 se base sur le namespace d’une classe afin de définir sa position dans le file system.

PSR-4 a pour objectif de réduire la structure des dossiers pour l’autoloader. Cela a fait couler pas mal d’encre dans sur drupal.org – Drupal and PSR-0/PSR-4 Class Loading.

Ressources :

Annotations

Les annotations sont des meta-datas qui peuvent être ajoutées à votre code afin d’être lues lors de l’execution de celui-ci. Cela sert pour la définition et la configuration mais les annotations n’affectent pas la sémantique du code.

Personnellement je ne suis pas un grand fan des annotations, pour moi les commentaires doivent rester des commentaires, de façon à donner des informations et de la description sur le comportement d’une fonction. Changer un commenta ire ne devrait pas changer le comportement d’une fonction.

Ressources :

Design patterns

Il y a de fortes chances que si vous avez à résoudre un problème de conception, un autre développeur l’ait déjà résolu. Ainsi les design patterns (En) sont des guides applicables à n’importe quel language de programmation de façon à solutionner un problème. L’avantage d’utiliser des design patterns est que cela rend votre code plus maintenable, et que cela offre une solution éprouvée.

Ressources :

Dependency injection

C’est certainement l’un des design patterns les plus compliqués à bien expliquer, toutefois c’est probablement l’un des plus simple à utiliser. Ok, le nom est effrayant, mais je suis sûr que vous l’appliquez sans le savoir. Pour bien comprendre ce que c’est, je vous suggère de regarder comment Fabien Potencier l’explique.

Ressources :

Symfony 2

Ce n’est plus la nouvelle de l’année, Drupal 8 utilisera quelques composants tout droit venus de Symfony 2. Comme souvent il y a du pour et du contre sur le fait d’apprendre Symfony 2 pour faire du Drupal 8. Personnellement, Je dirais qu’y jeter un coup d’oeil avant de jouer avec D8 ne vous tuera pas, au contraire cela vous permettra certainement de mieux comprendre certain concepts. En bref, quelques heures à regarder et découvrir Symfony 2 est un bon investissement.

Ressources :

Si vous souhaitez aller un peu plus loin et avoir une vue plus complète des composants SF2 inclus dans Drupal 8, je vous suggère de lire cet article you got Symfony in my Drupal 8 (En) ou celui-ci Symfony 2 in Drupal 8 (En)

Bibliothèques additionnelles ajoutées à D8

En plus de ce que l’on a déjà pu voir, Drupal 8 inclura des librairies externes de façon à ne pas réinventer ce qui existe. D’ailleurs quelques-unes de ces librairies sont utilisées dans l’écosystème Symfony.

Composer

Composer est un outil de gestion des dépendances qui a été adopté en D8 pour gérer les bibliothèques additionnelles telles que Symfony ou encore Twig.
A la racine de Drupal vous pourrez apercevoir un fichier nommé composer.json, structuré d’une certaine manière de façon à définir les dépendances ainsi que leurs versions.

Ressources :

Doctrine

Doctrine Database Abstraction Layer (DBAL) est une surcouche d’abstraction entre l’application et la base de données. Cette API permet de s’interfacer simplement avec la plupart des système de base de données.

N’ayez crainte, Doctrine ne fait pas vraiment parti de Drupal 8 (certainement pour D9), Drupal 8 utilise seulement le composant de lecture des annotations de Doctrine (Cf le commentaire de Chx sur drupal.stackexchange).

Ressources :

Easy RDF

EasyRdf est une bibliothèque PHP permettant de manipuler simplement et efficacement du RDF.

Ressources:

Guzzle

Guzzle est un client HTTP en Php qui permet de s’interfacer avec des applications tiers mettant à disposition des web-services.

Ressources :

PHPUnit

PHPUnit est un framework de test P-Sour PHP. Celui-ci à été choisi en remplacement de Simpletest comme nouvel outil afin d’assurer la qualité du code de D8. On ne le répétera jamais assez, mais les tests unitaires sont la meilleure méthode pour détecter une regression sur un projet.

Ressources :

Twig

Au revoir PHPTemplate, bonjour Twig! PHPTemplate nous aura bien rendu service mais il est maintenant temps pour lui de prendre sa retraite. Twig est un moteur de template moderne pour PHP qui peut être enrichi via un API. Il est facile d’utilisation, sécurisé et flexible.

Ressources :

YAML

Au lieu d’utiliser notre format de fichier maison, la décision a été prise pour D8 d’utiliser quelque chose de plus commun et standardisé. YAML est un standard pour la création de fichier de configuration.

Ressources :

Le mot de la fin

J’ai essayé de ne pas donner trop de lien et de sélectionner les meilleurs pour chaque sujet parce que cela représente beaucoup d’informations. Néanmoins si vous voulez proposer un article pour complémenter ce post, ce sera avec plaisir. En regardant la longueur de ce post de pré-requis, on peut dire que Drupal 8 a changé et est différent des précédentes versions. Cela montre aussi la volonté de plus de qualité et de professionnalisme de la part de la communauté.

Je continuerai de mettre à jour cette liste et en attendant, j’espère que vous y trouverez votre bonheur.

Par juliendubreuil
julien dubreuil
Drupal since 2009

Drupal Commerce, ajouter un pane custom dans votre checkout

Drupal Commerce creation d'un pane de checkout

Comme nous avons pu le voir dans l’article précédent, il est simple de configurer le checkout de Drupal Commerce de façon à créer l’expérience utilisateur que vous désirez.

Dans cet article nous allons voir comment avec du code, ajouter et modifier des panes. Pour rappel, les panes sont les éléments qui composent les différentes pages du checkout. On y retrouve par exemple, le pane de paiement, d’adresse ou encore de choix de solution de transport.

Histoire d’illustrer cela, je vous propose de créer un module Drupal afin d’ajouter un pane permettant à vos clients de choisir parmi plusieurs emballages cadeaux. Ce simple module est accessible sur Github pour plus de compréhension.

Déclaration de notre nouveau Pane

La première chose à faire consiste à déclarer au système notre nouveau pane en utilisant le

hook_commerce_checkout_pane_info()

sandbox.module

1
2
3
4
5
6
7
8
9
<span class='line'><span class="k">function</span> <span class="nf">sandbox_commerce_checkout_pane_info</span><span class="p">()</span> <span class="p">{</span>
</span><span class='line'>  <span class="nv">$panes</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span>
</span><span class='line'>    <span class="s1">&#39;title&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;Paper gifts&#39;</span><span class="p">),</span>
</span><span class='line'>    <span class="s1">&#39;base&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;paper_gift_pane&#39;</span><span class="p">,</span>
</span><span class='line'>    <span class="s1">&#39;page&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;checkout&#39;</span><span class="p">,</span>
</span><span class='line'>  <span class="p">);</span>
</span><span class='line'>
</span><span class='line'>  <span class="k">return</span> <span class="nv">$panes</span><span class="p">;</span>
</span><span class='line'><span class="p">}</span>
</span>

Notre pane sera alors reconnu par Drupal et disponible dans le checkout. Dès à présent, vous pouvez activer le module et voir le pane apparaitre sur la page d’administration du checkout.

Comme à la manière des hooks de Drupal, le code qui génère l’affichage des panes va faire de l’introspection dans le code, de façon à chercher toutes les fonctions qui commenceront par la “base” que vous avez définie dans le hook_commerce_checkout_pane_info().

Ainsi le code sera à la recherche des fonctions suivantes :

  • BASE_settings_form()
  • BASE_checkout_form()
  • BASE_checkout_form_validate()
  • BASE_checkout_form_submit()
  • BASE_review()

Implémentation du formulaire d’administration du Pane

L’intérêt du pane est d’être affiché sur une page du checkout, néanmoins vous pouvez créer un formulaire de configuration pour celui-ci. Pour y accéder, rendez-vous sur l’interface d’administration du checkout. Notez qu’il n’y a pas de table dans laquelle les informations seront stockées, il vous faudra utiliser les méthodes variable_get() et variable_set() pour sauvegarder vos réglages.

sandbox.module

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<span class='line'><span class="sd">/**</span>
</span><span class='line'><span class="sd"> * Pane: settings form callback.</span>
</span><span class='line'><span class="sd"> */</span>
</span><span class='line'><span class="k">function</span> <span class="nf">paper_gift_pane_settings_form</span><span class="p">(</span><span class="nv">$checkout_pane</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>  <span class="nv">$form</span><span class="p">[</span><span class="s1">&#39;paper_gifts&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span>
</span><span class='line'>    <span class="s1">&#39;#type&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;checkboxes&#39;</span><span class="p">,</span>
</span><span class='line'>    <span class="s1">&#39;#title&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;Ship this item in a gift box&#39;</span><span class="p">),</span>
</span><span class='line'>    <span class="s1">&#39;#default_value&#39;</span> <span class="o">=&gt;</span> <span class="nx">variable_get</span><span class="p">(</span><span class="s1">&#39;paper_gifts&#39;</span><span class="p">,</span> <span class="k">array</span><span class="p">()),</span>
</span><span class='line'>    <span class="s1">&#39;#options&#39;</span> <span class="o">=&gt;</span> <span class="nx">paper_gift_pane_default_paper_gifts</span><span class="p">(),</span>
</span><span class='line'>  <span class="p">);</span>
</span><span class='line'>
</span><span class='line'>  <span class="k">return</span> <span class="nv">$form</span><span class="p">;</span>
</span><span class='line'><span class="p">}</span>
</span><span class='line'>
</span><span class='line'><span class="sd">/**</span>
</span><span class='line'><span class="sd"> * Defines a list of default paper gifts to use.</span>
</span><span class='line'><span class="sd"> */</span>
</span><span class='line'><span class="k">function</span> <span class="nf">paper_gift_pane_default_paper_gifts</span><span class="p">()</span> <span class="p">{</span>
</span><span class='line'>  <span class="k">return</span> <span class="k">array</span><span class="p">(</span>
</span><span class='line'>    <span class="s1">&#39;boy&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;Boys&#39;</span><span class="p">),</span>
</span><span class='line'>    <span class="s1">&#39;girl&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;Girls&#39;</span><span class="p">),</span>
</span><span class='line'>    <span class="s1">&#39;christmas&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;Christmas&#39;</span><span class="p">),</span>
</span><span class='line'>    <span class="s1">&#39;birthday&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;Birthday&#39;</span><span class="p">),</span>
</span><span class='line'>    <span class="s1">&#39;none&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;None&#39;</span><span class="p">),</span>
</span><span class='line'>  <span class="p">);</span>
</span><span class='line'><span class="p">}</span>
</span>

Dans le code ci-dessus, j’ai créé un formulaire d’administration et ajouté un champ texte, permettant au webmaster de modifier le texte qui sera affiché à l’utilisateur.

Création du Pane

Un pane n’est ni plus, ni moins qu’un formulaire dans le formulaire de checkout. Comme à l’habitude, vous y retrouverez le form, le form_validate et le form_submit.

Form

Le form contiendra ce qui sera affiché à l’utilisateur. Dans le cas de notre exemple, l’utilisateur pourra choisir entre plusieurs papiers cadeaux ou pas d’emballage.

sandbox.module

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
<span class='line'><span class="sd">/**</span>
</span><span class='line'><span class="sd"> * Pane: form callback.</span>
</span><span class='line'><span class="sd"> */</span>
</span><span class='line'><span class="k">function</span> <span class="nf">paper_gift_pane_checkout_form</span><span class="p">(</span><span class="nv">$form</span><span class="p">,</span> <span class="o">&amp;</span><span class="nv">$form_state</span><span class="p">,</span> <span class="nv">$checkout_pane</span><span class="p">,</span> <span class="nv">$order</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>  <span class="nv">$paper_gifts</span> <span class="o">=</span> <span class="k">array</span><span class="p">();</span>
</span><span class='line'>  <span class="nv">$default_paper_gifts</span> <span class="o">=</span> <span class="nx">paper_gift_pane_default_paper_gifts</span><span class="p">();</span>
</span><span class='line'>
</span><span class='line'>  <span class="k">foreach</span> <span class="p">(</span><span class="nv">$default_paper_gifts</span> <span class="k">as</span> <span class="nv">$name</span> <span class="o">=&gt;</span> <span class="nv">$title</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>    <span class="nv">$image</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span>
</span><span class='line'>      <span class="s1">&#39;path&#39;</span> <span class="o">=&gt;</span> <span class="nx">drupal_get_path</span><span class="p">(</span><span class="s1">&#39;module&#39;</span><span class="p">,</span> <span class="s1">&#39;sandbox&#39;</span><span class="p">)</span> <span class="o">.</span> <span class="s1">&#39;/images/&#39;</span> <span class="o">.</span> <span class="nv">$name</span> <span class="o">.</span> <span class="s1">&#39;.jpg&#39;</span><span class="p">,</span>
</span><span class='line'>      <span class="s1">&#39;title&#39;</span> <span class="o">=&gt;</span> <span class="nv">$title</span><span class="p">,</span>
</span><span class='line'>      <span class="s1">&#39;alt&#39;</span> <span class="o">=&gt;</span> <span class="nv">$title</span><span class="p">,</span>
</span><span class='line'>    <span class="p">);</span>
</span><span class='line'>    <span class="nv">$paper_gifts</span><span class="p">[</span><span class="nv">$name</span><span class="p">]</span> <span class="o">=</span> <span class="nx">theme</span><span class="p">(</span><span class="s1">&#39;image&#39;</span><span class="p">,</span> <span class="nv">$image</span><span class="p">);</span>
</span><span class='line'>  <span class="p">}</span>
</span><span class='line'>
</span><span class='line'>  <span class="nv">$pane_form</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span>
</span><span class='line'>    <span class="s1">&#39;#type&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;radios&#39;</span><span class="p">,</span>
</span><span class='line'>    <span class="s1">&#39;#default_value&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;none&#39;</span><span class="p">,</span>
</span><span class='line'>    <span class="s1">&#39;#title&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;Select your paper gift&#39;</span><span class="p">),</span>
</span><span class='line'>    <span class="s1">&#39;#description&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;Your items will be shipped in a gift box.&#39;</span><span class="p">),</span>
</span><span class='line'>    <span class="s1">&#39;#options&#39;</span> <span class="o">=&gt;</span> <span class="nv">$paper_gifts</span><span class="p">,</span>
</span><span class='line'>    <span class="s1">&#39;#attributes&#39;</span> <span class="o">=&gt;</span> <span class="k">array</span><span class="p">(</span><span class="s1">&#39;class&#39;</span> <span class="o">=&gt;</span> <span class="k">array</span><span class="p">(</span><span class="s1">&#39;paper-gift-pane-selection&#39;</span><span class="p">)),</span>
</span><span class='line'>  <span class="p">);</span>
</span><span class='line'>
</span><span class='line'>  <span class="nv">$pane_form</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">][</span><span class="s1">&#39;#attached&#39;</span><span class="p">][</span><span class="s1">&#39;css&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span>
</span><span class='line'>    <span class="nx">drupal_get_path</span><span class="p">(</span><span class="s1">&#39;module&#39;</span><span class="p">,</span> <span class="s1">&#39;sandbox&#39;</span><span class="p">)</span> <span class="o">.</span> <span class="s1">&#39;/css/sandbox.css&#39;</span><span class="p">,</span>
</span><span class='line'>  <span class="p">);</span>
</span><span class='line'>
</span><span class='line'>  <span class="k">return</span> <span class="nv">$pane_form</span><span class="p">;</span>
</span><span class='line'><span class="p">}</span>
</span>

Form validate

Le form_validate permet d’effectuer des opérations de validation sur les champs saisis par l’utilisateur.

sandbox.module

1
2
3
4
5
6
7
8
9
10
11
12
13
14
<span class='line'><span class="sd">/**</span>
</span><span class='line'><span class="sd"> * Pane: form validation callback.</span>
</span><span class='line'><span class="sd"> */</span>
</span><span class='line'><span class="k">function</span> <span class="nf">paper_gift_pane_checkout_form_validate</span><span class="p">(</span><span class="nv">$form</span><span class="p">,</span> <span class="o">&amp;</span><span class="nv">$form_state</span><span class="p">,</span> <span class="nv">$checkout_pane</span><span class="p">,</span> <span class="nv">$order</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>  <span class="c1">// Validate the given value or set to none if null.</span>
</span><span class='line'>  <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="k">empty</span><span class="p">(</span><span class="nv">$form_state</span><span class="p">[</span><span class="s1">&#39;values&#39;</span><span class="p">][</span><span class="nv">$checkout_pane</span><span class="p">[</span><span class="s1">&#39;pane_id&#39;</span><span class="p">]]))</span> <span class="p">{</span>
</span><span class='line'>    <span class="nv">$pane_values</span> <span class="o">=</span> <span class="nv">$form_state</span><span class="p">[</span><span class="s1">&#39;values&#39;</span><span class="p">][</span><span class="nv">$checkout_pane</span><span class="p">[</span><span class="s1">&#39;pane_id&#39;</span><span class="p">]];</span>
</span><span class='line'>
</span><span class='line'>    <span class="k">if</span> <span class="p">(</span><span class="k">empty</span><span class="p">(</span><span class="nv">$pane_values</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">]))</span> <span class="p">{</span>
</span><span class='line'>      <span class="nv">$pane_values</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;none&#39;</span><span class="p">;</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>  <span class="p">}</span>
</span><span class='line'>  <span class="k">return</span> <span class="k">TRUE</span><span class="p">;</span>
</span><span class='line'><span class="p">}</span>
</span>

Ici, on regarde simplement s’il y a une valeur, sinon on définit que l’utilisateur ne veut pas d’emballage.

Form submit

La sauvegarde des informations intervient dans le form_submit une fois que l’on a passé la validation.

sandbox.module

1
2
3
4
5
6
7
8
9
10
11
<span class='line'><span class="sd">/**</span>
</span><span class='line'><span class="sd"> * Pane: form submission callback.</span>
</span><span class='line'><span class="sd"> */</span>
</span><span class='line'><span class="k">function</span> <span class="nf">paper_gift_pane_checkout_form_submit</span><span class="p">(</span><span class="nv">$form</span><span class="p">,</span> <span class="o">&amp;</span><span class="nv">$form_state</span><span class="p">,</span> <span class="nv">$checkout_pane</span><span class="p">,</span> <span class="nv">$order</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>  <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="k">empty</span><span class="p">(</span><span class="nv">$form_state</span><span class="p">[</span><span class="s1">&#39;values&#39;</span><span class="p">][</span><span class="nv">$checkout_pane</span><span class="p">[</span><span class="s1">&#39;pane_id&#39;</span><span class="p">]]))</span> <span class="p">{</span>
</span><span class='line'>    <span class="nv">$pane_values</span> <span class="o">=</span> <span class="nv">$form_state</span><span class="p">[</span><span class="s1">&#39;values&#39;</span><span class="p">][</span><span class="nv">$checkout_pane</span><span class="p">[</span><span class="s1">&#39;pane_id&#39;</span><span class="p">]];</span>
</span><span class='line'>    <span class="k">if</span> <span class="p">(</span><span class="o">!</span><span class="k">empty</span><span class="p">(</span><span class="nv">$pane_values</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">]))</span> <span class="p">{</span>
</span><span class='line'>      <span class="nv">$order</span><span class="o">-&gt;</span><span class="na">data</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="nv">$pane_values</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">];</span>
</span><span class='line'>    <span class="p">}</span>
</span><span class='line'>  <span class="p">}</span>
</span><span class='line'><span class="p">}</span>
</span>

Remarquez que vous avez accès à l’objet $order et que vous pouvez faire ce que vous en voulez. Pour l’exercice j’aurais pu créer un nouveau line item, mais pour faire simple le choix de l’utilisateur résidera comme simple information dans la commande.

Form review

Une fois l’information attachée à la commande, il ne nous reste plus qu’à la faire paraitre sur le pane de review afin que l’utilisateur puisse la voir.

Pour cela il suffit d’implémenter le form_review

sandbox.module

1
2
3
4
5
6
7
8
9
10
11
12
<span class='line'><span class="sd">/**</span>
</span><span class='line'><span class="sd"> * Pane: Review</span>
</span><span class='line'><span class="sd"> */</span>
</span><span class='line'><span class="k">function</span> <span class="nf">paper_gift_pane_review</span><span class="p">(</span><span class="nv">$form</span><span class="p">,</span> <span class="nv">$form_state</span><span class="p">,</span> <span class="nv">$checkout_pane</span><span class="p">,</span> <span class="nv">$order</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>  <span class="k">if</span> <span class="p">(</span><span class="nv">$order</span><span class="o">-&gt;</span><span class="na">data</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">]</span> <span class="o">&amp;&amp;</span> <span class="nv">$order</span><span class="o">-&gt;</span><span class="na">data</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">]</span>  <span class="o">!=</span> <span class="s1">&#39;none&#39;</span><span class="p">)</span> <span class="p">{</span>
</span><span class='line'>    <span class="nv">$content</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="k">array</span><span class="p">(</span>
</span><span class='line'>      <span class="s1">&#39;#type&#39;</span> <span class="o">=&gt;</span> <span class="s1">&#39;item&#39;</span><span class="p">,</span>
</span><span class='line'>      <span class="s1">&#39;#markup&#39;</span> <span class="o">=&gt;</span> <span class="nx">t</span><span class="p">(</span><span class="s1">&#39;Items in your order will be wrapped with the %paper paper gift&#39;</span><span class="p">,</span> <span class="k">array</span><span class="p">(</span><span class="s1">&#39;%paper&#39;</span> <span class="o">=&gt;</span> <span class="nv">$order</span><span class="o">-&gt;</span><span class="na">data</span><span class="p">[</span><span class="s1">&#39;paper_gift&#39;</span><span class="p">])),</span>
</span><span class='line'>    <span class="p">);</span>
</span><span class='line'>    <span class="k">return</span> <span class="nx">drupal_render</span><span class="p">(</span><span class="nv">$content</span><span class="p">);</span>
</span><span class='line'>  <span class="p">}</span>
</span><span class='line'><span class="p">}</span>
</span>

Modification d’un Pane existant

Comme mentionné précédemment, les panes ne sont que des forms et comme tout form vous avez la possibilité de les alterer via un hook_form_alter() ou encore mieux un hook_form_ID_alter().

Dans le cas ou vous voudriez modifier les paramètres d’un pane, vous implémentez la fonction hook_commerce_checkout_pane_info_alter()

Le mot de la fin

Au final, ce n’était pas si compliqué que cela ? En plus du fait d’avoir maintenant un pane pour offrir un emballage papier cadeau à vos clients, vous savez maintenant qu’il y a 3 grandes étapes dans la vie d’un pane. Le formulaire de settings pour l’admin, le formulaire destiné aux clients et le formulaire de review. Je serais curieux de savoir pourquoi vous avez besoin d’ajouter un pane dans votre checkout…
Comme mentionné au début de ce post, le code est accéssible sur Github.

Par juliendubreuil
julien dubreuil
Drupal since 2009

Drupal Commerce, maitriser votre checkout

Drupal Commerce configuration du checkout

Une des demandes récurrentes de la part des utilisateurs de Drupal Commerce est la possibilité de personnaliser le checkout. Que ce soit pour changer les étapes du checkout, ou pour recueillir des données supplémentaires, l’API de Drupal Commerce permet de répondre à ce besoin facilement.

Drupal Commerce vient avec deux concepts concernant le checkout, les Pages et les panes. Les “pages” permettent l’affichage et la configuration des différentes pages du checkout, comme par exemple la page de paiement, de livraison ou encore comme la page de résumé de commande. Ces pages contiennent des “panes”, permettant d’interagir avec le client, comme illustre la saisie de l’adresse ou du numéro de carte de crédit dans le checkout.

Attention toutefois, lorsque vous rallongez votre checkout, vous complexifiez le processus d’achat et augmentez les risques de perte de clients. Incontestablement, la bonne pratique est d’avoir le checkout le plus simple et court possible, néanmoins il existe certains cas où il faut déroger à la règle.

Ordonner les étapes de votre checkout

La façon la plus simple d’ordonner les étapes de votre checkout consiste à vous rendre sur l’interface d’administration de votre site dans la rubrique checkout settings de la section store > configuration

Cette page d’administration regroupe toutes les pages de votre checkout ainsi que les panes contenus dans chaque page. Drag’n dropable, vous pouvez déplacer un pane d’une page à une autre de façon à créer l’expérience utilisateur de votre choix.

Par défaut le checkout est découpé en 4 pages:
* Checkout : la page “Checkout”, est la première étape, elle permet la collecte des informations de base.
* Review order: la page “Review order” permet d’afficher un résumé de la commande avant la validation et la soumission du paiement.
* Payement : cette page, nommée “Payment”, est uniquement utilisée lorsque qu’une méthode de paiement est dite off-site.
* Checkout complete: la page “Checkout complete”, permet d’afficher une confirmation de commande au client.

Drupal Commerce checkout configurationDrupal Commerce checkout configuration

Ajouter des pages à votre checkout

Comme bien souvent, il existe deux façons de faire avec Drupal ou Drupal Commerce pour arriver à vos fins. Soit vous utilisez un module contrib, soit vous faites un peu de code custom.

Si vous souhaitez passer par un module, il vous faudra utiliser Drupal Commerce Checkout Pages qui vous permettra d’ajouter des pages depuis l’interface d’administration de votre site.

L’autre façon, consiste à utiliser l’API de Drupal Commerce en implémentant le hook_commerce_checkout_page_info() dans un module custom. Une fois créée votre page sera accessible dans l’interface d’administration. C’est de cette manière que sont créées les pages de Drupal Commerce. Pour plus d’information, rendez-vous dans le fichier commerce_checkout.api.php du sous module checkout.

Ajouter des panes à votre checkout

De la même manière que précédemment, il est possible de faire la même chose avec les panes.

Coté module vous pouvez vous baser sur Commerce extra panes afin d’afficher une ou plusieurs nodes dans votre checkout en guise d’information.

Coté code, il vous faudra implémenter le hook_commerce_checkout_pane_info() de façon à déclarer votre nouveau pane. Notez ensuite, que vous devrez créer vos callbacks, afin d’afficher les informations désirées.
Pour plus d’information, rendez-vous dans le fichier commerce_checkout.api.php du sous module checkout.

Le mot de la fin

Comme à l’accoutumée, il est simple de personnaliser le checkout de Drupal commerce que ce soit avec un module ou un peu de code custom. Encore une fois, attention de penser à l’expérience utilisateur de vos clients quand vous complexifiez le checkout.

Pages