Magento 1

FAQ

Gestione della conversione di valuta #

Dalla v3.0.3 dell’estensione Magento 1, la Conversione di Valuta è inclusa per impostazione predefinita, se stai utilizzando la funzione di conversione standard di Magento 1.

È aggiunta in my.clerk.io -> Designs, con il formatter price_in_currency.

Il helper può essere aggiunto al tuo Design nel seguente modo:

{%raw%}
<div class="clerk-product-price">
{{ product.price_final_excl_tax | price_in_currency }}
</div>{%endraw%}

Il helper convertirà automaticamente il prezzo nella valuta della sessione corrente e aggiungerà il simbolo della valuta.

Esempio di output:

Utilizzo dei formatter nei design #

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

I formatter possono essere aggiunti in due modi:

  • Attraverso my.clerk.io > Settings > Formatters, dove ogni Formatter può essere creato come voci separate.
  • Come configurazione per Clerk.js, nello script di tracciamento che è inserito in tutte le pagine, dove più formatter possono essere aggiunti contemporaneamente.

Per Magento 1 questo file contiene lo script di tracciamento:

app->design->frontend->base->default->template->clerk->tracking.phtml

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

    Clerk('config', {
      key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
      formatters: {
                form_key: function () {
                    return '<?php echo $this->getFormKey(); ?>';
                },
                price_in_currency: function(price) {
                    price =  Math.round(price * 100) / 100;
                    var price_converted = Math.round((price * <?php echo (float)$rates[$currentCurrencyCode]; ?>) * 100) / 100;
                    var retVal = <?php echo json_encode($currentCurrencySymbol); ?> + ' ' + price_converted.toFixed(2).toString();

                    return retVal;
                },
                log_price: function(price) {
                   console.log(price);
                }
            }
        });

Puoi scrivere qualsiasi numero di Formatters, 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 Formatters, puoi usarli nei tuoi Designs utilizzando questa sintassi:

{%raw%}{{ x  formatter | attribute }} {{ x | formatter | attribute1 | attribute2 }}{%endraw%}

Questo ti consente di creare qualsiasi funzionalità nei tuoi Designs 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 Unauthorized 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@magento.clerk.io/clerk/api/store/1:

Problemi di sincronizzazione comuni #

Nota: Ti consigliamo di aggiornare sempre l’estensione all’ultima versione per ottenere tutte le funzionalità aggiornate da Clerk.
Quando si importano dati con l’estensione Magento 1, il server del webshop è responsabile dell’invio dei dati su prodotti, categorie e vendite a Clerk.io.

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

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

Errore Server 401: Non autorizzato #

Questo errore si verifica se il tuo webshop/ambiente di sviluppo 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@magento.clerk.io/clerk/api/store/1

Errore Server 403: Vietato #

Questo errore si verifica se il tuo server blocca l’importatore dall’accesso. Nella maggior parte dei casi è sufficiente aggiungere alla lista bianca l’indirizzo IP dell’importatore per dargli accesso.

L’ultimo indirizzo IP può essere trovato qui.

Controlla anche che la tua chiave pubblica, chiave privata e url di importazione siano corrette per il negozio in cui stai operando su my.clerk.io

E 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 controllare queste parti:

  • La parte di autenticazione del corpo potrebbe essere rimossa dalla richiesta dal server del negozio.

  • Limite di frequenza per il server riguardo ai cloudflare.

Errore Server 404: Non trovato #

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

  • Non installata affatto

  • Una cache impedisce l’inizializzazione del link

Prima assicurati di aver installato correttamente l’estensione.

In secondo luogo, assicurati di svuotare la cache del tuo webshop prima di provare un nuovo import.

Errore Server 429: Troppi richieste #

Questo errore si verifica se il tuo server nega l’accesso all’importatore 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 Pagina a un valore più alto nell’importatore Clerk.io, causando all’importatore di fare meno richieste più grandi:

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

Errore Server 500: Errore interno del server #

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

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 di una funzione chiamata in modo errato nel webshop.

Errore Server 503: Servizio non disponibile #

