Magento | Hervé Hennes

Magento 2 : Ajouter une colonne dans la grid admin des commandes

29 juin 2025 / herve / Magento

Voici un tutoriel rapide sur la procédure pour rajouter un nouvelle colonne d’information dans la grille admin des commandes.
Dans notre hypothèse je pars sur l’hypothèse qu’on souhaite que la colonne soit physiquement présente dans la table sales_order_grid de la base de données.
Et pour l’exemple nous allons rendre disponible le coupon de réduction utilisé sur la commande.
Celui-ci est initialement stocké dans la colonne coupon_code dans la table sales_order

Pour cela on va créer un module Hhennes_OrderAdminGrid (le lien vers le code sur github est disponible en fin d’article)

Ajout de la colonne dans la table sales_order_grid

Pour cela nous pouvons mettre le code suivant dans le fichier etc/db_schema.xml de notre module

Ajout de colonne dans la vue admin

Pour cela nous pouvons mettre le code suivant dans le fichier view/adminhtml/ui_component/sales_order_grid.xml

<?xml version="1.0"?>
<listing xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="urn:magento:module:Magento_Ui:etc/ui_configuration.xsd">
    <columns name="sales_order_columns">
        <column name="coupon_code">
            <settings>
                <label translate="true">coupon code</label>
                <filter>text</filter>
                <sorting>asc</sorting>
                <visible>true</visible>
            </settings>
        </column>
    </columns>
</listing>

…

Magento 2 : Ajouter une colonne dans la grid admin des commandes Lire la suite »

Pas de commentaires

Magento 2 : Ajouter un fallback de traduction

1 mars 2025 / herve / Magento

Dans le cadre de la création de sites localisés sous Magento 2 , il peut arriver que plusieurs sites utilisent une langue similaire, mais pas la même locale au niveau de Magento.

C’est notamment le cas si vous avez un :

Un site français utilisant la locale fr_FR
Un site Suisse utilisant la locale fr_CH

Dans le cadre de la traduction du site il sera donc nécessaire nativement de mettre les mêmes traductions à la fois dans les fichiers de traductions fr_FR.csv et dans les fichier fr_CH.csv

Nous allons voir comment optimiser ce fonctionnement.
L’idée étant la suivante :

La locale fr_CH doit reprendre l’intégralité des traductions fr_FR
Il doit rester possible de surcharger les traductions spécifiquement pour la locale fr_CH si on le souhaite.

Pour mettre cela en oeuvre c’est relativement facile, mais cela nécessite tout de même une préférence de la classe : \Magento\Framework\Translate

Le module s’appellera Hhennes_Translate, je ne détaille pas les étapes nécessaires pour l’initialiser.

On déclare la préférence :
Si on souhaite l’appliquer uniquement sur le frontend on peut le faire dans le fichier frontend/di.xml…

Magento 2 : Ajouter un fallback de traduction Lire la suite »

Pas de commentaires

Magento 2 : Gagner du temps sur la création de vos DataPatch

27 décembre 2024 / herve / Magento

Les datapatches magento permettent de déployer rapidement des changements spécifiques via un module sur l’ensemble des environnements de votre projet de manière automatique.

 Ils sont rangés dans le dossier Setup/Patch/Data de votre module et ils implémentent l’interface \Magento\Framework\Setup\Patch\DataPatchInterface
Il sont appliqués automatiquement si nécessaire uniquement lors de l’exécution de la commande bin/magento setup:upgrade

Dans le cas de la réalisation de patchs complexes il peut être nécessaire de les rejouer plusieurs fois pour vérifier que tout fonctionne correctement.
 La procédure à effectuer est la suivante :

Suppression du patch dans la base de données dans la table patch_list
Exécution de la commande bin/magento setup:upgrade

 Cette procédure est relativement lente comme l’exécution du setup:upgrade est longue, car magento réalise pleins d’opérations autres que l’application des patches. 

Nous allons voir ici comment gagner du temps à cette étape.  

Nous allons utiliser une fonctionnalité qui est proposée par l’indispensable commande console n98-Magerun2 , que vous pouvez télécharger ici : https://github.com/netz98/n98-magerun2   
La commande qui nous intéresse est dev:console .…

Magento 2 : Gagner du temps sur la création de vos DataPatch Lire la suite »

Pas de commentaires

Magento 2 : Mute logs Add of item with id … and other useless in developement

13 février 2024 / herve / Magento

Note rapide sur comment réduire au silence les logs du module Magento_Backend qui remplis le fichier system.log avec des centaines d’entrées inutiles du type

