Instalar o WooCommerce e o assistente

Módulo 2: Instalar e configurar · Tempo de leitura: 9 minutos

Objetivo de aprendizagem: No final desta lição, será capaz de instalar o WooCommerce primeiro numa loja de teste e de percorrer o assistente de instalação com atenção, sabendo que consequência tem cada escolha.

Conceitos-chave: loja de teste, subdomínio, instalar um plugin, assistente de instalação, perfil da loja, morada da loja, setor de atividade, extensões recomendadas, modo «em breve» (coming soon), partilha de dados (usage tracking), WooCommerce > Estado

Porque se começa com uma loja de teste

Instalar o WooCommerce demora um minuto. Configurar bem uma loja demora dias. Durante esses dias, experimenta várias coisas: outro tema, um fornecedor de pagamentos em modo de teste, um plugin para faturas, uma regra de envio que afinal não está certa. Se o fizer no seu site real, os visitantes veem uma loja a meio, aparecem páginas de teste nos motores de pesquisa e o seu servidor de correio tem de processar e-mails de teste. Num site existente com visitantes, um erro num plugin pode deitar abaixo todo o site (curso de WordPress, lição 1.2).

Por isso, começa com uma loja de teste: uma instalação separada do WordPress que só o próprio utiliza. Há três formas habituais:

1. Um subdomínio, por exemplo test.example.com, com a sua própria instalação do WordPress. É assim que a Theehuis Example cria test.shop.example.com, instala lá o WordPress e depois o WooCommerce. Só quando tudo funciona é que a configuração passa para shop.example.com.
2. Um clone do seu site existente (staging). Se já tiver um site WordPress com conteúdo, copia-o para um subdomínio e adiciona lá o WooCommerce. A forma de criar e proteger um ambiente de staging está explicada no curso de WordPress, lição 8.3. Na lição 7.3 deste curso, veremos as armadilhas próprias de uma loja.
3. Uma instalação local no seu próprio computador. É prático para programadores, mas os fornecedores de pagamentos e os webhooks (lição 4.4) não conseguem chegar ao seu computador. Para este curso, recomendamos uma loja de teste online.

Para os exercícios deste curso, basta uma loja de teste num subdomínio. As verificações automáticas analisam o que um visitante vê, por isso a loja de teste tem de estar acessível por https (curso de WordPress, lições 2.1 e 3.1).

Há duas coisas que deve tratar logo na loja de teste:

• Manter os motores de pesquisa afastados. No WordPress, em Configurações > Leitura, marque a opção para desencorajar os motores de pesquisa, ou utilize o modo «em breve» do WooCommerce (ver abaixo). Melhor ainda: proteja a pasta com uma palavra-passe (curso de WordPress, lição 8.3).
• Nada de clientes reais nem de pagamentos reais. Utilize nomes fictícios e o modo de teste do seu fornecedor de pagamentos.

Instalar o WooCommerce

O WooCommerce é um plugin comum. Instala-se como qualquer outro plugin (curso de WordPress, lição 5.3): na administração do WordPress, em Plugins > Adicionar novo plugin, pesquise «WooCommerce» e clique em Instalar agora e em Activar. Confirme que o autor é o WooCommerce e que o plugin vem de wordpress.org. Existem plugins falsificados com nomes quase iguais; nunca instale um plugin de um site desconhecido.

Alguns fornecedores de alojamento oferecem um instalador que coloca o WordPress com o WooCommerce de uma só vez. Poupa alguns cliques, mas depois percorre o mesmo assistente. Na WebOké, instala o WordPress com o Installatron no DirectAdmin (num subdomínio ou numa subpasta) e adiciona o WooCommerce na administração do WordPress. Noutros fornecedores de alojamento funciona de forma semelhante, por exemplo com o Softaculous ou o WP Toolkit.

Antes de instalar, verifique os requisitos de sistema. O WooCommerce recomenda (situação em novembro de 2026) PHP 8.3 ou superior, MySQL 8.0 ou MariaDB 10.6 ou superior, um limite de memória do WordPress de pelo menos 256 MB e https. Muitas vezes também funciona com menos, mas nesse caso surgem mais depressa erros estranhos em alturas de grande movimento ou em importações grandes. A lição 7.2 aprofunda este tema.

