Disinstalla temi
Prima di utilizzare questo comando, è necessario conoscere il percorso relativo del tema. I temi si trovano in una sottodirectory di <magento_root>/app/design/<area name>
. È necessario specificare il percorso del tema che inizia con l'area, che è frontend
(per i temi storefront) o adminhtml
(per i temi Admin).
Il percorso del tema Luma fornito con Adobe Commerce, ad esempio, è frontend/Magento/luma
.
Per ulteriori informazioni sui temi, vedere struttura tema.
Panoramica sulla disinstallazione dei temi
Questa sezione illustra come disinstallare uno o più temi, includendo facoltativamente il codice dei temi dal file system. È possibile creare prima i backup in modo da poter ripristinare i dati in un secondo momento.
Questo comando disinstalla solo temi specificati in composer.json
; in altre parole, temi forniti come pacchetti Composer. Se il tema non è un pacchetto Compositore, è necessario disinstallarlo manualmente:
-
Aggiornamento delle informazioni sul nodo
parent
intheme.xml
per rimuovere i riferimenti al tema. -
Rimozione del codice del tema dal file system.
Disinstalla temi
Utilizzo comando:
bin/magento theme:uninstall [--backup-code] [-c|--clear-static-content] {theme path} ... {theme path}
Dove
{theme path}
è il percorso relativo del tema, a partire dal nome dell'area. Il percorso del tema vuoto fornito con Adobe Commerce, ad esempio, èfrontend/Magento/blank
.--backup-code
esegue il backup della base di codice come descritto nei paragrafi seguenti.--clear-static-content
pulisce i file di visualizzazione statica generati, necessari per la corretta visualizzazione dei file di visualizzazione statica.
Il comando esegue le seguenti operazioni:
-
Verifica l'esistenza dei percorsi del tema specificati; in caso contrario, il comando termina.
-
Verifica che il tema sia un pacchetto Compositore; in caso contrario, il comando termina.
-
Controlla le dipendenze e termina il comando se sono presenti dipendenze non soddisfatte.
Per ovviare a questo problema, puoi disinstallare tutti i temi contemporaneamente oppure puoi disinstallare prima i a seconda del tema.
-
Verifica che il tema non sia utilizzato; se è utilizzato, il comando termina.
-
Verifica che il tema non sia la base del tema virtuale; se è la base di un tema virtuale, il comando termina.
-
Mette l'archivio in modalità di manutenzione.
-
Se si specifica
--backup-code
, eseguire il backup della codebase, escludendo le directorypub/static
,pub/media
evar
.Il nome del file di backup è
var/backups/<timestamp>_filesystem.tgz
È possibile ripristinare i backup in qualsiasi momento utilizzando il comando
magento setup:rollback
. -
Rimuove i temi dalla tabella del database
theme
. -
Rimuovere i temi dalla base di codice utilizzando
composer remove
. -
Pulisce la cache.
-
Pulisce le classi generate
-
Se si specifica
--clear-static-content
, pulisce file di visualizzazione statica generati.
Ad esempio, se tenti di disinstallare un tema da cui dipende un altro tema, viene visualizzato il seguente messaggio:
Cannot uninstall frontend/ExampleCorp/SampleModuleTheme because the following package(s) depend on it:
ExampleCorp/sample-module-theme-depend
Un'alternativa è quella di disinstallare entrambi i temi contemporaneamente come segue backup della base di codice:
bin/magento theme:uninstall frontend/ExampleCorp/SampleModuleTheme frontend/ExampleCorp/SampleModuleThemeDepend --backup-code
Messaggi simili alla seguente visualizzazione:
Code backup is starting...
Code backup filename: 1435261098_filesystem_code.tgz (The archive can be uncompressed with 7-Zip on Windows systems)
Code backup path: /var/www/html/magento2/var/backups/1435261098_filesystem_code.tgz
[SUCCESS]: Code backup completed successfully.Removing frontend/ExampleCorp/SampleModuleTheme, frontend/ExampleCorp/SampleModuleThemeDepend from database
Loading composer repositories with package information
Updating dependencies (including require-dev)
Removing frontend/ExampleCorp/SampleModuleTheme, frontend/ExampleCorp/SampleModuleThemeDepend from Magento codebase
- Removing ExampleCorp/sample-module-theme-depend (dev-master)
Removing ExampleCorp/SampleThemeDepend
- Removing ExampleCorp/sample-module-theme (dev-master)
Removing ExampleCorp/SampleTheme
Writing lock file
Generating autoload files
Cache cleared successfully.
Alert: Generated static view files were not cleared. You can clear them using the --clear-static-content option.
Failure to clear static view files might cause display issues in the Admin and storefront.
Disabling maintenance mode
<component root directory>/etc/di.xml
.