FAQ

Stai riscontrando problemi con la tua integrazione Magento 2? Questa FAQ copre i problemi più comuni e le loro soluzioni, dalle dimensioni delle immagini agli errori di sincronizzazione.

Dimensioni delle immagini #

Per impostazione predefinita, l’estensione utilizza le dimensioni originali delle immagini impostate in Magento 2.

Queste possono essere modificate se necessario.

Inizia accedendo al backend di Magento 2 e vai a:

Sotto Synchronization > Image type, puoi scegliere esattamente quale risoluzione utilizzare per inviare le immagini:

Dopo, clicca su Save Config.

Ora devi semplicemente eseguire una nuova Sync in my.clerk.io e le nuove dimensioni delle immagini verranno importate.

Utilizzo dei formatter #

Clerk.js ti permette di scrivere funzioni JavaScript personalizzate che aggiungono nuova funzionalità ai tuoi Designs.

I formatter possono essere aggiunti in due modi:

• Tramite my.clerk.io > Developers > Formatters, dove ogni Formatter può essere creato come voce separata.

• Come configuration per Clerk.js, nello tracking-script che viene inserito su tutte le pagine, dove possono essere aggiunti più formatter contemporaneamente.

Per Magento 2, questo file contiene lo tracking-script:

vendor->view->frontend->templates->tracking.phtml

Esempio di formatter #

Un esempio è visibile qui sotto. Nota che questo è per Clerk V2 (ultima versione):

    Clerk('config', {
      key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
      formatters: {
             log_price: function(price) {
             console.log(price);
    }
          }
      });

Più formatter #

Puoi scrivere qualunque numero di Formatters, separati da virgole:

formatters: {
   log_price: function(price) {
      console.log(price);
   },
  calculate_discount: function(price, special_price) {
    return price - special_price;
   },
   substring: function(text) {
    var short_string = text.substring(0, 20);
      return short_string;
   }
}

Uso nei design #

Dopo aver creato i tuoi Formatters, puoi usarli nei tuoi Designs con questa sintassi:

{% raw %}{{ price | log_price }} {{ price | calculate_discount | special_price }}{% endraw %}

Ciò ti permette di creare qualsiasi funzionalità necessaria nei tuoi Designs.

Autenticazione HTTP #

L’autenticazione HTTP viene spesso utilizzata sui siti di staging per evitare visitatori indesiderati.

Questo bloccherà l’importatore Clerk e mostrerà un errore 401 Unauthorized nel registro di sincronizzazione.

Puoi risolverlo inserendo le informazioni di autenticazione nell’URL di importazione.

In my.clerk.io > Data > Configuration, aggiorna il tuo URL di importazione in questo modo:

http://USER:PASS@magento2.clerk.io/

Errori comuni di sincronizzazione #

Nota: Raccomandiamo di aggiornare sempre l’estensione all’ultima versione per ottenere tutte le funzionalità aggiornate da Clerk.

Quando importi dati con l’estensione Magento 2 di Clerk, il server del tuo webshop è responsabile dell’invio di product, category, and sales data a Clerk.

Tuttavia, in alcuni casi, la configurazione del server può bloccare l’importazione dall’accesso ai dati, causando un errore in Data Sync.

Di seguito è riportato un elenco degli errori più comuni e come risolverli.

401 Unauthorized #

Questo errore si verifica se il tuo webshop o ambiente di sviluppo richiede HTTP authentication per essere accessibile.

Si risolve inserendo il Nome utente e la Password come parte dell’Import URL:

http://username:password@magento2.clerk.io

403 Forbidden #

Questo errore accade spesso per uno di questi motivi:

• Il tuo server blocca l’importatore dall’accesso. Nella maggior parte dei casi, è sufficiente whitelistare l’indirizzo IP dell’importatore per dargli accesso. L’ultimo indirizzo IP può essere trovato qui.

• Potresti avere una public key, private key e/o import URL non corretta all’interno dello store su my.clerk.io.

• Stai utilizzando Storeviews con URL nascosti, come mywebshop.com?__store=b2b. A volte, questi URL possono anche contenere 3 underscore come in: mywebshop.com?___store=b2b.

Se quest’ultimo caso, basta includere il parametro __store nell’URL in Data:

E se ho già whitelistato ma l’errore si ripresenta comunque?

Ci sono alcuni casi in cui hai già whitelisted l’indirizzo IP dell’importatore, ma l’errore persiste.

In questi casi, consigliamo di verificare queste situazioni:

• La parte di autenticazione del body potrebbe essere rimossa dalla richiesta dal server dello shop.

• Limite di richieste per il server in riferimento a Cloudflare.

404 Not Found #

Questo errore si verifica se l’importatore non ha potuto accedere al link che invia dati dal webshop.

Nella maggior parte dei casi, succede perché l’estensione è:

• Non installata affatto

• Una cache fa sì che il link non venga inizializzato

Per prima cosa, assicurati di aver installato correttamente l’estensione.

In secondo luogo, assicurati di svuotare la cache del tuo webshop prima di tentare una nuova importazione.

429 Too Many Requests #

Questo errore si verifica se il tuo server nega l’accesso all’importatore a causa di troppe richieste in ingresso.

Puoi risolverlo impostando il request limit più alto per il tuo server o impostando Page Size su un valore più alto in my.clerk.io > Data > Configuration, facendo sì che l’importatore effettui meno richieste, ma più grandi:

Se stai utilizzando il provider hypernode.com/nl, l’importatore generalmente restituisce questo errore a causa del loro rate limiter. In questo caso, contatta hypernode.com/nl e chiedi loro di whitelistare lo User-Agent dell’importatore “clerk”.

