Tutoriel Magento Cloud : comment intégrer un module issu de la MarketPlace Magento ?

Nous vous présentons aujourd’hui la deuxième partie de notre tutoriel sur Magento Cloud, débuté la semaine dernière à partir de la marche à suivre rédigée par Alan Kent sur son blog. Nous vous avons appris à créer un nouveau projet sur Magento Cloud, maintenant nous allons vous expliquer comment y intégrer un module issu de la MarketPlace Magento.




Sur Magento Cloud, vous aviez besoin d’être client pour accéder à l’interface utilisateur de Magento Cloud. Ce n’est pas le cas pour la MarketPlace Magento : tout le monde peut suivre les étapes suivantes sans être connecté. Un compte magento.com sera seulement nécessaire pour finaliser le processus de paiement.

Pour commencer, il nous faut tout d’abord trouver une extension à installer. Allez sur http://marketplace.magento.com et recherchez « Fooman ». Sélectionnez l’extension « Fooman Print Order Pdf ». (Vous pouvez choisir l’extension de votre choix, nous utilisons l’extension Fooman parce qu’elle est gratuite.)





Cliquez sur « Print Order PDF » pour faire apparaître une page de présentation de l’extension avec les détails.





Cliquez sur le bouton « Add to Cart » pour ajouter l’extension dans votre panier. Même si l’extension est gratuite, vous devez « commander » l’extension pour le rendre disponible dans votre répertoire Composer personnalisé.





Cliquez sur le lien « Go to Checkout » pour valider l’extension et compléter l’achat. Cela déclenchera une demande de connexion pour identifier qui est l’utilisateur. Jusqu’à ce stade, votre navigation sur le MarketPlace aura été anonyme.





Une fois connecté, vérifiez votre commande pour la corriger si besoin. Puis cliquez sur « Place Order » pour soumettre la commande afin qu’elle soit traitée.





Après que la commande ait été passée, vous recevrez une page de confirmation avec un numéro de commande pour votre nouvelle demande. Ceci est la dernière page obligatoire du processus de commande sur le Magento MarketPlace, processus nécessaire pour rendre une extension téléchargeable via le Composer.





Avant d’installer le module, connectez-vous à l’interface d’administration Magento, et vérifiez la page « Orders » dans le menu déroulant des actions. Notez qu’il n’y a pas d’action « Print Orders » dans le menu. Cette nouvelle option sera ajoutée une fois l’extension installée.





Dans un de ses précédents posts, Alan Kent avait partagé un script qui affichait les détails du répertoire Composer. Nous vous le redonnons ici car il permet de repérer plus facilement ce qu’il faut ajouter au fichier composer.json pour charger l’extension.

$ php pkglist.php
...
fooman/printorderpdf-m2 [magento2-module]
    2.0.2 magento/module-backend:~100.0.2 magento/module-sales:~100.0.2
    Print the order as a pdf from the admin
... 

Modifiez le fichier pour ajouter “fooman/printorderpdf-m2”: “2.0.2” à la section « require ».

 "require": {
    "magento/product-enterprise-edition": "2.0.5",
    "composer/composer": "@alpha",
    "magento/magento-cloud-configuration": "1.0.*",
    "colinmollenhour/credis": "1.6",
    "colinmollenhour/php-redis-session-abstract": "1.1",
    "fooman/printorderpdf-m2": "2.0.2"
},

Vous pouvez également utiliser « composer require » pour qu’il ajoute la nouvelle entrée dans le fichier composer.json à votre place.

 $ composer require fooman/printorderpdf-m2 2.0.2 

Enfin, commitez et installez la modification dans le répertoire Magento Cloud Git. Cela va pousser le fichier composer.json mis à jour vers le Cloud, ce qui va entraîner la mise à jour du site avec le nouveau code.

 $ git add composer.json
$ git commit
$ git push 

Puis, connectez-vous de nouveau à l’interface administration. Vous pourrez voir si le module a été chargé en allant dans Stores > Configuration > Advanced > Advanced. Le nouveau module Fooman_PrintOrderPdf sera affiché comme l’un des modules disponibles à activer/désactiver.





De plus, si vous revenez à l’écran « Orders », vous pouvez maintenant voir dans le menu déroulant l’onglet « Print Order » qui n’était pas là avant.

Conclusion

Cette deuxième partie termine notre tutoriel de déploiement de Magento Cloud où nous vous avons montré comment utiliser la Marketplace Magento pour trouver et installer une extension sur le Cloud.

Il est important de préciser que, si ce tutoriel a été entièrement illustré avec des captures d’écran de Magento Cloud, il peut également s’appliquer à d’autres fournisseurs d’hébergement. Même si Git n’est pas utilisé, d’autres scripts shells de déploiement peuvent être utilisés pour simplifier le déploiement des modifications apportées à la production.


Pour plus d’informations et de tutoriels, nous vous conseillons d’aller lire le site d’Alan Kent, et pour tout renseignement supplémentaire ou demande d’aide sur un de vos projets Magento, n’hésitez pas à nous contacter !