Início
Software
Software de configurador 3D Planos e preços Estúdio de Fotos IA Iniciar sessão
Por medida
Configurador 3D por medida Modelização 3D de catálogo Packshot 3D fotorrealista Realidade aumentada Visualização 3D web Configurador 3D Modular Marcar uma reunião
Setores
Mobiliário Têxtil e moda Joalheria e luxo Artigos publicitários Equipamentos desportivos
Integrações
Shopify WooCommerce PrestaShop WordPress
Recursos
FAQ Documentação Blog Casos de sucesso Sobre nós Contacto
Teste grátis
Guia para programadores : WooCommerce

Um configurador 3D
no WooCommerce.
2 linhas de código.

<viewer-3dvue> é um Web Component nativo. Sem dependências, sem plugin adicional. Integra-se em qualquer template WooCommerce : single-product.php, um shortcode ou um bloco HTML do Gutenberg personalizado.

Sem plugin necessário
Compatível WP 6+ / WC 8+
Atributos HTML ou API JS
Funciona com Elementor
functions.php
Passo 1
add_action('wp_enqueue_scripts', function() {
  wp_enqueue_script(
    'viewer-3dvue',
    'https://cdn.jsdelivr.net/gh/3dvue/api@v4/viewer-3dvue-min.js',
    [], null, true
  );
});
single-product.php
Passo 2
<viewer-3dvue
  name="monViewer"
  src="https://app.3dvue.fr/view?p=AB01-CD02"
></viewer-3dvue>

<!-- Pronto. -->
Sem programador?

Crie o seu configurador você mesmo.

O guia abaixo destina-se a programadores que integram um configurador concebido à medida pela 3DVue. Se já tem os ficheiros 3D dos seus produtos e quer criar e publicar o seu configurador você mesmo, sem escrever código, utilize o software 3DVue. Para cada produto, gera :

  • Uma ligação direta : o URL do configurador, para colocar numa ficha de produto, num email ou numa rede social.
  • Um código iframe : para colar num bloco HTML personalizado do editor de blocos do WordPress, na página de produto.
  • Um widget : um script para colar uma vez através de um plugin como Insert Headers and Footers, ou no tema filho, que adiciona um botão « Ver em 3D » nas suas páginas de produto.

Grátis durante 14 dias, depois a partir de 49 € + IVA por mês, sem comissão sobre as suas vendas.

Experimentar gratuitamente Descobrir o software
+94%
aumento de conversão em páginas de produto com modelo 3D
Fonte: Shopify
−40%
menos devoluções após a visualização 3D do produto
Fonte: Shopify
66%
dos compradores sentem-se mais confiantes com um configurador 3D
Fonte: Estudo 2023
82%
dos visitantes ativam a vista 3D quando está disponível
Fonte: Cappasity
Instalação

Pronto em 3 passos. Sem plugin dedicado.

Um Web Component nativo : sem dependência de React, Vue ou jQuery. Compatível com todos os temas e construtores de páginas do WordPress (Elementor, Divi, Bricks).

  1. 1
    Registar o script

    Use wp_enqueue_script() no seu functions.php para carregar o componente. O true final carrega-o no rodapé : recomendado para evitar bloquear a renderização.

    O script CDN é público. Também pode incluí-lo através de um widget HTML do Elementor ou WPCode : em todos os casos, o atributo src do componente é o URL específico do seu configurador, fornecido pela 3DVue na entrega.
    functions.php
    add_action('wp_enqueue_scripts', function() {
      wp_enqueue_script(
        'viewer-3dvue',
        'https://cdn.jsdelivr.net/gh/3dvue/api@v4/viewer-3dvue-min.js',
        [], null, true
      );
    });
    
    // Ou via WPCode : fragmento HTML
    // <script src="https://cdn.jsdelivr.net/gh/3dvue/api@v4/viewer-3dvue-min.js"></script>
  2. 2
    Colocar o componente

    Cole a etiqueta no seu template de produto, num shortcode PHP ou num bloco HTML do Gutenberg. Dois atributos obrigatórios: name (identificador único) e src (o URL do seu configurador fornecido pela 3DVue).

    Com Elementor, basta colar a etiqueta num widget HTML. Como o script já é carregado globalmente, não é necessária nenhuma configuração adicional.
    single-product.php ou widget HTML
    <viewer-3dvue
      name="monViewer"
      src="https://app.3dvue.fr/view?p=AB01-CD02"
    ></viewer-3dvue>
    
    <!-- Com debug ativado -->
    <viewer-3dvue
      name="monViewer"
      src="https://app.3dvue.fr/view?p=AB01-CD02"
      debug
    ></viewer-3dvue>
  3. 3
    Ligar as variações do WooCommerce

    Adicione os atributos viewer-3dvue nos seus elementos <select> de variações nativas do WooCommerce ou nas suas amostras personalizadas. O componente escuta automaticamente : não há JS para escrever.

    variable.php : select de variação de cor
    <!-- Num select existente do WooCommerce -->
    <select
      name="attribute_pa_colour"
      viewer-3dvue="monViewer"
      viewer-3dvue-change="setMaterial"
      viewer-3dvue-mesh="1,2"
    >
      <option value="0n">Preto</option>
      <option value="1a">Branco</option>
      <option value="2b">Carvalho natural</option>
    </select>
    
    <!-- Ou num botão de amostra personalizado -->
    <button
      viewer-3dvue="monViewer"
      viewer-3dvue-clic="setMaterial"
      viewer-3dvue-meshs-materials='{"1":"2b","3":"0n"}'
    >Carvalho / Preto</button>
