DocumentazioneCommerceGuida all’installazione

Gestire le estensioni di terze parti

Last update: Mon Nov 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore

Il codice che estende o personalizza il comportamento di Adobe Commerce è chiamato estensione. Facoltativamente, è possibile creare un pacchetto e distribuire estensioni sulla Commerce Marketplace o su un altro sistema di distribuzione delle estensioni.

Le estensioni includono:

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

Questo argomento spiega come utilizzare l'interfaccia della riga di comando per gestire le estensioni di terze parti acquistate da Commerce Marketplace per progetti locali. Per i progetti di infrastruttura cloud, consulta Gestione estensioni.

È possibile utilizzare la stessa procedura per installare l'estensione any; tutto ciò che serve è il nome e la versione del Compositore dell'estensione. Per trovarlo, aprire il file composer.json dell'estensione e prendere nota dei valori per "name" e "version".

Installa

Prima dell'installazione, è possibile:

  1. Eseguire il backup del database.

  2. Abilita modalità di manutenzione:

    code language-bash 
    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 si installa un'estensione dalla Commerce Marketplace, verificare che l'archivio repo.magento.com esista nel file composer.json:

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

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

  4. Aggiorna il file 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 informazioni sull’estensione

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

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 fare clic su Nome > Profilo.

    Accedi al tuo account Marketplace

  3. Fai clic su I miei acquisti.

    Cronologia acquisti Marketplace

  4. Trova l’estensione da installare e annota il nome e la versione del componente.

    I dettagli tecnici mostrano il nome del Compositore dellestensione

TIP
In alternativa, è possibile trovare il nome del Compositore e la versione dell'estensione any (acquistata su Commerce Marketplace o altrove) nel file composer.json dell'estensione.

Aggiorna dipendenze compositore

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

  1. Passa alla directory del progetto e aggiorna il file composer.json.

    code language-bash 
    composer require <component-name>:<version>

    Ad esempio:

    code language-bash 
    composer require j2t/module-payplug:2.0.2

  2. Immetti le 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:

    code language-none 
    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'installazione

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>, che è 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".

Abilita

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

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

    code language-bash 
    bin/magento module:enable J2t_Payplug --clear-static-content

    Dovresti visualizzare il seguente output:

    code language-none 
    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:

    code language-bash 
    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.

    code language-bash 
    bin/magento setup:di:compile

  4. Verifica che l’estensione sia abilitata:

    code language-bash 
    bin/magento module:status J2t_Payplug

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

    code language-none 
    Module is enabled

  5. Pulisci la cache:

    code language-bash 
    bin/magento cache:clean

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

TIP
Se si verificano errori durante il caricamento della vetrina in un browser, utilizzare il comando seguente per cancellare la cache: bin/magento cache:flush.

Aggiorna

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:

    code language-bash 
    composer update vendor/module-name

    Aggiornamento per versione:

    code language-bash 
    composer require vendor/module-name ^x.x.x

  4. Esegui i seguenti comandi per aggiornare, distribuire e pulire la 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

Disinstalla

Contatta il fornitore dell’estensione per istruzioni su come rimuovere un’estensione di terze parti. Le istruzioni devono contenere le seguenti informazioni:

  • Ripristinare le modifiche alla tabella del database
  • Ripristinare le modifiche ai dati del database
  • Quali file rimuovere o ripristinare
CAUTION
Esegui i passaggi per la disinstallazione in un ambiente non di produzione first ed esegui un test completo prima di implementare nell'ambiente di produzione.

Le istruzioni seguenti forniscono informazioni generali sulla disinstallazione di estensioni di terze parti:

  1. Rimuovi l’estensione dall’archivio dei progetti Adobe Commerce.

    • Per le estensioni basate su Compositore, rimuovere l'estensione dal file Adobe Commerce composer.json.

      code language-bash 
      composer remove <component-name>

    • Per le estensioni non basate su Compositore, rimuovi i file fisici dall’archivio dei progetti Adobe Commerce.

      code language-bash 
      rm -rf app/code/<vendor-name>/<component-name>

  2. Se il file config.php è incluso nel controllo del codice sorgente nell'archivio dei progetti Adobe Commerce, rimuovere l'estensione dal file config.php.

  3. Eseguire il test del database locale per verificare che le istruzioni fornite dal fornitore funzionino come previsto.

  4. Verifica che l’estensione sia disabilitata correttamente e che il sito web funzioni come previsto nell’ambiente di staging.

  5. Implementa le modifiche nell’ambiente di produzione.

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995