[2024-02-10T17:13:48.877379+00:00] main.INFO: Add of item with id Magento_Sales::sales was processed [] []
[2024-02-10T17:13:48.878055+00:00] main.INFO: Add of item with id Magento_Sales::sales_operation was processed [] []

Pareil pour moi qui fait essentiellement du développement back office pour tous les logs du type

[2024-02-13T10:54:24.978175+00:00] report.INFO: Broken reference: the ‘catalog.leftnav’ element cannot be added as child to ‘sidebar.main’, because the latter doesn’t exist [] []

Cela noie les informations intéressantes d’autant que c’est une information qui n’est pas très utile.

Pour masquer ça la méthode la plus simple est de faire un fichier patch, avec le contenu suivant :
Dans un fichier qui s’appelerais par exemple : LOCAL-mute-useless-logs.patch

diff --git a/vendor/magento/framework/View/Layout/Data/Structure.php b/vendor/magento/framework/View/Layout/Data/Structure.php
--- a/vendor/magento/framework/View/Layout/Data/Structure.php
+++ b/vendor/magento/framework/View/Layout/Data/Structure.php
@@ -122,10 +122,10 @@
                 $siblingParentName = $this-getParentId($sibling);
                 if ($parentName !== $siblingParentName) {
                     if ($this-state-getMode() === State::MODE_DEVELOPER) {
-                        $this-logger-info(
+                        /*$this-logger-info(
                             "Broken reference: the '{$childName}' tries to reorder itself towards '{$sibling}', but " .

…

Magento 2 : Mute logs Add of item with id … and other useless in developement Lire la suite »

Pas de commentaires

Magento 2 : Ajouter une validation du numéro de téléphone

15 décembre 2021 / herve / Magento

Nous allons voir comment ajouter facilement une règle de validation spécifique sur le numéro de téléphone de l’adresse client sur les formulaires suivants :

Ajout / Édition d’adresse dans le compte client
Ajout d’adresse dans le tunnel de commande.

Pour faire cela nous allons créer un module CustomerPhoneValidation ( les sources complètes sont sur github et le lien disponible en fin d’article
Cet article est basé sur la version 2.4.1

Fonctionnement général

Les données des formulaires magento sont validées via l’objet javascript « validator » de magento, qui utilise ensuite la librairie jquery validate.
L’objet « Validator » dispose d’un certains nombre de règles de base qui sont visibles dans le fichier : lib/web/mage/validation.js
Il est possible assez facilement via les mixins d’ajouter nos propres règles de validation.
L’environnement de validation de données utilisées dans le compte clients et dans le tunnel de commandes étant différents il faudra créer 2 mixins.

Voici donc comment ajouter la nouvelle règle de validation
Cette règle vérifiera que le format du téléphone est au format français ( 10 chiffres commençant par 0 )

Pour commencer créér le fichier view/frontend/requirejs-config.js…

Magento 2 : Ajouter une validation du numéro de téléphone Lire la suite »

1 commentaire

Magento 2 module pour visualiser les pdfs dans le navigateur

25 mai 2021 / herve / Magento

J’avais rencontré la même problématique sur un développement prestashop ( cf. https://www.h-hennes.fr/blog/2020/07/13/prestashop-gagnez-du-temps-lors-la-personnalisation-des-fichiers-pdf-factures-livraisons/ ), dans le cas ou on souhaite personnaliser les fichiers pdfs pour changer des éléments ou de la mise en forme c’est relativement pénible de devoir à chaque fois télécharger le fichier pdf pour le visualiser.

J’ai donc créé un module magento 2 pour visualiser les pdf dans le navigateur , celui-ci fonctionne pour les pdfs suivants dans l’administration

Factures ( Invoices )
Livraisons ( Shipping)
Avoirs ( Creditmemo )

Celui-ci a uniquement été testé sur Magento 2.4.
Le module est disponible sur mon dépot github avec des exemples d’extensions magento 2.
https://github.com/nenes25/magento2_samplemodules/tree/master/Hhennes/SalesAdminPdfViewer

Configuration

Il est possible d’activer ou non l’affichage des pdfs via la configuration dans :

Configuration / Hhennes Extensions / Pdf Print

Penser à vider le cache une fois la modification appliquée, et une fois celui-ci actif les fichiers pdfs sont affichés directement dans le navigateur :

Il est ensuite possible de voir les changements dès le rafraîchissement de la page, et sans devoir télécharger le fichier.…

Magento 2 module pour visualiser les pdfs dans le navigateur Lire la suite »

Pas de commentaires

Magento 2 : Ajouter une colonne dans la facture pdf

25 octobre 2018 / herve / Magento

Voyons ensemble comment ajouter une colonne dans la facture sous Magento 2.
Nous souhaitons ajouter une colonne « Tax Rate » qui affichera le taux de taxe appliqué à chaque élément de la facture.

Le rendu final sera le suivant :

Pour faire cela nous allons créer un module Hhennes_Sales
( je ne détaille pas le processus de création basique du module )

Celui-ci devra surcharger les classes suivantes :

Magento\Sales\Model\Order\Pdf\Invoice
Magento\Sales\Model\Order\Pdf\Items\Invoice\DefaultInvoice

Pour cela il faudra mettre le contenu suivant dans le fichier etc/di.xml du module :

   <?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <preference for="Magento\Sales\Model\Order\Pdf\Invoice"
                type="Hhennes\Sales\Model\Sales\Order\Pdf\Invoice"></preference>
    <preference for="Magento\Sales\Model\Order\Pdf\Items\Invoice\DefaultInvoice"
                type="Hhennes\Sales\Model\Sales\Order\Pdf\Items\Invoice\DefaultInvoice"></preference>
</config>

Concernant les surcharges :

La notion importante est la valeur de « feed » , qui correspond à la position en x du contenu dans le pdf
Pour obtenir un ensemble visuellement harmonieux, il peut être nécessaire de jouer avec ces valeurs pour l’ensemble des éléments.…

Magento 2 : Ajouter une colonne dans la facture pdf Lire la suite »

5 commentaires

Magento 2 : Ajouter des link alternate sur les pages cms

25 septembre 2018 / herve / Magento

Sur magento 2 ( comme sur magento 1 ) , les contenus et notamment les pages cms sont accessibles via plusieurs url avec ou sans slash à la fin.

Vous pouvez le constater sur la page de la politique de confidentialité qui est à la fois disponible sous les urls :
http://magento2-demo.nexcess.net/privacy-policy-cookie-restriction-mode et http://magento2-demo.nexcess.net/privacy-policy-cookie-restriction-mode/

Au niveau Seo c’est assez moyen c’est pourquoi il est utile de préciser à Google quelle est la version à indexer.
Ceci peut être réalisé via l’ajout d’une balise link rel= »canonical ».

Nous allons voir ensemble comment réaliser cela pour magento 2 via un module qui s’appellera Hhennes/Cms
Ce module ajoutera automatiquement une balise canonical sur les pages cms, il est possible de configurer en back office quelle sera l’url à utiliser ( avec ou sans le slash )

Ce module sera dépendant du module Magento_Cms.

Je vais juste détailler le fonctionnement global, vous trouverez le lien vers github en fin d’article pour le télécharger. (sans la partie création initiale )

La logique est relativement simple , nous allons rajouter un block spécifique sur les pages cms dans le container « head.additional …

Magento 2 : Ajouter des link alternate sur les pages cms Lire la suite »

Pas de commentaires

Magento : Liste des ressources utilisables dans system.xml

7 septembre 2018 / herve / Magento

Un petit article rapide d’aide mémoire pour la gestion des fichiers system.xml dans magento 1 .
Ces fichiers peuvent utiliser souvent les éléments suivants :

Source Model
Frontend Model
Backend Model

Source Model

Il doivent être utilisés pour des champs de types « select » ou « multiselect »

Ex :

<demo_field_source translate="label">
    <label>Demo Field source model</label>
    <frontend_type>select</frontend_type>
    <!-- Définition de la source -->
    <source_model>adminhtml/system_config_source_yesno</source_model>
    <!-- Fin Définition de la source -->
    <sort_order>1</sort_order>
    <show_in_default>1</show_in_default>
    <show_in_website>1</show_in_website>
    <show_in_store>1</show_in_store>
</demo_field_source>

Les plus utiles à retenir sont les suivants :

adminhtml/system_config_source_yesno ( Oui / Non )
adminhtml/system_config_source_country (Liste des pays )
adminhtml/system_config_source_cms_page ( Liste des pages cms )
adminhtml/system_config_source_email_template ( Listes des emails transactionnels )

Liste complète :

adminhtml/system_config_source_yesno
adminhtml/system_config_source_admin_page
adminhtml/system_config_source_catalog_gridPerPage
adminhtml/system_config_source_catalog_listMode
adminhtml/system_config_source_catalog_listPerPage
adminhtml/system_config_source_catalog_listSort
adminhtml/system_config_source_catalog_search_type
adminhtml/system_config_source_catalog_timeFormat
adminhtml/system_config_source_checktype
adminhtml/system_config_source_cms_page
adminhtml/system_config_source_cms_wysiwyg_enabled
adminhtml/system_config_source_country
adminhtml/system_config_source_cron_frequency
adminhtml/system_config_source_currency
adminhtml/system_config_source_currency_service
adminhtml/system_config_source_customer_address_type
adminhtml/system_config_source_customer_forgotpassword
adminhtml/system_config_source_customer_group
adminhtml/system_config_source_design_robots
adminhtml/system_config_source_email_identity
adminhtml/system_config_source_email_method
adminhtml/system_config_source_email_smtpauth
adminhtml/system_config_source_email_template
adminhtml/system_config_source_enabledisable
adminhtml/system_config_source_frequency
adminhtml/system_config_source_locale
adminhtml/system_config_source_locale_currency_all
adminhtml/system_config_source_locale_timezone
adminhtml/system_config_source_locale_weekdaycodes
adminhtml/system_config_source_locale_weekdaycodes
adminhtml/system_config_source_locale_weekdays
adminhtml/system_config_source_nooptreq
adminhtml/system_config_source_notification_frequency
adminhtml/system_config_source_order_status_new
adminhtml/system_config_source_order_status_newprocessing
adminhtml/system_config_source_order_status_processing
adminhtml/system_config_source_payment_allspecificcountries
adminhtml/system_config_source_payment_cctype
adminhtml/system_config_source_price_scope
adminhtml/system_config_source_price_step
adminhtml/system_config_source_product_thumbnail
adminhtml/system_config_source_reports_scope
adminhtml/system_config_source_security_domainpolicy
adminhtml/system_config_source_shipping_allspecificcountries
adminhtml/system_config_source_shipping_flatrate
adminhtml/system_config_source_shipping_tablerate
adminhtml/system_config_source_shipping_taxclass
adminhtml/system_config_source_storage_media_database
adminhtml/system_config_source_storage_media_storage
adminhtml/system_config_source_store
adminhtml/system_config_source_tax_apply_on
adminhtml/system_config_source_tax_basedon
adminhtml/system_config_source_watermark_position
adminhtml/system_config_source_web_redirect
adminhtml/system_config_source_yesno
adminhtml/system_config_source_yesnocustom
backup/config_source_type
captcha/config_font
captcha/config_form_backend
captcha/config_form_frontend
captcha/config_mode
catalog/product_attribute_source_msrp_type
cataloginventory/source_backorders
checkout/config_source_cart_summary
configurableswatches/system_config_source_catalog_product_configattribute
configurableswatches/system_config_source_catalog_product_configattribute_select
customer/config_share
downloadable/system_config_source_contentdisposition
downloadable/system_config_source_orderitemstatus
googleanalytics/system_config_source_type
googlebase/source_accounttype
googlebase/source_country
log/adminhtml_system_config_source_loglevel
pagecache/system_config_source_controls
paygate/authorizenet_source_cctype
paygate/authorizenet_source_cctype
paygate/authorizenet_source_paymentAction
payment/source_invoice
paypal/config::getApiAuthenticationMethods
paypal/config::getExpressCheckoutBASignupOptions
paypal/config::getExpressCheckoutButtonFlavors
paypal/config::getExpressCheckoutSolutionTypes
paypal/config::getPayflowproCcTypesAsOptionArray
paypal/config::getWppCcTypesAsOptionArray
paypal/config::getWppPeCcTypesAsOptionArray
paypal/system_config_source_bmlPosition::getBmlPositionsCCP
paypal/system_config_source_bmlPosition::getBmlPositionsCheckout
paypal/system_config_source_bmlPosition::getBmlPositionsCPP
paypal/system_config_source_bmlPosition::getBmlPositionsHP
paypal/system_config_source_bmlSize::getBmlSizeCCPC
paypal/system_config_source_bmlSize::getBmlSizeCCPS
paypal/system_config_source_bmlSize::getBmlSizeCheckoutC
paypal/system_config_source_bmlSize::getBmlSizeCheckoutN
paypal/system_config_source_bmlSize::getBmlSizeCPPC
paypal/system_config_source_bmlSize::getBmlSizeCPPN
paypal/system_config_source_bmlSize::getBmlSizeHPH
paypal/system_config_source_bmlSize::getBmlSizeHPS
paypal/system_config_source_buyerCountry
paypal/system_config_source_fetchingSchedule
paypal/system_config_source_logo
paypal/system_config_source_merchantCountry
paypal/system_config_source_paymentActions
paypal/system_config_source_paymentActions_express
paypal/system_config_source_requireBillingAddress
paypal/system_config_source_urlMethod
paypal/system_config_source_yesnoShortcut
salesrule/system_config_source_coupon_format
shipping/source_handlingAction
shipping/source_handlingType
tax/system_config_source_algorithm
tax/system_config_source_apply
tax/system_config_source_priceType
tax/system_config_source_tax_country
tax/system_config_source_tax_display_type
tax/system_config_source_tax_region
usa/shipping_carrier_abstract_source_mode
usa/shipping_carrier_abstract_source_requesttype
usa/shipping_carrier_dhl_international_source_contenttype
usa/shipping_carrier_dhl_international_source_method_doc
usa/shipping_carrier_dhl_international_source_method_freedoc
usa/shipping_carrier_dhl_international_source_method_freenondoc
usa/shipping_carrier_dhl_international_source_method_nondoc
usa/shipping_carrier_dhl_international_source_method_size
usa/shipping_carrier_dhl_international_source_method_unitofmeasure
usa/shipping_carrier_dhl_source_dutypaymenttype
usa/shipping_carrier_dhl_source_freemethod
usa/shipping_carrier_dhl_source_method
usa/shipping_carrier_dhl_source_protection_rounding
usa/shipping_carrier_dhl_source_protection_value
usa/shipping_carrier_dhl_source_shipmenttype
usa/shipping_carrier_fedex_source_dropoff
usa/shipping_carrier_fedex_source_freemethod
usa/shipping_carrier_fedex_source_method
usa/shipping_carrier_fedex_source_packaging
usa/shipping_carrier_fedex_source_unitofmeasure
usa/shipping_carrier_ups_source_container
usa/shipping_carrier_ups_source_destType
usa/shipping_carrier_ups_source_freemethod
usa/shipping_carrier_ups_source_method
usa/shipping_carrier_ups_source_originShipment
usa/shipping_carrier_ups_source_pickup
usa/shipping_carrier_ups_source_type
usa/shipping_carrier_ups_source_unitofmeasure
usa/shipping_carrier_usps_source_container
usa/shipping_carrier_usps_source_freemethod
usa/shipping_carrier_usps_source_machinable
usa/shipping_carrier_usps_source_method
usa/shipping_carrier_usps_source_size
weee/config_source_display
weee/config_source_fpt_tax
wishlist/config_source_summary

Frontend Model :

Le frontend model est un block de template magento et qui permets de gérer un affichage particulier pour l’élément de configuration.…

Magento : Liste des ressources utilisables dans system.xml Lire la suite »

Pas de commentaires

Magento : Créer une commande via l’api

23 juillet 2018 / herve / Magento

J’ai récemment eut à créer des commandes Magento via l’api et j’ai rencontré pas mal de difficultés, j’en profite pour condenser l’ensemble du processus dans cet article 🙂

Voici un script qui permettra de créer une commande Magento à partir de l’api Soap de Magento ( à la fois avec la version api V1 et api V2 )
Cet exemple a été réalisé sur un Magento 1.9.3.x de démonstration utilisant les samples data Magento.

N’hésitez pas à consulter la documentation officielle des api, si des points ne sont pas assez clairs : https://devdocs.magento.com/guides/m1x/api/soap/introduction.html

Le script part des postulats suivants :

Passage de commande pour un client existant
Avec une adresse de facturation par défaut de renseignée
Les adresses de livraison et de facturation seront similaires.
Un accès à l’api avec tous les accès nécessaires existe sur le site magento de destination.

Les actions effectuées par le script sont les suivantes :

Login à l’api
Récupération de l’identifiant du client à partir de son email
Récupération de l’identifiant de l’adresse de facturation/livraison du client
Création d’un panier
Assignation du client au panier
Assignation des adresses du client au panier
Ajout de produits au panier
1. Produit simple
2. Produit configurable
3. Produit groupé
4. Produit Bundle
Récupération des modes de livraison disponibles pour le panier
Assignation du mode de livraison du panier
Récupération des modes de paiement disponibles pour le panier
Assignation du mode de paiement du panier
Transformation panier en commande

Voir le script complet pour l’api V1
Voir le script complet pour l’api V2

Avant de vous montrer le script complet voici un focus sur les éléments à comprendre

Ajout des produits au panier

En fonction du type de produit à ajouter au panier , les informations à envoyer ne seront pas les mêmes.…

Magento : Créer une commande via l’api Lire la suite »

Pas de commentaires