Documentazione Commerce Guida di Commerce su infrastruttura Cloud

Gestione estensioni

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:
Cloud
Estensioni

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:

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 file composer.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 comando `composer install` legge il file `composer.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-terminal
`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 file config.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.

recommendation-more-help

05f2f56e-ac5d-4931-8cdb-764e60e16f26