500 Internal Server Error #

Questo errore significa che il tuo server ha riscontrato un errore interno e non è stato in grado di specificare quale errore si sia verificato.

In questi casi, controlla il Server Log per identificare quale processo è andato in crash e perché.

Nella maggior parte dei casi, è semplicemente dovuto a un prodotto con un attributo non valido, o a una funzione chiamata in modo errato nel webshop.

503 Service Unavailable #

Questo errore di solito è temporaneo ed è causato dal server troppo occupato per gestire la richiesta.

Riprova più tardi.

Se il problema persiste, potrebbe significare che il server è sovraccarico di processi ed è vicino alla capacità massima.

Controlla il carico del server per identificare se questo è il caso.

Invalid response #

Questo errore si verifica di solito se il tuo webshop sta utilizzando un sistema di redirect per inviare i clienti a domini differenti.

Ad esempio, andando su “ https://mywebshop.com” potresti essere reindirizzato su “ https://mywebshop.com/it".

In questo caso, è semplicemente necessario utilizzare l’URL completo quando importi in my.clerk.io:

Importazione stock MSI #

Se il tuo store Magento 2 utilizza MSI (Multi-Source Inventory), puoi importare lo stock totale da tutte le fonti in Clerk aggiungendo il codice attributo qui sotto ai Campi Aggiuntivi dell’estensione.

1. Nel tuo admin di Magento, vai su Stores > Configuration > Clerk > Configuration.

2. Sotto Synchronization > Additional Fields, aggiungi: multi_source_stock.

3. Clicca su Save Config e poi esegui una nuova sincronizzazione in my.clerk.io > Data.

Clerk importerà multi_source_stock come la somma delle quantità di tutte le fonti MSI.

Questo è utile quando la fonte di stock predefinita è 0 ma i prodotti sono ancora disponibili in altre fonti.

Upgrade a Clerk.js 2 #

Clerk.js 2 è una versione più veloce e flessibile della nostra libreria JavaScript.

Rende più facile l’installazione di Clerk su qualsiasi webshop.

Tuttavia, poiché le due versioni funzionano in modo leggermente diverso, è necessario seguire questi passaggi per aggiornare con successo.

Le due principali differenze in Clerk.js 2 sono che i Designs in my.clerk.io utilizzano il linguaggio di templating Liquid, ma possono anche essere facilmente creati utilizzando il Design Editor.

Crea i design #

Visto che Clerk.js 2 ha un approccio diverso ai Designs, è necessario crearne di nuovi.

Puoi creare i tuoi Designs per Clerk.js 2 in uno dei seguenti modi:

• Utilizza il Design Editor intuitivo per creare nuovi Designs, come descritto nei punti seguenti.

• Converti i tuoi vecchi Designs. Segui questa guida per sapere come fare.

Opzione Design Editor #

1. Vai su my.clerk.io > Recommendations/Search > Designs > New Design.

2. Nella schermata successiva, dai al tuo Design un Nome (consigliamo di aggiungere “V2” così è ovvio che stai usando Clerk.js 2).

3. Scegli il Design Type.

4. Nel Design Editor, clicca su uno qualsiasi degli elementi esistenti come nome, immagine, pulsante ecc. per modificarlo, oppure aggiungi nuovi elementi al Design per inserire più informazioni sui prodotti.

5. Clicca su Publish quando hai terminato, e vai al Step 2 nella guida.

6. Vai su Recommendations/Search > Elements e cambia il tuo Clerk Content per utilizzare il nuovo Design.

7. Clicca su Update Content. Questo farà sì che temporaneamente non vengano mostrati sul tuo webshop, finché non avrai terminato il Step 2. Scegli il nuovo Design per tutto il Content che deve essere aggiornato.

Ora sei pronto per passare a Clerk.js 2.

Aggiornare l’estensione #

ATTENZIONE: Ricorda di fare backup di tutti i file modificati, poiché verranno sovrascritti.

L’upgrade dell’estensione Magento 2 viene effettuato tramite linea di comando.

Si esegue seguendo questi passaggi:

1. Accedi al tuo server tramite linea di comando.

2. Naviga nella cartella webroot (di solito _/var/www/your_domain/public_html_).

3. Abilita i permessi di Root digitando su e quindi inserendo la password.

4. Digita i seguenti comandi in ordine:

composer update clerk/magento2
php bin/magento setup:upgrade
php bin/magento setup:di:compile

5. Attendi la fine dell’upgrade dell’estensione.

Ora il tuo Magento 2 è aggiornato all’ultima versione.

Hai ora l’ultima versione di Clerk per Magento 2 installata, e Clerk.js 2 è in esecuzione nel tuo webshop!

La documentazione completa per Clerk.js 2 è disponibile qui:

https://docs.clerk.io/docs/clerkjs-quick-start

Gestione di require.js #

Questa guida si applica solo fino alla v.2.8.3 dell’estensione Magento 2 Clerk.

In alcune configurazioni, Require.js impedisce il caricamento di Clerk.js, il che implica che slider o risultati di ricerca non verranno mostrati.

Quando ciò accade, il seguente errore apparirà nella console:

Uncaught ReferenceError: Clerk is not defined

L’estensione Magento 2 già gestisce Require.js, ma in alcuni casi è necessario far sì che ignori Clerk.js.

Puoi farlo in questo file:

vendor->clerk->magento2->templates->tracking.phtml

Inserisci semplicemente window.__clerk_ignore_requirejs = true; in cima allo tracking script:

Dopo aver utilizzato questo approccio, Require.js sarà ora compatibile con Clerk.