Home
Software
Software per configuratore 3D Piani e prezzi Studio Foto IA Accedi
Su misura
Configuratore 3D su misura Modellazione 3D catalogo Packshot 3D Fotorealistico Realtà Aumentata Visualizzazione Web 3D Configuratore 3D Modulare Prenota una chiamata
Settori
Arredamento Tessile & Moda Gioielli e Lusso Gadget promozionali Abbigliamento sportivo
Integrazioni
Shopify WooCommerce PrestaShop WordPress
Risorse
FAQ Documentazione Blog Casi studio Valori Contatto
Prova gratuita
Guida per sviluppatori : WooCommerce

Un configuratore 3D
su WooCommerce.
2 righe di codice.

<viewer-3dvue> è un Web Component nativo. Nessuna dipendenza, nessun plugin aggiuntivo. Si integra in qualsiasi template WooCommerce : single-product.php, uno shortcode o un blocco HTML personalizzato di Gutenberg.

Nessun plugin necessario
Compatibile WP 6+ / WC 8+
Attributi HTML o API JS
Funziona con 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="mioViewer"
  src="https://app.3dvue.fr/view?p=AB01-CD02"
></viewer-3dvue>

<!-- Pronto. -->
Niente sviluppatore?

Crea il tuo configuratore da solo.

La guida qui sopra è rivolta agli sviluppatori che integrano un configuratore realizzato su misura da 3DVue. Se hai già i file 3D dei tuoi prodotti e vuoi creare e pubblicare il tuo configuratore da solo, senza scrivere codice, usa il software 3DVue. Per ogni prodotto, genera :

  • Un link diretto : l'URL del configuratore, da inserire in una scheda prodotto, un'email o un social network.
  • Un codice iframe : da incollare in un blocco HTML personalizzato dell'editor a blocchi di WordPress, sulla pagina prodotto.
  • Un widget : uno script da incollare una volta tramite un plugin come Insert Headers and Footers, o nel tema figlio, che aggiunge un pulsante « Vedi in 3D » sulle tue pagine prodotto.

Gratis per 14 giorni, poi a partire da 49 € + IVA al mese, senza commissioni sulle tue vendite.

Prova gratis Scopri il software
+94%
aumento di conversione nelle schede prodotto con modello 3D
Fonte: Shopify
−40%
di resi dopo la visualizzazione 3D del prodotto
Fonte: Shopify
66%
degli acquirenti si sentono più sicuri con un configuratore 3D
Fonte: Studio 2023
82%
dei visitatori attivano la vista 3D quando è disponibile
Fonte: Cappasity
Installazione

Pronto in 3 passi. Senza plugin dedicato.

