Get Started

Collegamento del tuo Store #

Il primo passo per installare Clerk.io è collegare il tuo store al tuo account Clerk.io.

Il video qui sotto ti mostra cosa fare, passo dopo passo. Usa il resto della guida come riferimento :)

Dopo aver seguito questi semplici passaggi, potrai vedere il tuo Live Demo Store, che ti offre una panoramica personale di come Clerk.io funzionerà sul tuo webshop. Contatta il tuo referente Clerk.io per vedere la Live Demo.

1. Aggiungi Store #

1. Accedi a my.clerk.io. La prima volta che lo fai, vedrai la pagina Aggiungi Nuovo Store.

2. Inserisci il Nome e il Dominio del tuo webshop.

3. Scegli Shopware 6 come Piattaforma e seleziona la tua Valuta.

4. Clicca su Add Store.

2. Installa e configura il plugin #

Per Shopware v6.4 e successive, il plugin può essere installato dallo Shopware Extension Store o caricandolo manualmente da GitHub.

Opzione A: Installa dallo Extension Store

1. Nell’Admin di Shopware, vai su Extensions > Store e cerca “Clerk”.
2. Clicca su Add extension per installare.

Opzione B: Installa manualmente da GitHub

Se il plugin non è disponibile nello Shopware Extension Store, può essere scaricato da GitHub e caricato manualmente.

1. Vai ai Clerk Shopware 6.4 plugin releases su GitHub e scarica l’ultimo file .zip.
2. Nell’Admin di Shopware, vai su Extensions > My extensions.
3. Clicca su Upload extension e seleziona il file .zip scaricato.
4. Una volta caricato, clicca su Install e quindi attiva il plugin.

Per Shopware v6.3 e precedenti:

1. Scarica il plugin: Releases for v6.3 and earlier.
2. Nell’Admin di Shopware, vai su Settings > System > Plugins.
3. Clicca su Upload plugin, scegli il file scaricato, poi ... > Install e attiva.

Configura il plugin:

1. Clicca su ... > Config. sul plugin Clerk.
2. Seleziona il corretto Sales Channel.
3. In General, imposta Status su Enabled.
4. Inserisci la tua Public Key e Private Key, poi clicca su Save.

Dove trovare le chiavi: la tua Public Key e Private Key sono in my.clerk.io > Developers > API Keys.

3. Sincronizza i tuoi dati #

La sincronizzazione dei dati collega il tuo store Shopware 6 a Clerk, permettendo a Clerk di accedere a prodotti, ordini, clienti e altre informazioni del negozio. Questo consente a Clerk di fornire raccomandazioni personalizzate e risultati di ricerca basati sui dati effettivi del tuo store. Segui i passaggi nella guida Sync Data per impostare la sincronizzazione dati.

Configurazioni Headless #

Per installazioni Shopware headless, crea un canale di vendita Storefront nascosto con le stesse lingue e valute del tuo shop principale. Clerk utilizza il canale Storefront per risolvere riferimenti alla lingua e valuta durante la sincronizzazione.

• Crea un canale di vendita Storefront e mantienilo nascosto dalla navigazione.
• Aggiungi tutte le lingue e valute utilizzate dal tuo shop headless.
• Seleziona questo canale di vendita Storefront nella configurazione del plugin Clerk al momento della configurazione della sincronizzazione.

Questo assicura che tutti i riferimenti a lingua e valuta siano disponibili affinché la sincronizzazione dati venga completata correttamente.

Per dettagli su come creare e configurare i canali di vendita, consulta la documentazione Shopware: Sales Channel settings.

Più lingue #

Shopware utilizza gli ID Lingua per identificare ogni lingua unica all’interno del webshop. Questi non sono visibili nel backend di Shopware, quindi devono essere individuati nell’HTML del frontend.

Guarda questo video per vedere come identificare gli ID lingua.

Il modo migliore per gestire il multi-lingua in Clerk è creare Store unici per ogni lingua e sincronizzarli con l’ID Lingua corretto.

In questo modo puoi separare prodotti, vendite, valute, ecc., per tenere traccia di ogni lingua.

1. Inizia creando il tuo main Store e segui la Setup Guide per collegare il tuo Store a Clerk.io e scegliere i Recommendations e/o Search Results che desideri visualizzare sul tuo webshop.

2. Una volta terminata la configurazione iniziale, torna alla pagina iniziale di my.clerk.io (cliccando sul logo Clerk.io nell’angolo in alto a sinistra del menu laterale) e poi clicca su "+ Add new store", l’ultima opzione della lista a discesa (in genere sotto i tuoi store esistenti e il nome dell’azienda):

3. Nella pagina Add New Store, clicca su Advanced per vedere tutte le impostazioni.

4. Inserisci i dati del tuo webshop e scegli il tuo main Store dal menu a tendina Copy Elements From Existing Store, poi clicca su Add Store. Questo trasferirà gli Elements e i Designs dal tuo main Store.

5. Ora puoi seguire di nuovo la Setup Guide, per attivare Clerk.io cliccando su Getting Started, per Sync Data per questa lingua. Ricorda di usare il corretto Language ID come descritto nel video in alto alla guida. L’URL dello Store, Access Key e Secret Access Key saranno gli stessi per tutti gli Store.

6. Quando la Data Sync è terminata, il tuo webshop è pronto e utilizza la stessa configurazione del tuo main Store.

7. Ricorda di tradurre le Headlines in Element-> Edit -> Select Design nella lingua corretta.

   Puoi seguire questo processo per tutte le lingue del webshop con cui vuoi utilizzare Clerk.io.