Installare un’estensione

Il codice che estende o personalizza il comportamento di Adobe Commerce e del Magento Open Source è denominato estensione. Facoltativamente, puoi creare un pacchetto e distribuire estensioni sul Commerce Marketplace o un altro sistema di distribuzione delle estensioni.

Le estensioni includono:

• Moduli (estendere le funzionalità di Adobe Commerce e Magento Open Source)
• Temi (cambia l’aspetto della vetrina e dell’amministratore)
• Pacchetti di lingua (localizza la vetrina e Amministratore)

Prima dell'installazione, è possibile:

1. Eseguire il backup del database.

2. Abilita modalità di manutenzione:

   bin/magento maintenance:enable
   

Per installare un'estensione, è necessario:

1. Ottieni un’estensione da Commerce Marketplace o da un altro sviluppatore di estensioni.

2. Se installi un’estensione dalla Commerce Marketplace, assicurati che il repo.magento.com esiste nel tuo archivio composer.json file:

   "repositories": [
       {
           "type": "composer",
           "url": "https://repo.magento.com/"
       }
   ]
   

3. Ottieni il nome e la versione del Compositore dell’estensione.

4. Aggiornare il composer.json nel progetto con il nome e la versione dell’estensione.

5. Verifica che l’estensione sia installata correttamente.

6. Abilita e configura l'estensione.

Ottieni il nome e la versione del Compositore estensioni

Se conosci già il nome e la versione del Compositore dell'estensione, salta questo passaggio e continua con Aggiorna il tuo composer.json file.

Per ottenere il nome e la versione del Compositore dell'estensione dalla Commerce Marketplace:

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

2. Nell’angolo superiore destro, fai clic su Il tuo nome > Il mio profilo.

   

3. Clic I miei acquisti.

   

4. Trova l’estensione da installare e fai clic su Dettagli tecnici.

   

Aggiornare il file Composer

Aggiungi il nome e la versione dell'estensione al tuo composer.json file:

1. Vai alla directory del progetto e aggiorna la composer.json file.

   composer require <component-name>:<version>
   

   Ad esempio:

   composer require j2t/module-payplug:2.0.2
   

2. Immetti il chiavi di autenticazione. La chiave pubblica è il nome utente; la chiave privata è la password.

3. Attendi che Composer completi l’aggiornamento delle dipendenze del progetto e assicurati che non siano presenti errori:

   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
   

Verificare l’estensione

Per verificare che l’estensione sia installata correttamente, esegui il seguente comando:

bin/magento module:status J2t_Payplug

Per impostazione predefinita, l’estensione è probabilmente disabilitata:

Module is disabled

Il nome dell’estensione è nel formato <VendorName>_<ComponentName>: formato diverso dal nome del Compositore. Utilizza questo formato per abilitare l'estensione. Se non sei sicuro del nome dell’estensione, esegui:

bin/magento module:status

E cerca l’estensione in "Elenco dei moduli disabilitati".

Abilitare l’estensione

Alcune estensioni non funzionano correttamente a meno che non si cancellino prima i file di visualizzazione statica generati. Utilizza il --clear-static-content per cancellare i file della vista statica quando abiliti un’estensione.

1. Abilita l’estensione e cancella i file della vista statica:

   bin/magento module:enable J2t_Payplug --clear-static-content
   

   Dovresti visualizzare il seguente output:

   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.
   

2. Registra l'estensione:

   bin/magento setup:upgrade
   

3. Ricompilare il progetto: in modalità di produzione, è possibile che venga visualizzato un messaggio indicante "Esegui nuovamente il comando di compilazione del Magento". L'applicazione non richiede di eseguire il comando di compilazione in modalità Sviluppatore.

   bin/magento setup:di:compile
   

4. Verifica che l’estensione sia abilitata:

   bin/magento module:status J2t_Payplug
   

   Dovresti vedere l’output che verifica che l’estensione non sia più disabilitata:

   Module is enabled
   

5. Pulisci la cache:

   bin/magento cache:clean
   

6. Configura l'estensione in Admin secondo necessità.

Aggiornare un’estensione

Per aggiornare un modulo o un’estensione:

1. Scarica il file aggiornato da Marketplace o da un altro sviluppatore di estensioni. Prendi nota del nome e della versione del modulo.

2. Esporta il contenuto nella directory principale dell’applicazione.

3. Se esiste un pacchetto Compositore per il modulo, esegui una delle seguenti operazioni.

   Nome aggiornamento per modulo:

   composer update vendor/module-name
   

   Aggiornamento per versione:

   composer require vendor/module-name ^x.x.x
   

4. Esegui i seguenti comandi per aggiornare, distribuire e pulire la cache.

   bin/magento setup:upgrade --keep-generated
   

   bin/magento setup:static-content:deploy
   

   bin/magento cache:clean
   

Risorse Business.Adobe.com