Documentação Commerce Guia de instalação

Desinstalar temas

Última atualização: 18 de julho de 2024

Tópicos:

Criado para:

Experiente
Administrador
Desenvolvedor

Antes de usar esse comando, você deve saber o caminho relativo para o tema. Os temas estão localizados em um subdiretório de <magento_root>/app/design/<area name>. Você deve especificar o caminho para o tema que começa com a área, que é frontend (para temas de vitrine) ou adminhtml (para temas de administradores).

Por exemplo, o caminho para o tema Luma fornecido com o Adobe Commerce é frontend/Magento/luma.

Para obter mais informações sobre temas, consulte estrutura de tema.

Visão geral da desinstalação de temas

Esta seção discute como desinstalar um ou mais temas, incluindo, opcionalmente, o código do tema do sistema de arquivos. Você pode criar backups primeiro para poder restaurar os dados posteriormente.

Este comando desinstala somente temas especificados em composer.json; em outras palavras, temas fornecidos como pacotes do Composer. Se o tema não for um pacote do Composer, você deverá desinstalá-lo manualmente ao:

Atualizando as informações do nó parent em theme.xml para remover referências ao tema.
Removendo código de tema do sistema de arquivos.

Mais informações sobre herança de tema.

Desinstalar temas

Uso do comando:

bin/magento theme:uninstall [--backup-code] [-c|--clear-static-content] {theme path} ... {theme path}

Onde

{theme path} é o caminho relativo para o tema, começando com o nome da área. Por exemplo, o caminho para o tema em branco fornecido com o Adobe Commerce é frontend/Magento/blank.
--backup-code faz backup da base de código conforme discutido nos parágrafos seguintes.
--clear-static-content limpa os arquivos de exibição estáticos gerados, o que é necessário para fazer com que os arquivos de exibição estáticos sejam exibidos corretamente.

O comando executa as seguintes tarefas:

Verifica se os caminhos de tema especificados existem; caso contrário, o comando será encerrado.
Verifica se o tema é um pacote do Composer; caso contrário, o comando será encerrado.
Verifica dependências e encerra o comando se houver dependências não atendidas.

Para contornar isso, você pode desinstalar todos os temas ao mesmo tempo ou desinstalar o dependendo do tema primeiro.
Verifica se o tema não está sendo usado; se estiver sendo usado, o comando será encerrado.
Verifica se o tema não é a base do tema virtual; se for a base de um tema virtual, o comando é finalizado.
Coloca o armazenamento no modo de manutenção.
Se --backup-code for especificado, faça backup da base de código, excluindo os diretórios pub/static, pub/media e var.

O nome do arquivo de backup é var/backups/<timestamp>_filesystem.tgz

Você pode restaurar backups a qualquer momento usando o comando magento setup:rollback.
Remove temas da tabela do banco de dados theme.
Remover temas da base de código usando composer remove.
Limpa o cache.
Limpa classes geradas
Se --clear-static-content for especificado, limpa arquivos de exibição estáticos gerados.

Por exemplo, se você tentar desinstalar um tema do qual outro tema depende, a seguinte mensagem será exibida:

Cannot uninstall frontend/ExampleCorp/SampleModuleTheme because the following package(s) depend on it:
        ExampleCorp/sample-module-theme-depend

Uma alternativa é desinstalar ambos os temas ao mesmo tempo, como segue, fazendo backup da base de código:

bin/magento theme:uninstall frontend/ExampleCorp/SampleModuleTheme frontend/ExampleCorp/SampleModuleThemeDepend --backup-code

Mensagens semelhantes a esta são exibidas:

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

NOTE

Para desinstalar um tema de Administrador, você também deve removê-lo da configuração de injeção de dependência do seu componente, <component root directory>/etc/di.xml.

recommendation-more-help