Magento 2

FAQ

Cambiare le dimensioni delle immagini #

Per impostazione predefinita, l’estensione utilizza le dimensioni originali delle immagini impostate in Magento 2, ma queste possono essere modificate se necessario.

Inizia accedendo al tuo backend di Magento 2 e vai a:

Negozi -> Configurazione -> Clerk -> Configurazione

Sotto Sincronizzazione-> Tipo di immagine puoi scegliere esattamente quale risoluzione utilizzare per inviare le immagini:

Dopo, fai clic su Salva Config.

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

Utilizzare i formattatori nei design #

Clerk.js ti consente di scrivere funzioni javascript personalizzate, che aggiungono nuova funzionalità ai Design.

I formattatori possono essere aggiunti in due modi:

Tramite my.clerk.io > Impostazioni > Formattatori, dove ogni formattatore può essere creato come voci separate.
Come una configurazione per Clerk.js, nello script di tracciamento che viene inserito in tutte le pagine, dove possono essere aggiunti più formattatori contemporaneamente.

Per Magento 2, questo file contiene lo script di tracciamento:

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

Un esempio può essere visto qui sotto. Si prega di notare che questo è per Clerk V2 (ultima versione):

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

Puoi scrivere qualsiasi numero di Formattatori, separati da virgola:

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;
   }
}

Dopo aver creato i tuoi formattatori, puoi usarli nei tuoi Design utilizzando questa sintassi:

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

Questo ti consente di creare qualsiasi funzionalità nei tuoi Design di cui hai bisogno.

Sincronizzazione con HTTP Auth #

Spesso l’autenticazione HTTP viene utilizzata sui siti di staging per evitare visitatori indesiderati.

Questo bloccherà anche l’importatore Clerk e visualizzerà un errore 401 Non autorizzato nel registro di sincronizzazione.

Puoi facilmente verificare l’importatore inserendo le informazioni di autenticazione nell’URL di importazione come di seguito, in Data Sync su my.clerk.io:

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

Problemi comuni di sincronizzazione #

Nota: Ti consigliamo di aggiornare sempre il plugin all’ultima versione per ottenere tutte le funzionalità aggiornate da Clerk.

Quando importi dati con l’estensione Magento 2 di Clerk.io, il server del webshop è responsabile dell’invio dei dati di prodotto, categoria e vendita a Clerk.io.

Tuttavia, in alcuni casi, la configurazione del server potrebbe impedire all’importazione di accedere, causando un errore in Data Sync.

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

Errore 401 Server: Non autorizzato #

Questo errore si verifica se il tuo ambiente webshop/dev richiede autenticazione HTTP per accedervi.

Questo si risolve semplicemente inserendo il Nome utente e la Password come parte dell’URL di importazione:

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

Errore 403 Server: Vietato #

Questo errore si verifica spesso per uno di questi motivi:

Il tuo server blocca l’importatore dall’accesso. Nella maggior parte dei casi devi semplicemente aggiungere alla lista bianca l’indirizzo IP dell’importatore per dargli accesso. L’ultimo indirizzo IP può essere trovato qui.
Potresti avere una chiave pubblica, chiave privata e/o url di importazione errate all’interno del negozio in my.clerk.io
Stai utilizzando Storeviews con URL nascosti, come mywebshop.com?__store=b2b. A volte, questi URL possono anche contenere 3 underscore come questo: mywebshop.com?___store=b2b

Se è quest’ultimo caso, includi semplicemente il parametro __store nell’URL in Data:

Cosa fare se ho già aggiunto alla lista bianca ma si verifica ancora lo stesso errore?

Ci sono alcuni casi in cui hai aggiunto alla lista bianca l’indirizzo IP dell’importatore e l’errore persiste, quindi ti consigliamo di esaminare questi.

La parte di autenticazione del corpo potrebbe essere rimossa dalla richiesta dal server del negozio.
Limite di frequenza per il server riguardo a cloudflares.

Errore 404 Server: Non trovato #

Questo errore si verifica se l’importatore non è riuscito ad accedere al link che ci invia dati dal webshop. Nella maggior parte dei casi si verifica perché l’estensione è:

Non installata affatto
Una cache causa il link di non essere inizializzato

Prima assicurati di aver installato correttamente l’estensione.

Secondo, assicurati di svuotare la cache del tuo webshop prima di provare un nuovo import.

Errore 429 Server: Troppe richieste #

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

Puoi risolvere questo impostando il limite di richiesta più alto per il tuo server o impostando la Dimensione della pagina a un valore più alto nell’ importatore Clerk.io, causando all’importatore di effettuare richieste più grandi e meno frequenti:

