Como instalar uma extensão Magento 2: guia passo a passo para comerciantes

Você está tentando aprender como instalar uma extensão Magento 2? Você pode fazer isso de duas maneiras – usando Compositor ou um arquivo. Embora Adobe recomenda usar o Composer, ensinaremos as duas maneiras.

As etapas para instalar extensões Magento são semelhantes àquelas necessárias para instalar um tema Magento, com algumas diferenças cruciais.

Por exemplo, ao instalar um tema usando um arquivo, você deve colocar os arquivos do tema no aplicativo/design/frontend diretório. Por outro lado, ao instalar uma extensão Magento 2 usando um arquivo, você precisa colocar os arquivos no aplicativo/código diretório.

Você está pronto para aprender mais?

Aqui está o que abordaremos neste tutorial:

Tablet de Conteúdo

Como instalar uma extensão Magento 2

1. Faça upload dos arquivos de extensão do Magento 2 para o seu servidor.

2. Extraia o arquivo de extensão.

3. Verifique e copie os arquivos de extensão Magento para o aplicativo/código pasta.

4. Instale a extensão Magento 2 e verifique seu status.

5. Limpe o cache do Magento e desative o modo de manutenção.

Antes de mostrarmos como instalar uma extensão Magento 2, certifique-se de fazer backup do seu servidor, definir pré-instalar permissões de arquivohabilite o modo de desenvolvedor e coloque o Magento no modo de manutenção.

Também ajuda instalar a extensão em um servidor de teste ou ambiente de desenvolvimento local para verificar a compatibilidade da extensão.

Obtenha hospedagem Magento totalmente gerenciada

Acelere o potencial da sua loja, sem a tediosa manutenção

Etapa 1: faça upload dos arquivos de extensão do Magento 2 para o seu servidor

Faça login no seu servidor Magento como proprietário do sistema de arquivos.

Faça upload do arquivo compactado para uma nova pasta dentro do diretório inicial do usuário usando SSH ou SFTP.

Etapa 2: extraia o arquivo de extensão .zip

Extraia o arquivo de extensão em uma nova pasta chamada extensão usando:

 $ unzip .zip -d /home/magento/extension 

Depois de concluir o processo de instalação da extensão, você pode excluir esta pasta usando:

 $ rm -R /home/magento/extension 

Etapa 3: verifique e copie os arquivos de extensão Magento para a pasta app/code

Verifique o extraído estrutura de arquivo de componente atende ao formato “fornecedor/nome do módulo” exigido pelo Magento.

Navegue até o diretório raiz do projeto Magento e copie os arquivos de extensão para o aplicativo/código pasta usando:

 $ cp -R /home/magento/extension/* app/code 

O aplicativo/código diretório não existe no sistema de arquivos padrão do Magento. Se esta é sua primeira tentativa de instalar uma extensão Magento manualmente, crie o diretório usando:

 $ mkdir app/código 

Etapa 4: registre a extensão Magento 2 e verifique seu status

Conclua o processo de instalação da extensão Magento 2 executando:

 $ php bin/magento setup:upgrade $ php bin/magento setup:di:compile $ php bin/magento setup:static-content:deploy -f 

O comando “setup:upgrade” registra a extensão Magento 2 e atualiza o esquema e os dados do banco de dados Magento. Os comandos subsequentes compilar código Magento e implantar arquivos de visualização estática.

Observação: você não precisa implantar arquivos de visualização estática no modo de desenvolvedor, a menos que a documentação do desenvolvedor de extensão exija isso.

Verifique o status da extensão:

 $ php bin/magento module:status _ 

Se estiver desabilitado, você pode habilitá-lo usando:

 $ php bin/magento module:enable _ --clear-static-content 

Etapa 5: limpe o cache do Magento e desative o modo de manutenção

Limpe o cache do Magento usando:

 $ php bin/magento cache:clean $ php bin/magento cache:flush 

Seguir Guia da Adobe para definir permissões para um sistema de arquivos de produção. Em seguida, desative o modo de manutenção usando:

 $ php bin/magento manutenção:disable 

Bom trabalho! Você aprendeu como instalar uma extensão Magento 2 usando um arquivo.

Como instalar uma extensão Magento 2 com Composer

Antes de mostrarmos como instalar uma extensão Magento 2 via Composer, certifique-se de:

  1. Faça backup do seu servidor.
  2. Defina permissões de arquivo de pré-instalação.
  3. Ative o modo de desenvolvedor.
  4. Coloque o Magento em modo de manutenção.

Depois de atender às condições acima, siga nosso guia de instalação.

Etapa 1: Obtenha o nome e a versão do compositor da extensão

Faça login em sua conta do Magento Marketplace e navegue até [Your name] > Meu perfil.

Vá para Mercado > Meus produtos e clique Minhas compras.

Localize a extensão Magento 2 que deseja instalar e observe sua Nome do componente.

Clique no Versões disponíveis menu suspenso e anote o número da versão para instalar uma versão específica.

Etapa 2: atualize o arquivo Magento compositor.json

Faça login no servidor Magento como proprietário do sistema de arquivos e navegue até a pasta raiz do Magento para instalar o módulo via Composer.

Atualize o arquivo na interface de linha de comando (CLI) usando:

 $ compositor requer : 

Substitua “nome do componente” e “versão” pelos valores obtidos na etapa anterior. Por exemplo:

Se solicitado a entrar chaves de acessocopie e cole sua chave pública como nome de usuário e chave privada como senha.

Aguarde o Composer atualizar as dependências do projeto Magento. Em caso de erros, resolva-os antes de prosseguir.

Etapa 3: registrar a extensão e limpar o cache do Magento

Execute os seguintes comandos para registrar a extensão Magento 2, compilar o código e implantar arquivos de visualização estática:

 $ php bin/magento setup:upgrade $ php bin/magento setup:di:compile 

Limpe o cache do Magento executando:

 $ php bin/magento cache:clean $ php bin/magento cache:flush 

Etapa 4: verifique o status da extensão Magento 2

Verifique o status da extensão:

 $ php bin/magento module:status _ 

Se desativado, habilite a extensão:

 $ php bin/magento module:enable _ --clear-static-content 

Etapa 5: atualize as permissões do arquivo e desative o modo de manutenção

Defina permissões de arquivo para um sistema de arquivos de produção com base na configuração de sua hospedagem. Em seguida, desative o modo de manutenção da seguinte forma:

 $ php bin/magento manutenção:disable 

Parabéns! Você aprendeu com sucesso como instalar uma extensão Magento 2 usando o Composer.

Considerações finais: como instalar uma extensão Magento 2

Aprender como instalar uma extensão Magento 2 é a melhor maneira de adicionar e estender a funcionalidade da loja Magento. Desde Adobe descontinuado o Web Setup Wizard no Magento 2.3.6 e superior, você só pode instalar extensões do Magento 2 usando os métodos descritos acima.

Não importa o método escolhido, faça backup do servidor antes de começar e defina as permissões do arquivo de produção depois de terminar.

Se isso parece muito trabalhoso, inscreva-se na hospedagem Magento gerenciada com Hostinger e aproveite a conveniência de backups noturnos automáticos e um ambiente de hospedagem Magento 2 seguro.

Navegue pelos nossos planos para saber mais.

Novas publicações:

Recomendação