# Configurar o WooCommerce no KapsuleHost

Source: https://support.kapsulehost.com/pt-pt/wordpress-woocommerce

KapsuleHost tem um tipo de site WooCommerce dedicado que instala o WordPress, o WooCommerce e um conjunto de gateways de pagamento da Nova Zelândia por si, e depois adiciona ferramentas específicas de loja ao menu do site. Este guia cobre a criação da loja, a ligação de pagamentos, as definições que importam para uma loja sob carga, e como fazer alterações sem perder encomendas.

## Criar um Site WooCommerce

1. Inicie sessão no [KPanel](https://kpanel.kapsulehost.com) e clique em **Websites** na barra lateral esquerda.
2. Clique em **Adicionar Website**, depois em **Novo Website**.
3. Escolha **WooCommerce** como tipo de site.
4. Dê um nome à loja e conclua o assistente.

O KapsuleHost provisiona o WordPress, cria a base de dados, instala e ativa o WooCommerce, e pré-instala os plugins de gateway de pagamento listados abaixo. O PHP 8.3 é definido como tempo de execução, com as extensões de que uma loja necessita, incluindo tratamento de imagens.

Se já tiver um site WordPress e quiser adicionar uma loja a ele, instale o WooCommerce da forma habitual a partir de **Plugins**, depois **Add New** no wp-admin. O site mantém o seu tipo de site WordPress, o que significa que os separadores específicos de loja aqui descritos não vão aparecer.

> **Note:** Está a migrar uma loja já existente em vez de começar do zero? Não a reconstrua manualmente. Utilize **Migrações** na barra lateral esquerda, que copia os ficheiros e a base de dados mantendo a sua loja atual sempre em funcionamento. Consulte [Migrar um Website a Partir do cPanel](https://support.kapsulehost.com/pt-pt/sites-migrate-cpanel).

## Gateways de Pagamento

Abra a loja, depois o separador **WordPress**, depois **Pagamentos**. Este separador é exclusivo do WooCommerce e não aparece em sites WordPress comuns.

![Painel de gateways de pagamento para uma loja WooCommerce](https://support.kapsulehost.com/help/screenshots/wordpress-woocommerce.475328e2.webp)

São abrangidos cinco gateways, com os relevantes para a Nova Zelândia assinalados:

| Gateway | Abrange | Estado numa loja nova |
|---|---|---|
| Stripe | Cartões, Apple Pay e Google Pay | Pré-instalado, inativo |
| Afterpay | Compre agora, pague depois | Pré-instalado, inativo |
| POLi | Transferência bancária da Nova Zelândia | Pré-instalado, inativo |
| PayPal | PayPal e cartões | Pré-instalado, inativo |
| Windcave | Processamento de cartões e EFTPOS na Nova Zelândia | Disponível, instalar a partir do fornecedor |

O Apple Pay e o Google Pay vêm incluídos com o Stripe: não há nada separado para instalar em nenhum dos dois casos.

Os gateways são deliberadamente instalados **inativos**. Um gateway ativado sem credenciais quebra o checkout, por isso nada entra em funcionamento até fornecer os seus próprios dados de conta de comerciante:

1. Clique em **Enable** no gateway que utiliza.
2. Clique em **Configure**, o que abre as definições desse gateway dentro do wp-admin.
3. Introduza as suas próprias chaves de API ou credenciais de comerciante e guarde.
4. Faça uma encomenda de teste antes de anunciar a loja.

O Windcave é distribuído pelo fornecedor em vez do diretório de plugins, pelo que o painel fornece uma ligação **Obter plugin**. Descarregue-o, carregue-o a partir de **Plugins**, depois **Add New** no wp-admin, e volte aqui para o configurar.

> **Note:** O separador **Pagamentos** faz parte do Managed WooCommerce. Noutros planos, mostra antes um painel de atualização. Pode sempre instalar e configurar qualquer gateway diretamente no wp-admin em qualquer plano: o separador é um atalho, não a única via.

## Desempenho da Loja

Uma loja faz muito mais trabalho de base de dados por visualização de página do que um site institucional, por isso é na cache que estão os maiores ganhos.

**Cache de página completa.** No separador **WordPress** do site, depois **Colocação em cache**, a cache de página completa serve HTML já pronto a visitantes anónimos sem executar PHP nem tocar na base de dados. O carrinho, o checkout, as páginas da minha conta e os endpoints AJAX do WooCommerce são ignorados automaticamente, e qualquer visitante com um cookie de carrinho ativo recebe sempre uma página em tempo real. A cache acelera as páginas de produtos e categorias sem nunca mostrar a um cliente o carrinho de outro cliente.

**Cache de objetos.** No mesmo ecrã, a cache de objetos mantém em memória os resultados de consultas à base de dados e os transients. É esta que torna a administração do WooCommerce utilizável num catálogo grande.

**CDN.** Ative-a a partir de **Desempenho**, depois **Kapsule CDN**, para servir imagens de produtos e recursos estáticos a partir da periferia da rede, com otimização de imagens e conversão para WebP nos planos com Kapsule CDN+. Consulte [Ativar o CDN](https://support.kapsulehost.com/pt-pt/cdn-enabling). Faça a limpeza depois de uma alteração em massa de imagens de produtos: [Limpar a Cache do CDN](https://support.kapsulehost.com/pt-pt/cdn-cache-purge).

> **Tip:** A cache de página completa e a cache de objetos estão incluídas no Managed WooCommerce. Se a sua loja estiver noutro plano, o separador Caching mostra o que a atualização acrescenta. De qualquer forma, ative primeiro o CDN: está incluído em todos os planos Web Hosting, WordPress, Managed WordPress, Managed WooCommerce e Concierge, e é a melhoria de desempenho mais barata disponível numa loja com muitas imagens.

## Definições de PHP Para uma Loja

As lojas são o motivo mais comum para abandonar as definições predefinidas. No separador **Definições** do site, depois **PHP**:

- **Limite de memória**: aumente de 256M para 512M se o catálogo for grande ou tiver subscrições.
- **Tempo máximo de execução**: aumente de 30 para 120 ou 300 segundos se as importações de produtos ou a geração de relatórios atingirem o tempo limite.
- **Máximo de variáveis de entrada**: aumente a partir de 3000 se tiver produtos com muitas variações, ou um ecrã de definições que perde campos silenciosamente ao guardar.

Os detalhes completos estão em [Aumentar o Limite de Memória do WordPress](https://support.kapsulehost.com/pt-pt/wordpress-memory-limit).

## Tarefas Agendadas

O WooCommerce executa muito trabalho em segundo plano: transições de estado de encomendas, renovações de subscrições, emails, sincronização de stock. Utiliza o agendador incorporado do WordPress, que por predefinição só é acionado quando alguém visita o site. Numa loja com pouco tráfego, isso significa que as renovações e os emails são processados tarde ou nem sequer são processados.

Substitua-o por um agendamento real do lado do servidor. O separador **WordPress**, depois a secção **WP-Cron**, tem uma ação **Ativar cron do sistema** que adiciona o agendamento e desativa a versão acionada por visitantes no mesmo passo. A explicação completa e a alternativa manual estão em [Configurar e Gerir Tarefas Cron](https://support.kapsulehost.com/pt-pt/cron-jobs).

Pode acompanhar a fila em **WooCommerce**, depois **Status**, depois **Scheduled Actions** no wp-admin.

## Fazer Alterações Sem Perder Encomendas

Cada loja é uma base de dados em tempo real na qual os clientes estão continuamente a escrever, o que muda a forma como deve lidar com as atualizações.

> **Important:** Nunca envie uma base de dados de staging para uma loja em produção. As encomendas, os clientes, as subscrições, os cupões e os níveis de stock residem todos na base de dados, por isso um envio da base de dados elimina todas as encomendas feitas desde a sua última reposição em produção. Envie **apenas ficheiros**, o que é suficiente para alterações de tema, plugins e código. Consulte [Utilizar o Staging: Enviar e Obter](https://support.kapsulehost.com/pt-pt/wordpress-staging-workflow).

Uma rotina de atualização segura para uma loja:

1. Faça uma cópia de segurança: [Fazer uma Cópia de Segurança](https://support.kapsulehost.com/pt-pt/taking-a-backup).
2. Reponha o staging a partir da produção, para que corresponda à loja em funcionamento.
3. Aplique as atualizações de plugins, tema ou WooCommerce no staging.
4. Faça uma encomenda de teste completa no staging, até à página de confirmação.
5. Envie **apenas ficheiros** para a produção.
6. Faça uma pequena encomenda real em produção e reembolse-a.

Nos planos geridos, a ação **Atualizar Plugins** em **Ações Rápidas** torna-se **Atualização inteligente**: faz uma cópia de segurança, atualiza um plugin de cada vez, executa uma verificação de saúde do site após cada um, e reverte automaticamente qualquer coisa que quebre o site. Numa loja onde um checkout avariado custa dinheiro, isso vale a pena ter.

## Recuperação em Tempo

As cópias de segurança diárias repõem uma loja no estado em que estava quando essa cópia foi feita, o que numa loja com muito movimento pode significar perder um dia de encomendas. Os sites WooCommerce podem ativar a recuperação em tempo a partir de **Cópias de segurança**, depois **Recuperação em tempo**, e repor um minuto escolhido em vez disso, com até 30 dias de retenção. Em qualquer loja que receba dinheiro real, ative-a. Consulte [Fazer uma Cópia de Segurança](https://support.kapsulehost.com/pt-pt/taking-a-backup).

## Resolução de Problemas

**O checkout falha sem erro.** Quase sempre um gateway ativado com credenciais em falta ou erradas. Desative os gateways um de cada vez a partir do separador **Pagamentos** até o checkout funcionar, e depois reconfigure o que o quebrou.

**Os emails de encomenda não estão a chegar.** O WordPress envia correio através do PHP por predefinição e a maioria das redes rejeita-o. Verifique o aviso de entrega no separador **WordPress**, depois **Saúde do Site**, e configure um envio autenticado adequado.

**As páginas de administração estão lentas ou atingem o tempo limite.** Aumente a memória e o tempo de execução no separador **PHP**, depois ative a cache de objetos. Uma loja com dezenas de milhares de encomendas também beneficia da limpeza de ações agendadas antigas.

**As alterações de produtos não aparecem na parte visível do site.** Limpe a cache a partir de **WordPress**, depois **Ações Rápidas**, depois **Limpar Cache**, e faça a limpeza do CDN.