Gestione estensioni

Ultimo aggiornamento: 31 gennaio 2025

Creato per:

  • Amministratore
  • Sviluppatore

Puoi estendere le funzionalità dell'applicazione Adobe Commerce aggiungendo un'estensione dalla Commerce Marketplace. Ad esempio, puoi aggiungere un tema per cambiare l’aspetto della vetrina, oppure un pacchetto per la lingua per localizzare la vetrina e l’amministratore.

NOTE
Per evitare problemi di installazione, tutti gli acquisti Marketplace devono essere completati utilizzando lo stesso account (MAGEID) proprietario del progetto cloud.

Nome del compositore di un’estensione

Anche se questa sezione illustra come ottenere il nome e la versione del Compositore da Commerce Marketplace, è possibile trovare il nome e la versione del modulo any nel file Compositore del modulo. Aprire il file composer.json in un editor di testo e prendere nota dei valori "name" e "version".

Per ottenere il nome del Compositore di un modulo dalla Commerce Marketplace:

  1. Accedi a Commerce Marketplace con il nome utente e la password utilizzati per acquistare il componente.

  2. Nell'angolo in alto a destra, fai clic sul tuo nome utente e seleziona Il mio profilo.

    Accedi al tuo account Marketplace

  3. Nella pagina Il mio account, fai clic su I miei acquisti.

    Cronologia acquisti Marketplace

  4. Nella pagina I miei acquisti, seleziona un modulo acquistato e fai clic su Dettagli tecnici.

  5. Fai clic su Copia per copiare Component name negli Appunti.

  6. Aprire un editor di testo e incollare il nome del componente e aggiungere un carattere due punti (:).

  7. In Dettagli tecnici, fai clic su Copia per copiare Component version negli Appunti.

  8. Nell’editor di testo, aggiungi il numero di versione al nome del componente dopo i due punti. Ad esempio:

    extension-name/magento2:1.0.1

Installare un’estensione

Adobe consiglia di lavorare in un ramo di sviluppo quando aggiungi un’estensione all’implementazione. Durante l'installazione di un'estensione, il nome (<VendorName>_<ComponentName>) viene inserito automaticamente nel file app/etc/config.php. Non è necessario modificare direttamente il file.

Per installare un'estensione:

  1. Sulla workstation locale, passa alla directory del progetto.

  2. Creare o estrarre un ramo di sviluppo. Vedi diramazione.

  3. Utilizzando il nome e la versione del Compositore, aggiungere l'estensione alla sezione require del file composer.json.

    composer require <extension-name>:<version> --no-update

  4. Aggiornare le dipendenze del progetto.

    composer update

  5. Aggiungi, conferma e invia modifiche al codice.

    git add -A

    git commit -m "Install <extension-name>"

    git push origin <branch-name>
    WARNING
    Durante l'installazione di un'estensione, è necessario includere il file composer.lock quando si inviano le modifiche al codice nell'ambiente remoto. Il comando composer install legge il file composer.lock per abilitare le dipendenze definite nell'ambiente remoto.

  6. Al termine della build e della distribuzione, utilizza un SSH per accedere all’ambiente remoto e verificare che l’estensione sia installata.

    bin/magento module:status <extension-name>

    Un nome di estensione utilizza il formato: <VendorName>_<ComponentName>.

    Risposta di esempio:

    Module is enabled

    Se si verificano errori di distribuzione, vedere errore di distribuzione dell'estensione.

Gestione estensioni

Quando aggiungi un’estensione utilizzando Compositore, il processo di distribuzione la abilita automaticamente. Se l'estensione è già installata, è possibile attivarla o disattivarla utilizzando CLI. Durante la gestione delle estensioni, utilizzare il formato: <VendorName>_<ComponentName>

Non abilitare o disabilitare mai un'estensione durante l'accesso agli ambienti remoti.

Per abilitare o disabilitare un'estensione:

  1. Sulla workstation locale, passa alla directory del progetto.

  2. Attivare o disattivare un modulo. Il comando module aggiorna il file config.php con lo stato richiesto del modulo.

    Abilita un modulo.

    bin/magento module:enable <module-name>

    Disattiva un modulo.

    bin/magento module:disable <module-name>

  3. Se hai attivato un modulo, utilizza ece-tools per aggiornare la configurazione.

    ./vendor/bin/ece-tools module:refresh

  4. Verifica lo stato di un modulo.

    bin/magento module:status <module-name>

  5. Aggiungi, conferma e invia modifiche al codice.

    git add -A

    git commit -m "Disable <extension-name>"

    git push origin <branch-names>