Se stai utilizzando il provider di hosting hypernode.com/nl, l’importatore restituisce solitamente questo errore a causa del loro limitatore di frequenza. In questo caso, contatta semplicemente hypernode.com/nl e chiedi loro di aggiungere alla lista bianca l’User-Agent dell’importatore " clerk".

Errore 500 Errore interno del server #

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

In questi casi puoi controllare il tuo Registro del server per identificare quale processo è andato in crash e perché. Nella maggior parte dei casi è semplicemente a causa di un prodotto con un attributo non valido, o una funzione chiamata in modo errato nel webshop.

Errore 503 Server: Servizio non disponibile #

Questo errore è solitamente temporaneo ed è causato dal server che è troppo occupato per gestire la richiesta. Riprova più tardi.

Se il problema continua a verificarsi, potrebbe significare che il server è sovraccarico di processi e vicino alla capacità massima.

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

Risposta non valida ricevuta #

Questo errore si verifica solitamente se il tuo webshop utilizza un sistema di reindirizzamento per inviare i clienti a domini diversi.

Ad esempio, andare su " https://mywebshop.com" potrebbe reindirizzare a " https://mywebshop.com/it"

Se è questo il caso, devi semplicemente utilizzare l’URL completo durante l’importazione in my.clerk.io:

Aggiornamento a Clerk.js 2 #

Clerk.js 2 è una versione più veloce e molto più flessibile della nostra libreria JavaScript che rende l’installazione di Clerk.io su qualsiasi webshop un gioco da ragazzi.

Tuttavia, poiché le due versioni funzionano in modo leggermente diverso, è necessario seguire questi passaggi per eseguire correttamente l’aggiornamento.

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

Passo 1: Convertire i Design #

Poiché Clerk.js 2 ha un approccio diverso ai Design, devi crearne di nuovi.

Puoi creare i tuoi Design Clerk.js 2 in uno dei due modi:

1. Usa l’intuitivo Editor di Design per creare nuovi Design, come descritto nei punti seguenti.
2. Converti i tuoi vecchi Design. Segui questa guida per vedere come farlo.

1.1 Inizia andando su my.clerk.io -> Raccomandazioni / Ricerca -> Design e fai clic su Nuovo Design:

1.2 Nella schermata successiva, dai al tuo Design un Nome (ti consigliamo di aggiungere " V2" in modo che sia ovvio che stai utilizzando Clerk.js2).

1.3. Scegli il Tipo di Design.

1.4. Nell’Editor di Design, fai clic su uno degli elementi esistenti come il nome, l’immagine, il pulsante ecc. per modificarlo, o aggiungi nuovi elementi al Design per aggiungere ulteriori informazioni sui prodotti.

1.5. Fai clic su Pubblica quando hai finito e vai al Passo 2 nella guida.

1.6. Infine, vai su Raccomandazioni / Ricerca -> Contenuto e modifica il tuo Clerk.io Contenuto per utilizzare il tuo nuovo Design.

1.7. Fai clic su Aggiorna Contenuto. Questo causerà temporaneamente che non vengano visualizzati sul tuo webshop, fino a quando non hai finito con il Passo 2. Scegli il nuovo Design per tutto il Contenuto che deve essere aggiornato.

1.9. Ecco! Ora sei pronto per passare a Clerk.js 2.

Passo 2: Aggiornare la tua estensione #

ATTENZIONE: Ricorda di fare il backup di qualsiasi file modificato, poiché verranno sovrascritti.

L’aggiornamento dell’estensione Magento 2 viene eseguito tramite commandline.

Si esegue seguendo questi passaggi:

2.1. Accedi al tuo server tramite commandline.

2.2. Naviga nella tua cartella webroot (di solito " /var/www/your_domain/public_html")

2.3. Abilita Accesso Root digitando su e poi inserendo la tua password.

2.4. Digita i seguenti comandi in ordine:composer update clerk/magento2php bin/magento setup:upgradephp bin/magento setup:di:compile

2.5. Aspetta che l’estensione finisca.

Il tuo Magento 2 è ora aggiornato all’ultima versione.

Ora hai installato l’ultima versione di Clerk.io per Magento 2 e Clerk.js 2 è in esecuzione sul tuo webshop!

La documentazione completa per Clerk.js 2 può essere trovata qui:

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

Gestire require.js #

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

In alcune configurazioni, Require.js impedisce a Clerk.js di caricarsi, il che significa che non verranno mostrati slider o risultati di ricerca.

Quando ciò accade, verrà visualizzato il seguente errore nella tua console:

Uncaught ReferenceError: Clerk is not defined

L’estensione Magento 2 gestisce già Require.js, ma in alcuni casi è necessario farlo ignorare a Clerk.js.

Puoi farlo nel seguente file:

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

Inserisci semplicemente window.__clerk_ignore_requirejs = true;

nella parte superiore dello script di tracciamento:

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

Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.