Questo errore è solitamente temporaneo ed è causato dal server che è troppo occupato per gestire la richiesta. Prova di nuovo 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.

API Magento: "" #

Questo errore significa anche che il tuo server ha incontrato un errore interno e non è stato in grado di specificare quale errore o codice di errore sia accaduto.

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 il tuo limite di memoria è stato superato.

Passaggio di aggiunta al carrello non mostrato #

Se il passaggio Aggiungi al carrello non è attivato, di solito è dovuto a due motivi:

  • Hai un altro popup o funzione di aggiunta al carrello abilitata che blocca la funzione di Clerk.io

  • Gli ID di contenuto errati sono stati inseriti nell’estensione.

Un altro popup di aggiunta al carrello è abilitato

Inizia controllando la tua installazione Magento esistente, per vedere se hai già un popup o un dropdown che viene mostrato quando aggiungi un prodotto al carrello.

Questi possono normalmente impedire il passaggio di aggiunta al carrello di Clerk.io di mostrarsi.

Se questo è il caso, disattivalo e riprova.

ID di contenuto errati sono stati inseriti nell’estensione

Se non hai altri popup di aggiunta al carrello e il tuo passaggio di potenza è attivato ma non viene mostrato, è probabile che gli ID di template errati siano stati inseriti nelle impostazioni dell’estensione Clerk.io. Questo causerà il fallimento del Passaggio di Potenza.

Per risolvere questo, inizia accedendo all’amministratore di Magento e vai su System->Configuration->Clerk->Settings

Quindi scegli il corretto Ambito di Configurazione che corrisponde al tuo negozio.

Sotto Impostazioni del passaggio di potenza, controlla il campo Templates.

Questo campo dovrebbe contenere gli ID corretti separati da virgole, se ne usi più di uno.

Per assicurarti che i tuoi ID siano corretti, accedi a my.clerk.io.

Scegli il corretto Negozio e vai su Recommendations/Search -> Content.

Fai clic su Modifica Contenuto per un slider che desideri mostrare nel passaggio di potenza.

Controlla l’ultima scheda " Inserisci nel sito web" e trova il codice di incorporamento.

L’ID trovato in data-template è l’ID che devi copiare nell’estensione Magento:

Fai clic su Salva Config nell’estensione Magento e il Passaggio di Potenza dovrebbe funzionare successivamente.

Se hai attivato il popup del passaggio di potenza e non viene ancora mostrato quando aggiungi un prodotto al carrello, il problema è spesso causato dalla Cache.

1. Inizia andando su System => Cache e svuota tutte le Cache Interne e di Terze Parti.

2. Se non risolve, è probabile che tu stia utilizzando la Cache della Pagina Completa, che influisce solo sulle pagine che un visitatore ha già visualizzato nella propria sessione. Disattivarla avrà un impatto minimo sulla velocità della pagina.

3. Lo screenshot qui sotto mostra esattamente quale disattivare:

Una volta disattivata la Cache della Pagina Completa, il popup di Clerk dovrebbe apparire. Se non lo fa, contatta il Supporto Clerk tramite l’icona della chat dal vivo nell’angolo in basso a destra, e possiamo aiutarti a trovare una soluzione per la tua configurazione specifica 😃

Gli slider della homepage mostrano sempre gli stessi prodotti #

Normalmente questo accade solo se i codici di incorporamento sono stati inseriti tramite le Pagine CMS di Magento nel backend, poiché la homepage è memorizzata nella cache:

Invece, i tuoi codici di incorporamento dovrebbero essere inseriti direttamente nei file della Homepage, tramite FTP:

Magento non memorizzerà nella cache i risultati quando inseriti in questo modo.

Clerk non mostra le immagini #

Quando la cache delle immagini di Magento viene svuotata, manualmente o automaticamente, tutti i percorsi delle immagini cambiano.

Questo significa che i percorsi delle immagini inviati a Clerk.io non funzionano più.