Controlo HTML puro

Zero JavaScript.
Tudo em atributos HTML.

O componente escuta automaticamente os eventos click e change em qualquer elemento que tenha os atributos corretos. Compatível com os selects nativos do WooCommerce e plugins de amostras (Variation Swatches, etc.).

setMaterial ao clicar : amostras personalizadas
Conecte qualquer botão ou amostra. Podem ser aplicados vários materiais simultaneamente numa única ação.
<button
  viewer-3dvue="monViewer"
  viewer-3dvue-clic="setMaterial"
  viewer-3dvue-meshs-materials='{"1":"0n","3":"2b"}'
>
  Tecido cinza veludo
</button>

// {"meshIndex": "materialId"}
// Índice 0 reservado : começa em 1
setMaterial em <select> : variações nativas
Adicione 3 atributos ao seu <select> de variações do WooCommerce existente. O visualizador sincroniza automaticamente.
<select
  name="attribute_pa_colour"
  viewer-3dvue="monViewer"
  viewer-3dvue-change="setMaterial"
  viewer-3dvue-mesh="1,3"
>
  <option value="0n">Preto</option>
  <option value="1a">Branco</option>
</select>

// viewer-3dvue-mesh="1,3"
// aplica-se à mesh 1 E mesh 3
API JavaScript

Para casos de uso avançados.

Controlo programático completo : útil para sincronizar o visualizador com as variações do WooCommerce via JS, ou para casos de uso avançados como captura de imagem ou exportação de prova de impressão.

querySelector Obtém a referência do componente : o ponto de partida para toda a API JS
const viewer = document.querySelector('viewer-3dvue[name="monViewer"]');

// Sincronizar com as variações do WooCommerce
document.querySelector('.variations select')
  .addEventListener('change', (e) => {
    viewer.setMaterial({ "1": e.target.value });
  });
setMaterial() Aplica materiais a uma ou várias meshes de um objeto
// No objeto 0 (por omissão)
viewer.setMaterial({ "1": "0n", "3": "2b" });

// Num segmento específico (produto multi-parte)
viewer.setMaterial({ "1": "1a" }, 1);
// setMaterial(materialList, objectIndex = 0)
loadModel() / addModel() / removeModel() Gestão dinâmica de modelos : para produtos configuráveis com componentes opcionais
// Carrega um modelo diferente (ex. mudança de forma)
viewer.loadModel("AB01-CD02");

// Adiciona um componente ao modelo existente
// Ex: adicionar um apoio de braços, prateleira, pé
viewer.addModel("EF03");

// Remove um componente (o índice começa em 0)
viewer.removeModel(1);
// ⚠ Não é possível remover o último segmento restante
captureToBase64() Captura o render atual como imagem base64 : para emails de confirmação ou resumos de encomenda do WooCommerce
viewer.captureToBase64();