O assistente: o que pergunta e o que significa

Depois da ativação, o WooCommerce abre um assistente de instalação. A sua apresentação muda por vezes de versão para versão, mas as perguntas são sempre do mesmo tipo. O importante é saber o que cada pergunta faz.

Sobre si e a sua loja. O assistente pergunta em que fase está (a começar, já a vender), o que vende e em que setor de atividade. O WooCommerce utiliza estes dados sobretudo para fazer recomendações. Não altera nenhuma definição que não possa mudar mais tarde.

Onde está estabelecida a sua loja. Esta pergunta é, de facto, importante. A morada da loja (país e distrito ou região) é a base da moeda predefinida, do cálculo do IVA e das zonas de envio. Se escolher aqui outro país por engano, o WooCommerce passará a calcular com a base errada. A Theehuis Example escolhe Países Baixos; a moeda passa então a ser o euro. A morada completa preenche-se mais tarde nas configurações gerais (lição 2.3).

Extensões recomendadas. O assistente sugere extensões gratuitas: um serviço de pagamento, uma ligação a transportadoras, marketing, cálculo de impostos. Muitas vezes já vêm assinaladas. Aqui deve agir com critério. Cada extensão é código que tem de atualizar, que pode ter erros e que por vezes envia dados a terceiros. Instale apenas o que o seu plano (lição 1.3) exige. Pode adicionar tudo mais tarde; retirar é mais difícil, porque as extensões deixam vestígios na base de dados e por vezes nas suas configurações.

Partilha de dados. O WooCommerce pergunta se pode partilhar dados sobre a utilização do plugin. É uma escolha, não uma obrigação. Leia o que é partilhado e decida conscientemente. Numa loja de teste pouco importa; na sua loja real, se responder que sim, isso deve constar do seu registo das atividades de tratamento (lição 5.5).

Depois do assistente, o WooCommerce cria quatro páginas: Loja (a lista de produtos), Carrinho, Finalizar compra e A minha conta. Numa instalação nova, o carrinho e a finalização da compra são construídos com blocos (assim é desde o WooCommerce 8.3). Além disso, numa instalação nova as encomendas são guardadas em tabelas próprias (HPOS, predefinido desde a versão 8.2). As lições 1.2 e 2.2 explicam o que isso significa.

O modo «em breve»

As lojas novas começam no modo «em breve» (coming soon mode). Os visitantes veem então uma mensagem a informar que a loja abre em breve, enquanto o administrador com sessão iniciada vê tudo normalmente. Pode escolher se ficam ocultas apenas as páginas da loja ou todo o site.

É prático, mas tenha em atenção três aspetos:

• Não é uma medida de segurança. Quem conhecer o endereço da Store API pode, eventualmente, consultar na mesma os dados dos produtos (lição 2.4). Para uma loja de teste, uma palavra-passe na pasta é mais segura.
• Cache. Uma cache de páginas pode guardar a mensagem e continuar a mostrá-la depois de desligar o modo, ou, pelo contrário, mostrar a loja real enquanto o modo ainda está ativo. Limpe a cache depois de mudar o modo (lição 6.4).
• Esquecer-se de o desligar. Na entrada em funcionamento (lição 7.4), desligar o modo faz parte da lista de verificação. Uma loja que mostra «em breve» durante meses não vende nada.

Depois do assistente: primeiro observar, depois configurar

Antes de adicionar produtos, consulte WooCommerce > Estado (System Status). Aí encontra numa só vista o que o WooCommerce sabe do seu servidor: a versão do PHP, o limite de memória do WordPress, a versão da base de dados, se as tarefas agendadas estão a ser executadas, que plugins estão ativos e se o tema substitui modelos do WooCommerce. No topo existe um botão para copiar um relatório. É frequentemente a primeira coisa que um programador ou o suporte de uma extensão pede. Anote a versão do PHP e o limite de memória: vai precisar deles no exercício e na lição 7.2.

