Gestione estensioni
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.
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:
-
Accedi a Commerce Marketplace con il nome utente e la password utilizzati per acquistare il componente.
-
Nell'angolo in alto a destra, fai clic sul tuo nome utente e seleziona Il mio profilo.
-
Nella pagina Il mio account, fai clic su I miei acquisti.
-
Nella pagina I miei acquisti, seleziona un modulo acquistato e fai clic su Dettagli tecnici.
-
Fai clic su Copia per copiare Component name negli Appunti.
-
Aprire un editor di testo e incollare il nome del componente e aggiungere un carattere due punti (
:
). -
In Dettagli tecnici, fai clic su Copia per copiare Component version negli Appunti.
-
Nell’editor di testo, aggiungi il numero di versione al nome del componente dopo i due punti. Ad esempio:
code language-text extension-name/magento2:1.0.1
Installare un’estensione
L’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:
-
Sulla workstation locale, passa alla directory del progetto.
-
Creare o estrarre un ramo di sviluppo. Vedi diramazione.
-
Utilizzando il nome e la versione del Compositore, aggiungere l'estensione alla sezione
require
del filecomposer.json
.code language-bash composer require <extension-name>:<version> --no-update
-
Aggiornare le dipendenze del progetto.
code language-bash composer update
-
Aggiungi, conferma e invia modifiche al codice.
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 Durante l'installazione di un'estensione, è necessario includere il file composer.lock
quando si inviano le modifiche al codice nell'ambiente remoto. Il comandocomposer install
legge il filecomposer.lock
per abilitare le dipendenze definite nell'ambiente remoto. -
Al termine della build e della distribuzione, utilizza un SSH per accedere all’ambiente remoto e verificare che l’estensione sia installata.
code language-bash bin/magento module:status <extension-name>
Un nome di estensione utilizza il formato:
<VendorName>_<ComponentName>
.Risposta di esempio:
code language-none 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:
-
Sulla workstation locale, passa alla directory del progetto.
-
Attivare o disattivare un modulo. Il comando
module
aggiorna il fileconfig.php
con lo stato richiesto del modulo.Abilita un modulo.
code language-bash bin/magento module:enable <module-name>
Disattiva un modulo.
code language-bash bin/magento module:disable <module-name>
-
Se hai attivato un modulo, utilizza
ece-tools
per aggiornare la configurazione.code language-bash ./vendor/bin/ece-tools module:refresh
-
Verifica lo stato di un modulo.
code language-bash bin/magento module:status <module-name>
-
Aggiungi, conferma e invia modifiche al codice.
code language-bash git add -A
code language-bash git commit -m "Disable <extension-name>"
code language-bash git push origin <branch-names>
Aggiornare un’estensione
Prima di continuare, è necessario il nome e la versione del Compositore per l’estensione. Inoltre, verifica che l’estensione sia compatibile con il progetto e la versione di Adobe Commerce. In particolare, controlla la versione PHP richiesta prima di iniziare.
Per aggiornare un'estensione:
-
Sulla workstation locale, passa alla directory del progetto.
-
Creare o estrarre un ramo di sviluppo. Vedi diramazione.
-
Aprire il file
composer.json
in un editor di testo. -
Individua l’estensione e aggiorna la versione.
-
Salva le modifiche e esci dall’editor di testo.
-
Aggiornare le dipendenze del progetto.
code language-bash composer update
-
Aggiungi, esegui il commit e invia le modifiche al codice.
code language-bash git add -A
code language-bash git commit -m "Update <extension-name>"
code language-bash git push origin <branch-names>
In caso di errori, vedere Ripristino da errore del componente. Per ulteriori informazioni sull'utilizzo delle estensioni con Adobe Commerce, consulta Estensioni nella Guida per l'amministratore.