DocumentationCommerceGuide de Commerce sur les infrastructures cloud

Gestion des extensions

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Administration
  • Développeur

Vous pouvez étendre les fonctionnalités de votre application Adobe Commerce en ajoutant une extension du Commerce Marketplace. Par exemple, vous pouvez ajouter un thème pour modifier l’aspect de votre vitrine, ou vous pouvez ajouter un module de langue pour localiser votre vitrine et votre administrateur.

NOTE
Pour éviter des problèmes d’installation, tous les achats Marketplace doivent être effectués à l’aide du même compte (MAGEID) propriétaire du projet cloud.

Nom du compositeur d’une extension

Bien que cette section explique comment obtenir le nom et la version du compositeur d’une extension depuis Commerce Marketplace, vous trouverez le nom et la version du module any dans le fichier du 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 :

  1. Connectez-vous à Commerce Marketplace avec le nom d’utilisateur et le mot de passe que vous avez utilisés pour acheter le composant.

  2. Dans le coin supérieur droit, cliquez sur votre nom d’utilisateur et sélectionnez Mon profil.

    Accéder à votre compte Marketplace

  3. Sur la page Mon compte, cliquez sur Mes achats.

    Historique des achats Marketplace

  4. Sur la page Mes achats, sélectionnez un module que vous avez acheté, puis cliquez sur Détails techniques.

  5. Cliquez sur Copier pour copier l’ Component name dans le Presse-papiers.

  6. Ouvrez un éditeur de texte, collez le nom du composant et ajoutez un caractère deux-points (:).

  7. Dans Technical Details, cliquez sur Copier pour copier l’élément Component version dans le Presse-papiers.

  8. Dans l’éditeur de texte, ajoutez le numéro de version au nom du composant après le signe deux-points. Par exemple :

    code language-text 
    extension-name/magento2:1.0.1

Installer une extension

Adobe recommande de travailler dans une branche de développement lors de l’ajout d’une extension à votre mise en oeuvre. 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 :

  1. Sur votre poste de travail local, modifiez le répertoire de votre projet.

  2. Créez ou extrayez une branche de développement. Voir branchement.

  3. À l’aide du nom et de la version du compositeur, ajoutez l’extension à la section require du fichier composer.json.

    code language-bash 
    composer require <extension-name>:<version> --no-update

  4. Mettez à jour les dépendances du projet.

    code language-bash 
    composer update

  5. Ajout, validation et modification du 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 les modifications de code dans l’environnement distant. La commande composer install lit le fichier composer.lock pour activer les dépendances définies dans l’environnement distant.

  6. Une fois la création et le déploiement terminés, utilisez un SSH pour vous connecter à l’environnement distant et vérifier que l’extension est installée.

    code language-bash 
    bin/magento module:status <extension-name>

    Un nom d’extension utilise le format : <VendorName>_<ComponentName>.

    Exemple de réponse :

    code language-none 
    Module is enabled

    Si vous rencontrez des erreurs de déploiement, reportez-vous à la section échec du déploiement de l'extension.

Gestion des extensions

Lorsque vous ajoutez une extension à l’aide de Composer, 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 : <VendorName>_<ComponentName>

Ne jamais activer ou désactiver une extension lors de la connexion aux environnements distants.

Pour activer ou désactiver une extension :

  1. Sur votre poste de travail local, modifiez le répertoire de votre projet.

  2. Activez ou désactivez un module. La commande module met à jour le fichier config.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>

  3. Si vous avez activé un module, utilisez ece-tools pour actualiser la configuration.

    code language-bash 
    ./vendor/bin/ece-tools module:refresh

  4. Vérifiez l’état d’un module.

    code language-bash 
    bin/magento module:status <module-name>

  5. Ajout, validation et modification du 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 poursuivre, 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 :

  1. Sur votre poste de travail local, modifiez le répertoire de votre projet.

  2. Créez ou extrayez une branche de développement. Voir branchement.

  3. Ouvrez le fichier composer.json dans un éditeur de texte.

  4. Recherchez votre extension et mettez à jour la version.

  5. Enregistrez vos modifications et quittez l’éditeur de texte.

  6. Mettez à jour les dépendances du projet.

    code language-bash 
    composer update

  7. Ajoutez, validez et poussez 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 de l’échec du composant. Pour plus d’informations sur l’utilisation des extensions avec Adobe Commerce, voir Extensions dans le Guide de l’administrateur.

recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26