Instruções de instalação [WooCommerce]

Antes de começar

Verifique se sua loja atende aos requisitos mínimos:

  • WordPress: 6.4+
  • WooCommerce: 6.0+ (instalado e ativado)
  • PHP: 8.0+
  • Por motivos de segurança, é necessário um servidor com HTTPS / SSL ativado
  • É necessária uma conta Alter Product (usará Access Key + Access Token)

Importante: o plugin executa o Customizer, Configurator ou Viewer num iframe isolado, portanto não modifica o funcionamento do checkout principal do WooCommerce.

Etapas de instalação e configuração

  1. Aceda ao painel de administração do WordPress.
  2. No painel do WordPress, aceda a Plugins → Adicionar novo, procure Alter Product – 3D Configurator for WooCommerce, instale e ative o plugin.* Opcional: envie o ZIP manualmente e ative-o.
  3. No painel do WordPress, abra Alter Product e clique em Conectar em Conexão automática.* Configuração manual opcional: crie chaves de API na página de configurações da API do Alter Product, copie a Access Key e o Access Token e adicione o domínio da sua loja nas Configurações de incorporação.
  4. Siga as etapas de instalação exibidas para concluir a configuração.
  5. Crie o primeiro design: aceda à página de edição de produto do WooCommerce. No separador Alter Product, crie um novo design (ou selecione um existente). O design será associado ao produto. Defina variantes que correspondam ao produto do WooCommerce, ative o Customizer se desejar e guarde o projeto.

Após a configuração

Após configurar, pode:

  • Gerir recursos, incluindo produtos, variantes, mockups, biblioteca de imagens, logótipos, modelos de design, fundos, ambientes e fontes
  • Importar projetos do armazenamento do Alter Product
  • Criar e gerir designs de produtos
  • Exibir um botão da ferramenta de e-commerce selecionada nas páginas públicas da loja ou de produtos do WooCommerce
  • Incorporar Viewer / Configurator / Customizer em páginas de produtos do WooCommerce ou páginas do WordPress
  • Associar produtos do WooCommerce a designs do Alter Product
  • Permitir que os clientes personalizem produtos (texto, imagens, layouts, códigos QR etc.)
  • Sincronizar a configuração selecionada com o carrinho do WooCommerce

Solução de problemas

  • O teste da API falha: verifique Access Key / Access Token e a conectividade do seu servidor com https://alterproduct.com/public-api em Alter Product → Estado.
  • Problemas ao descarregar recursos: aceda a Alter Product → Estado e verifique se o servidor atende aos requisitos da tabela Recursos do servidor.
  • Iframe em branco / sem comunicação: verifique se o domínio da sua loja foi adicionado em Configurações de e-commerce → Integração no Alter Product ou se o servidor usa HTTPS com um certificado SSL válido.
  • Problema com links permanentes: se as páginas do Customizer, Configurator ou Viewer exibirem Não encontrado, aceda a Configurações → Links permanentes e clique em Guardar alterações para atualizar as regras de reescrita.
  • Adicionar ao carrinho não funciona: confirme que a associação de produtos está completa e que a ferramenta incorporada tem as ações de e-commerce ativadas.