Domande Frequenti

Qui puoi trovare soluzioni ai problemi più comuni relativi al Plugin Shopify ARShades.

Generali e Installazione

Il pulsante "Virtual Try-On" non appare sulla pagina prodotto.

Questo è il problema più comune e di solito ha una di queste cause:

1. Prodotto non sincronizzato: Assicurati che il prodotto sia stato sincronizzato con successo nella Dashboard ARShades e che abbia uno stato "Ready" valido.
2. Metafield mancanti: Il plugin si basa sui Metafield di Shopify. Verifica se la variante del prodotto ha il campo arshades.catalogueVariantId compilato.
3. Compatibilità del tema: Se stai utilizzando un tema legacy, potresti dover usare l'Integrazione Manuale invece degli App Blocks.
4. Modalità anteprima: Se stai visualizzando un tema in bozza, assicurati che l'App Embed sia abilitato in quel contesto specifico del tema.

Ho aggiornato il mio tema Shopify e il plugin è scomparso.

Se stai utilizzando gli App Blocks (OS 2.0), i blocchi sono legati ai template specifici del tema. Quando cambi o aggiorni un tema, devi ri-aggiungere gli App Blocks tramite l'Editor Tema.

Se hai usato l'Integrazione Manuale, le tue modifiche al codice nei file .liquid vengono sovrascritte durante un aggiornamento del tema. Devi ri-applicare il codice di integrazione.

Esperienza Virtual Try-On (VTO)

Il VTO si apre, ma mostra gli occhiali/colore sbagliati.

Questo di solito accade quando l'evento "Variant Change" non viene rilevato correttamente.

• App Blocks: Assicurati che il blocco sia posizionato all'interno della Sezione Prodotto principale.
• Integrazione Manuale: Verifica che il tuo Javascript personalizzato stia ascoltando l'evento corretto (es. variant:changed, variantChange) usato dal tuo tema specifico per aggiornare lo SKU quando l'utente seleziona un colore diverso.

Il Visualizzatore 3D funziona, ma il Virtual Try-On no.

Il Visualizzatore 3D e il VTO sono moduli separati.

• Il Visualizzatore 3D richiede il catalogueProductId.
• Il VTO richiede il catalogueVariantId.

Se solo uno funziona, è probabile che uno dei due Metafield sia mancante o che l'asset non sia collegato correttamente nella Dashboard ARShades.

La modale è tagliata o non centrata sui dispositivi mobile.

La modale ARShades è responsive per impostazione predefinita. Tuttavia, alcuni CSS del tema potrebbero entrare in conflitto con lo z-index o la larghezza del contenitore. Puoi regolare l'aspetto mobile modificando l'oggetto di configurazione in window.ARShadesVTOConfig:

window.ARShadesVTOConfig = {
  // ... other settings
  modalWidthMobile: 100,
  modalHeightMobile: 100,
  modalRadiusMobile: 0
};

ARPDMeter (PD Meter)

Vedo "VTO bundle not loaded. Ensure vto-embed-loader is enabled in theme settings."

Il blocco ARPDMeter dipende dall'ARShades VTO Embed App Embed per caricare il bundle JavaScript richiesto. Se l'embed non è abilitato, il pulsante PD Meter non può funzionare.

Per risolvere:

1. Vai a Shopify Admin > Online Store > Themes > Customize.
2. Nella barra laterale sinistra, clicca l'icona App Embeds (in basso a sinistra).
3. Trova ARShades VTO Embed e attiva l'interruttore su On.
4. Clicca Save.

Questo passaggio è richiesto anche se non stai utilizzando le funzionalità VTO. L'ARShades VTO Embed funge da caricatore globale di risorse per tutti i componenti ARShades, incluso il PD Meter.

Licenza e Configurazione

Vedo un messaggio "Licence Error" o "Invalid Domain".

Per motivi di sicurezza, il plugin ARShades funziona solo sui domini autorizzati nella tua Licenza.

1. Vai su ARShades Studio > Impostazioni.
2. Assicurati che il tuo dominio Shopify (sia myshopify.com che il dominio personalizzato) sia nella whitelist.
3. Verifica che il shop.metafields.arshades.catalogueId corrisponda al tuo effettivo Catalogue ID.

Posso usare il plugin su uno store di sviluppo?

Sì. Tuttavia, l'URL dello store di sviluppo (es. dev-store.myshopify.com) deve essere aggiunto alla lista dei domini consentiti nella dashboard di ARShades Studio.