Questo può essere facilmente risolto facendo così:

  1. Accedi a my.clerk.io

  2. Fai clic sul Negozio dove mancano le immagini

  3. Vai su Data

  4. Fai clic su Inizia Nuova Sincronizzazione Dati nell’angolo in alto a destra

Questo avvierà una nuova sincronizzazione completa dei tuoi prodotti, che farà sì che Clerk.io ottenga i percorsi delle immagini corretti.

Nell’estensione Magento di Clerk.io v2.1.0 questo problema è risolto, avviando automaticamente una Sincronizzazione quando la cache delle immagini viene svuotata.

Se stai utilizzando una versione precedente dell’estensione, ti consigliamo vivamente di aggiornare all’ultima versione.

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, devi seguire questi passaggi per eseguire con successo l’aggiornamento.

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

Conversione dei Designs #

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

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

1.1 Inizia andando su my.clerk.io -> Recommendations / Search -> Designs e fai clic su Nuovo Design:

1.2. Scegli il tuo Tipo di Design.

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

1.4. Fai clic su Pubblica quando hai finito e vai a Passo 2 nella guida.

1.5. Infine, vai su Recommendations / Search -> Content e cambia il tuo Clerk.io Contenuto per utilizzare il tuo nuovo Design.

1.6. Fai clic su Aggiorna Contenuto. Questo causerà temporaneamente che non vengano visualizzati sul tuo webshop fino a quando non hai finito con 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.

Aggiornamento della tua estensione #

Se hai già l’ultima versione dell’estensione Clerk.io per Magento puoi saltare questo passaggio.

Puoi scaricare l’ultima estensione da questo link:

https://github.com/clerkio/clerk-magento/releases/latest

2.1. Salva eventuali modifiche ai file dell’estensione

Prima di tentare di aggiornare, assicurati di avere:

  • Salvato i file modificati localmente sul tuo FTP o

  • Fatto un backup di eventuali file modificati, che puoi trasferire alla nuova estensione.

Di solito, i file che la maggior parte degli sviluppatori modifica sono Product.php e Productbase.php, che controllano gli attributi dei prodotti.

Questi file si trovano qui:

app->code->community->Clerk->Clerk->Model->Catalog->Product.php

app->code->community->Clerk->Clerk->Model->Catalog->Productbase.php

Disattiva e disinstalla l’estensione esistente

Prima di tentare di aggiornare, è molto importante che tu faccia questo:

2.2.1. Disattiva la vecchia estensione nella pagina System->Configuration->Clerk->Settings di Magento. Imposta semplicemente Enable su No e fai clic su Salva Config.

2.2.2. Successivamente , disinstallala tramite Magento Connect o eliminando i file

da FTP se l’hai installata direttamente qui.

Altrimenti, la tua pagina di Configurazione potrebbe smettere di funzionare e nessuna delle estensioni funzionerà successivamente.

2.3. Installa l’ultima estensione

Infine, installa di nuovo l’ultima estensione e sposta eventuali file che hai salvato, sul tuo server FTP.

La tua configurazione dovrebbe essere salvata, anche quando installi la nuova versione. Controlla System->Configuration->Clerk per assicurarti che tutto sia ancora lì.

Ora hai installato l’ultima versione di Clerk.io per Magento 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

Gestione di require.js #

Questo si applica solo quando si utilizza v.3.7.2 o inferiore dell’estensione Magento 1 Clerk.

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

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

Uncaught ReferenceError: Clerk is not defined

Ci sono due modi per gestire Require.js. Entrambi gli approcci richiedono di apportare modifiche allo script di tracciamento in questo file:

app->design->frontend->base->default->template->clerk->tracking.phtml

Includere “clerk” in Require.js #

L’approccio migliore è cercare di far riconoscere Require.js a Clerk.io.

Puoi farlo inserendo require([‘clerk’], function() {}); in fondo allo script di tracciamento:

Ignorare Require.js #

Se la soluzione sopra non funziona, è possibile ignorare Require.js.

Puoi farlo inserendo window.__clerk_ignore_requirejs = true;

nella parte superiore dello script di tracciamento:

Dopo aver utilizzato uno di questi approcci, 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.