Installer une extension
Le code qui étend ou personnalise le comportement d’Adobe Commerce et de Magento Open Source est appelé extension. Vous pouvez éventuellement regrouper et distribuer des extensions sur le Commerce Marketplace ou un autre système de distribution d’extension.
Les extensions incluent :
- Modules (extension des fonctionnalités Adobe Commerce et Magento Open Source)
- Thèmes (modifiez l’aspect de votre storefront et de votre administrateur)
- Packages de langue (localisez le storefront et l’administrateur)
composer.json
et notez les valeurs de "name"
et "version"
.Avant l’installation, vous pouvez :
-
Sauvegardez votre base.
-
Activer le mode de maintenance :
code language-bash bin/magento maintenance:enable
Pour installer une extension, vous devez :
-
Obtenez une extension du Commerce Marketplace ou d’un autre développeur d’extensions.
-
Si vous installez une extension à partir du Commerce Marketplace, assurez-vous que la variable
repo.magento.com
existe dans votrecomposer.json
fichier :code language-bash "repositories": [ { "type": "composer", "url": "https://repo.magento.com/" } ]
-
Obtenez le nom et la version du compositeur de l’extension.
-
Mettez à jour le
composer.json
dans votre projet avec le nom et la version de l’extension. -
Vérifiez que l’extension est installée correctement.
-
Activez et configurez l’extension.
Obtention du nom et de la version du compositeur d’extension
Si vous connaissez déjà le nom et la version du compositeur de l’extension, ignorez cette étape et continuez avec Mettez à jour votre composer.json
fichier.
Pour obtenir le nom et la version du compositeur de l’extension à partir du Commerce Marketplace :
-
Connexion à Commerce Marketplace avec le nom d’utilisateur et le mot de passe que vous avez utilisés pour acheter l’extension.
-
Dans le coin supérieur droit, cliquez sur Votre nom > Mon profil.
-
Cliquez sur Mes achats.
-
Recherchez l’extension à installer, puis cliquez sur Détails techniques.
composer.json
fichier .Mise à jour du fichier du compositeur
Ajoutez le nom et la version de l’extension à votre composer.json
fichier :
-
Accédez au répertoire de votre projet et mettez à jour votre
composer.json
fichier .code language-bash composer require <component-name>:<version>
Par exemple,
code language-bash composer require j2t/module-payplug:2.0.2
-
Saisissez votre clés d’authentification. Votre clé publique est votre nom d’utilisateur ; votre clé privée est votre mot de passe.
-
Attendez que le compositeur termine la mise à jour des dépendances de votre projet et assurez-vous qu’il n’y a aucune erreur :
code language-terminal Updating dependencies (including require-dev) Package operations: 1 install, 0 updates, 0 removals - Installing j2t/module-payplug (2.0.2): Downloading (100%) Writing lock file Generating autoload files
Vérification de l’extension
Pour vérifier que l’extension est installée correctement, exécutez la commande suivante :
bin/magento module:status J2t_Payplug
Par défaut, l’extension est probablement désactivée :
Module is disabled
Le nom de l’extension est au format <VendorName>_<ComponentName>
; il s’agit d’un format différent du nom du compositeur. Utilisez ce format pour activer l’extension. Si vous n’êtes pas sûr du nom de l’extension, exécutez :
bin/magento module:status
Recherchez l’extension sous "Liste des modules désactivés".
Activation de l’extension
Certaines extensions ne fonctionnent pas correctement, sauf si vous effacez d’abord les fichiers d’affichage statique générés. Utilisez la variable --clear-static-content
pour effacer les fichiers d’affichage statique lorsque vous activez une extension.
-
Activez l’extension et effacez les fichiers de vue statique :
code language-bash bin/magento module:enable J2t_Payplug --clear-static-content
Vous devriez voir la sortie suivante :
code language-terminal The following modules have been enabled: - J2t_Payplug To make sure that the enabled modules are properly registered, run 'setup:upgrade'. Cache cleared successfully. Generated classes cleared successfully. Please run the 'setup:di:compile' command to generate classes. Generated static view files cleared successfully.
-
Enregistrez l’extension :
code language-bash bin/magento setup:upgrade
-
Recompiler votre projet : en mode de production, vous pouvez recevoir un message indiquant "Veuillez réexécuter la commande de compilation du Magento". L’application ne vous invite pas à exécuter la commande compile en mode Développeur.
code language-bash bin/magento setup:di:compile
-
Vérifiez que l’extension est activée :
code language-bash bin/magento module:status J2t_Payplug
La sortie doit normalement s’afficher pour vérifier que l’extension n’est plus désactivée :
code language-terminal Module is enabled
-
Nettoyez le cache :
code language-bash bin/magento cache:clean
-
Configurez l’extension dans Admin selon les besoins.
bin/magento cache:flush
.Mettre à niveau une extension
Pour mettre à jour ou mettre à niveau un module ou une extension :
-
Téléchargez le fichier mis à jour depuis Marketplace ou un autre développeur d’extensions. Prenez note du nom et de la version du module.
-
Exportez le contenu dans le répertoire racine de votre application.
-
S’il existe un module de compositeur pour le module, exécutez l’une des opérations suivantes.
Mise à jour par nom de module :
code language-bash composer update vendor/module-name
Mise à jour par version :
code language-bash composer require vendor/module-name ^x.x.x
-
Exécutez les commandes suivantes pour mettre à niveau, déployer et nettoyer le cache.
code language-bash bin/magento setup:upgrade --keep-generated
code language-bash bin/magento setup:static-content:deploy
code language-bash bin/magento cache:clean