Gestion des extensions
Vous pouvez étendre les fonctionnalités de votre application Adobe Commerce en ajoutant une extension à partir du Commerce Marketplace 🔗. Par exemple, vous pouvez ajouter un thème pour modifier l’aspect de votre storefront ou vous pouvez ajouter un package de langue pour localiser votre storefront et votre administrateur.
Nom du compositeur d’une extension
Bien que cette section explique comment obtenir le nom et la version du compositeur d’une extension à partir du Commerce Marketplace, vous pouvez retrouver le nom et la version du module any dans le fichier Compositeur du module. Ouvrez le fichier composer.json
dans un éditeur de texte et notez les valeurs "name"
et "version"
.
Pour obtenir le nom du compositeur d’un module à partir du Commerce Marketplace :
-
Connectez-vous au Commerce Marketplace 🔗 avec le nom d'utilisateur et le mot de passe que vous avez utilisés pour acheter le composant.
-
Dans le coin supérieur droit, cliquez sur votre nom d’utilisateur et sélectionnez Mon profil.
-
Sur la page Mon compte, cliquez sur Mes achats.
-
Sur la page Mes achats, sélectionnez le module que vous avez acheté, puis cliquez sur Détails techniques.
-
Cliquez sur Copier pour copier le Component name dans le presse-papiers.
-
Ouvrez un éditeur de texte, collez le nom du composant et ajoutez un caractère deux-points (
:
). -
Dans Détails techniques, cliquez sur Copier pour copier le Component version dans le presse-papiers.
-
Dans l’éditeur de texte, ajoutez le numéro de version au nom du composant après les deux-points. Par exemple :
code language-text extension-name/magento2:1.0.1
Installation d’une extension
Adobe recommande de travailler dans une branche de développement lors de l’ajout d’une extension à votre implémentation. Lors de l’installation d’une extension, le nom de l’extension (<VendorName>_<ComponentName>
) est automatiquement inséré dans le fichier app/etc/config.php
. Il n’est pas nécessaire de modifier directement le fichier.
Pour installer une extension :
-
Sur votre station de travail locale, accédez au répertoire du projet.
-
Créez ou extrayez une branche de développement. Voir embranchement.
-
À l’aide du nom et de la version du compositeur, ajoutez l’extension à la section
require
du fichiercomposer.json
.code language-bash composer require <extension-name>:<version> --no-update
-
Mettez à jour les dépendances du projet.
code language-bash composer update
-
Ajout, validation et modifications de code push.
code language-bash git add -A
code language-bash git commit -m "Install <extension-name>"
code language-bash git push origin <branch-name>
note warning WARNING Lors de l’installation d’une extension, vous devez inclure le fichier composer.lock
lorsque vous poussez des modifications de code vers l’environnement distant. La commandecomposer install
lit le fichiercomposer.lock
pour activer les dépendances définies dans l’environnement distant. -
Une fois la création et le déploiement terminés, utilisez un SSH pour vous connecter à l’environnement distant et vérifier l’extension installée.
code language-bash bin/magento module:status <extension-name>
Un nom d’extension utilise le format suivant :
<VendorName>_<ComponentName>
.Exemple de réponse :
code language-none Module is enabled
Si vous rencontrez des erreurs de déploiement, consultez échec du déploiement de l’extension.
Gestion des extensions
Lorsque vous ajoutez une extension à l’aide du compositeur, le processus de déploiement active automatiquement l’extension. Si l’extension est déjà installée, vous pouvez l’activer ou la désactiver à l’aide de l’interface de ligne de commande. Lors de la gestion des extensions, utilisez le format suivant : <VendorName>_<ComponentName>
N’activez ou ne désactivez jamais une extension lorsque vous êtes connecté aux environnements distants.
Pour activer ou désactiver une extension :
-
Sur votre station de travail locale, accédez au répertoire du projet.
-
Activer ou désactiver un module. La commande
module
met à jour le fichierconfig.php
avec l’état demandé du module .Activez un module.
code language-bash bin/magento module:enable <module-name>
Désactivez un module.
code language-bash bin/magento module:disable <module-name>
-
Si vous avez activé un module, utilisez
ece-tools
pour actualiser la configuration.code language-bash ./vendor/bin/ece-tools module:refresh
-
Vérification de l'état d'un module.
code language-bash bin/magento module:status <module-name>
-
Ajout, validation et modifications de code push.
code language-bash git add -A
code language-bash git commit -m "Disable <extension-name>"
code language-bash git push origin <branch-names>
Mettre à niveau une extension
Avant de continuer, vous avez besoin du nom et de la version du compositeur pour l’extension. Vérifiez également que l’extension est compatible avec votre projet et la version d’Adobe Commerce. En particulier, vérifiez la version PHP requise avant de commencer.
Pour mettre à jour une extension :
-
Sur votre station de travail locale, accédez au répertoire du projet.
-
Créez ou extrayez une branche de développement. Voir embranchement.
-
Ouvrez le fichier
composer.json
dans un éditeur de texte. -
Localisez votre extension et mettez à jour la version.
-
Enregistrez vos modifications et quittez l’éditeur de texte.
-
Mettez à jour les dépendances du projet.
code language-bash composer update
-
Ajouter, valider et transmettre vos modifications de code.
code language-bash git add -A
code language-bash git commit -m "Update <extension-name>"
code language-bash git push origin <branch-names>
Si vous rencontrez des erreurs, reportez-vous à la section Récupération après une défaillance de composant. Pour en savoir plus sur l’utilisation des extensions avec Adobe Commerce, voir Extensions dans le Guide d’administration.