Um erro frequente é importar cem produtos logo a seguir ao assistente. Trate primeiro das configurações dos módulos 2 e 4 (morada, contas, IVA, envio, pagamento) e só depois dos produtos. Caso contrário, terá de corrigir mais tarde os preços e as classes de IVA de todos esses produtos.

Na prática: é assim no WooCommerce

Como exemplo, uma loja de teste num subdomínio na WebOké. Noutros fornecedores de alojamento e painéis funciona de forma semelhante.

1. No DirectAdmin, crie um subdomínio, por exemplo test em shop.example.com, e garanta que tem um certificado.
2. Instale o WordPress nesse subdomínio com o Installatron (ou manualmente, curso de WordPress, lição 2.3).
3. Em Configurações > Leitura, desative a visibilidade para os motores de pesquisa, ou proteja a pasta com uma palavra-passe.
4. Vá a Plugins > Adicionar novo plugin, pesquise «WooCommerce», confirme o autor, instale e ative.
5. Percorra o assistente: escolha o país correto, assinale apenas as extensões de que precisa e decida conscientemente sobre a partilha de dados.
6. Abra WooCommerce > Estado e anote a versão do PHP e o limite de memória do WordPress.
7. Em Páginas, veja as quatro páginas que o WooCommerce criou.

Resumo

• Comece numa loja de teste num subdomínio ou num ambiente de staging, protegida dos motores de pesquisa e sem dados reais.
• Instale o WooCommerce apenas a partir de wordpress.org ou do ecrã de plugins, e confirme o autor.
• No assistente, o que mais conta é o país da sua loja: determina a moeda, a base do IVA e as zonas de envio. Uma loja estabelecida em Portugal escolhe Portugal; a taxa normal de IVA é de 23 % no continente (22 % na Madeira, 16 % nos Açores).
• Assinale as extensões recomendadas apenas se o seu plano precisar delas; menos plugins significa menos manutenção.
• O modo «em breve» oculta a loja dos visitantes, mas não é uma medida de segurança; desligue-o na entrada em funcionamento.

Questionário

Exercício

Exercício D2.1: Uma loja de teste e o assistente. Crie uma loja de teste e percorra o assistente com atenção. Este é um exercício para fazer por conta própria: assinala os pontos e responde às perguntas.

Assinale:

• loja de teste num subdomínio ou em staging;
• motores de pesquisa bloqueados, ou o modo «em breve» ativo;
• WooCommerce instalado a partir de wordpress.org ou do ecrã de plugins;
• assistente concluído;
• extensões recomendadas escolhidas ou recusadas conscientemente;
• partilha de dados decidida conscientemente.

Responda:

1. Que extensões sugeriu o assistente, quais instalou e porquê?
2. Que páginas criou o WooCommerce (nomes)?
3. O que indica WooCommerce > Estado quanto à versão do PHP e ao limite de memória do WordPress?

Depois de clicar em «Concluído», verá a resposta modelo: no máximo as extensões de que o seu plano precisa; quatro páginas (Loja, Carrinho, Finalizar compra, A minha conta); uma versão do PHP e um limite de memória (a lição 7.2 volta a este tema).

Para saber mais

Os artigos sobre o painel descrevem os passos na WebOké; noutros fornecedores de alojamento funciona de forma semelhante.

• Manual DirectAdmin 4.5: Criar e remover subdomínios
• Criar um subdomínio e o que fazer se não funcionar
• Manual DirectAdmin 13.2: Instalar o WordPress
• Manual DirectAdmin 13.3: Instalar numa subpasta ou num subdomínio
• Curso gratuito de WordPress 2.2: Instalar com um instalador
• Curso gratuito de WordPress 8.3: Staging: testar com segurança
• Recomendações de servidor do WooCommerce (woocommerce.com, em inglês): https://woocommerce.com/document/server-requirements/
• Modo «em breve» (woocommerce.com, em inglês): https://woocommerce.com/document/coming-soon-mode/
• Instalar o WooCommerce numa loja de teste