viewer.addEventListener("onCaptureBase64Complete", (e) => {
  const { base64, error } = e.detail;
  if (error) return;
  // Guardar num campo oculto para a encomenda WC
  document.querySelector('input[name="config_preview"]').value = base64;
});
API SVG : Personalização avançada

Textos, logótipos, provas de impressão.
Tudo em SVG.

A API SVG permite adicionar texto e imagens diretamente sobre o produto 3D através de zonas de colocação definidas no modelo. Utiliza-se para produtos personalizáveis : marcação, carregamento de logótipo, gravação de texto.

Método Descrição
addSVGText(text, opts) Adiciona texto a uma zona de colocação. Opções: fill, fontFamily, selectable
addSVGImage(source, opts) Adiciona uma imagem (File ou ArrayBuffer). Sem cópia via Transferable Objects.
setSVGElementParam(param, value, id) Modifica um parâmetro de um elemento SVG. Sem 3º argumento: aplica-se ao elemento selecionado.
removeSVGElement(id) Remove um elemento SVG (texto ou imagem). Sem argumento: remove o elemento selecionado.
exportSVG() Gera o ficheiro SVG do produto configurado : prova de impressão pronta para produção.
Exemplo : carregamento de logótipo + exportação de prova
// 1. Carregar logótipo a partir de um input de ficheiro do WooCommerce
const file = input.files[0];
viewer.addSVGImage(file, {
  dropzone: "dropzone001",
  selectable: true
});

// 2. Texto personalizado (gravado, marcação)
viewer.addSVGText("O meu texto", {
  fill: "#ffffff",
  fontFamily: "Arial"
});

// 3. Exportar a prova SVG para produção
viewer.exportSVG();
viewer.addEventListener("onSVGExportComplete", (e) => {
  const { path } = e.detail;
  // path = URL do ficheiro SVG pronto para imprimir
});

Perguntas frequentes

Como instalo o configurador 3D no WooCommerce?+

Use wp_enqueue_script() no seu functions.php para carregar o componente, depois cole a etiqueta <viewer-3dvue> no seu template de produto, num shortcode ou num bloco HTML do Gutenberg. Não é necessário nenhum plugin.

Funciona com Elementor e outros construtores de páginas?+

Sim. Com Elementor, basta colar a etiqueta num widget HTML. Como o script é carregado globalmente, não é necessária nenhuma configuração adicional.

Como conecto os selects de variações do WooCommerce?+

Adicione os atributos viewer-3dvue diretamente nos seus elementos <select> de variações nativas do WooCommerce, ou em botões de amostra personalizados. O componente escuta automaticamente : não há JS para escrever.

Posso capturar o produto configurado como imagem para a encomenda?+

Sim. Use captureToBase64() para obter uma imagem PNG do render atual e guarde-a num campo oculto do formulário de encomenda do WooCommerce.

Quanto custa um configurador 3D para WooCommerce?+

Um configurador por medida começa nos 5 000 € + IVA, sob orçamento: modelação, interface com a sua identidade visual, integração, alojamento e suporte humano estão incluídos. Para experimentar por si, o software em self-service é gratuito durante 14 dias, sem cartão de crédito, e depois a partir de 49 € + IVA por mês.
Documentação completa

Referência da API, atributos HTML, eventos, exemplos PHP do WooCommerce. Tudo está documentado e mantido atualizado.

Ver a documentação
Suporte técnico humano

Sem sistema de tickets automatizado. Fala diretamente com Matthieu, o programador que concebeu a API. Resposta em menos de 24 horas.

Reservar uma chamada
Demo interativa

Experimente o configurador em condições reais antes de o integrar. Veja exatamente o que os seus clientes verão na sua loja WooCommerce.

Ver a demo
Integremos juntos

Pronto para integrar?
Nós tratamos dos modelos 3D.

Você gere o código do lado do WooCommerce, nós tratamos de todo o resto : modelação, materiais, configuração. Em 30 minutos, mostramos-lhe o que podemos fazer com o seu catálogo.

Script entregue na entrega : pronto para enfilar
IDs de modelo e material documentados por projeto
Suporte direto com o programador da API
Compatível com WooCommerce 8+, todos os temas e construtores
Utilizamos cookies de medição de audiência para entender como utiliza o nosso site.