Un Web Component nativo : nessuna dipendenza da React, Vue o jQuery. Compatibile con tutti i temi e page builder di WordPress (Elementor, Divi, Bricks).

  1. 1
    Registrare lo script

    Usa wp_enqueue_script() nel tuo functions.php per caricare il componente. Il true finale lo carica nel footer : raccomandato per evitare di bloccare il rendering.

    Lo script CDN è pubblico. Puoi anche includerlo tramite un widget HTML di Elementor o WPCode : in tutti i casi, l'attributo src del componente è l'URL specifica del tuo configuratore, fornita da 3DVue alla consegna.
    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
      );
    });
    
    // O via WPCode : snippet HTML
    // <script src="https://cdn.jsdelivr.net/gh/3dvue/api@v4/viewer-3dvue-min.js"></script>
  2. 2
    Posizionare il componente

    Incolla il tag nel tuo template di prodotto, in uno shortcode PHP o in un blocco HTML di Gutenberg. Due attributi obbligatori: name (identificatore unico) e src (l'URL del tuo configuratore fornita da 3DVue).

    Con Elementor, basta incollare il tag in un widget HTML. Poiché lo script viene già caricato globalmente, non è necessaria nessuna configurazione aggiuntiva.
    single-product.php o widget HTML
    <viewer-3dvue
      name="mioViewer"
      src="https://app.3dvue.fr/view?p=AB01-CD02"
    ></viewer-3dvue>
    
    <!-- Con debug attivato -->
    <viewer-3dvue
      name="mioViewer"
      src="https://app.3dvue.fr/view?p=AB01-CD02"
      debug
    ></viewer-3dvue>
  3. 3
    Collegare le variazioni di WooCommerce

    Aggiungi gli attributi viewer-3dvue nei tuoi elementi <select> delle variazioni native di WooCommerce o nei tuoi swatch personalizzati. Il componente ascolta automaticamente : nessun JS da scrivere.

    variable.php : select variazione colore
    <!-- Su un select esistente di WooCommerce -->
    <select
      name="attribute_pa_colour"
      viewer-3dvue="mioViewer"
      viewer-3dvue-change="setMaterial"
      viewer-3dvue-mesh="1,2"
    >
      <option value="0n">Nero</option>
      <option value="1a">Bianco</option>
      <option value="2b">Rovere naturale</option>
    </select>
    
    <!-- O su un pulsante swatch personalizzato -->
    <button
      viewer-3dvue="mioViewer"
      viewer-3dvue-clic="setMaterial"
      viewer-3dvue-meshs-materials='{"1":"2b","3":"0n"}'
    >Rovere / Nero</button>
Controllo HTML puro

Zero JavaScript.
Tutto con attributi HTML.

Il componente ascolta automaticamente gli eventi click e change su qualsiasi elemento con gli attributi corretti. Compatibile con i select nativi di WooCommerce e plugin swatch (Variation Swatches, ecc.).

setMaterial al clic : swatch personalizzati
Collega qualsiasi pulsante o swatch. Si possono applicare più materiali simultaneamente in una sola azione.
<button
  viewer-3dvue="mioViewer"
  viewer-3dvue-clic="setMaterial"
  viewer-3dvue-meshs-materials='{"1":"0n","3":"2b"}'
>
  Tessuto grigio velluto
</button>

// {"meshIndex": "materialId"}
// Indice 0 riservato : inizia da 1
setMaterial su <select> : variazioni native
Aggiungi 3 attributi al tuo <select> delle variazioni WooCommerce esistente. Il viewer si sincronizza automaticamente.
<select
  name="attribute_pa_colour"
  viewer-3dvue="mioViewer"
  viewer-3dvue-change="setMaterial"
  viewer-3dvue-mesh="1,3"
>
  <option value="0n">Nero</option>
  <option value="1a">Bianco</option>
</select>

// viewer-3dvue-mesh="1,3"
// si applica a mesh 1 E mesh 3
API JavaScript

Per i casi d'uso avanzati.

Controllo programmatico completo : utile per sincronizzare il viewer con le variazioni WooCommerce via JS, o per casi avanzati come cattura immagine o esportazione BAT.

querySelector Ottiene il riferimento del componente : il punto di partenza per tutta l'API JS
const viewer = document.querySelector('viewer-3dvue[name="mioViewer"]');

// Sincronizzare con le variazioni di WooCommerce
document.querySelector('.variations select')
  .addEventListener('change', (e) => {
    viewer.setMaterial({ "1": e.target.value });
  });
setMaterial() Applica materiali a una o più mesh di un oggetto
// Sull'oggetto 0 (default)
viewer.setMaterial({ "1": "0n", "3": "2b" });

// Su un segmento specifico (prodotto multi-parte)
viewer.setMaterial({ "1": "1a" }, 1);
// setMaterial(materialList, objectIndex = 0)
loadModel() / addModel() / removeModel() Gestione dinamica dei modelli : per prodotti configurabili con componenti opzionali
// Carica un modello diverso (es. cambio di forma)
viewer.loadModel("AB01-CD02");

// Aggiunge un componente al modello esistente
// Es: aggiungere un bracciolo, ripiano, gamba
viewer.addModel("EF03");

// Rimuove un componente (l'indice inizia da 0)
viewer.removeModel(1);
// ⚠ Non si può rimuovere l'ultimo segmento rimanente
captureToBase64() Cattura il render corrente come immagine base64 : per email di conferma o riepiloghi d'ordine WooCommerce
viewer.captureToBase64();

viewer.addEventListener("onCaptureBase64Complete", (e) => {
  const { base64, error } = e.detail;
  if (error) return;
  // Salvare in un campo nascosto per l'ordine WC
  document.querySelector('input[name="config_preview"]').value = base64;
});
API SVG : Personalizzazione avanzata

Testi, logo, prove di stampa.
Tutto in SVG.

L'API SVG permette di aggiungere testo e immagini direttamente sul prodotto 3D tramite zone di posizionamento definite nel modello. Viene usata per prodotti personalizzabili : marcatura, caricamento logo, incisione testo.

Metodo Descrizione
addSVGText(text, opts) Aggiunge testo a una zona di posizionamento. Opzioni: fill, fontFamily, selectable
addSVGImage(source, opts) Aggiunge un'immagine (File o ArrayBuffer). Senza copia via Transferable Objects.
setSVGElementParam(param, value, id) Modifica un parametro di un elemento SVG. Senza 3° argomento: si applica all'elemento selezionato.
removeSVGElement(id) Rimuove un elemento SVG (testo o immagine). Senza argomento: rimuove l'elemento selezionato.
exportSVG() Genera il file SVG del prodotto configurato : prova di stampa pronta per la produzione.
Esempio : caricamento logo + esportazione prova
// 1. Caricare logo da un input file di WooCommerce
const file = input.files[0];
viewer.addSVGImage(file, {
  dropzone: "dropzone001",
  selectable: true
});

// 2. Testo personalizzato (incisione, marcatura)
viewer.addSVGText("Il mio testo", {
  fill: "#ffffff",
  fontFamily: "Arial"
});

// 3. Esportare la prova SVG per la produzione
viewer.exportSVG();
viewer.addEventListener("onSVGExportComplete", (e) => {
  const { path } = e.detail;
  // path = URL del file SVG pronto per la stampa
});

Domande frequenti

Come installo il configuratore 3D su WooCommerce?+

Usa wp_enqueue_script() nel tuo functions.php per caricare il componente, poi incolla il tag <viewer-3dvue> nel tuo template di prodotto, uno shortcode o un blocco HTML di Gutenberg. Non è necessario nessun plugin.

Funziona con Elementor e altri page builder?+

Sì. Con Elementor, basta incollare il tag in un widget HTML. Dato che lo script viene caricato globalmente, non è necessaria nessuna configurazione aggiuntiva.

Come collego i select delle variazioni di WooCommerce?+

Aggiungi gli attributi viewer-3dvue direttamente nei tuoi elementi <select> delle variazioni native di WooCommerce, o su pulsanti swatch personalizzati. Il componente ascolta automaticamente : nessun JS da scrivere.

Posso catturare il prodotto configurato come immagine per l'ordine?+

Sì. Usa captureToBase64() per ottenere un'immagine PNG del render corrente e salvala in un campo nascosto del modulo d'ordine di WooCommerce.

Quanto costa un configuratore 3D per WooCommerce?+

Un configuratore su misura parte da 5.000 € + IVA, su preventivo: modellazione, interfaccia nello stile del vostro marchio, integrazione, hosting e supporto umano sono inclusi. Per provarlo in autonomia, il software self-service è gratuito per 14 giorni, senza carta di credito, poi da 49 € + IVA al mese.
Documentazione completa

Riferimento API, attributi HTML, eventi, esempi PHP di WooCommerce. Tutto documentato e mantenuto aggiornato.

Vedi la documentazione
Supporto tecnico umano

Nessun sistema di ticket automatizzato. Parli direttamente con Matthieu, lo sviluppatore che ha progettato l'API. Risposta in meno di 24 ore.

Prenota una chiamata
Demo interattiva

Prova il configuratore in condizioni reali prima di integrarlo. Vedi esattamente quello che vedranno i tuoi clienti nel tuo negozio WooCommerce.

Vedi la demo
Integriamo insieme

Pronti a integrare?
Noi ci occupiamo dei modelli 3D.

Voi gestite il codice lato WooCommerce, noi ci occupiamo del resto : modellazione, materiali, configurazione. In 30 minuti vi mostriamo cosa possiamo fare con il vostro catalogo.

Script consegnato alla fine : pronto da integrare
ID modello e materiale documentati per progetto
Supporto diretto con lo sviluppatore dell'API
Compatibile WooCommerce 8+, tutti i temi e builder
Utilizziamo cookie di misurazione del pubblico per capire come utilizzi il nostro sito.