FAQ
Installazione manuale degli elementi #
WooCommerce è costruito attorno ai temi, il che spesso significa che il plugin Clerk.io non può inserire i nostri codici di incorporamento, perché i hook non sono posizionati dove dovrebbero.
Questa guida spiega come inserire manualmente i codici se questo è il caso.
1. Trova il file giusto #
1. Inizia localizzando il tuo modulo di ricerca. Puoi farlo controllando il tuo codice sorgente e trovando un testo unico per il campo.
2. Dopo aver identificato questo, hai bisogno di un buon modo per cercare tra i tuoi file per trovarlo. Ti consigliamo di utilizzare Sublime Text.
3. Apri i file FTP del tuo webshop e localizza public_html -> wp-content -> themes
4. Trascina i temi sul tuo desktop, per copiarli sul tuo computer. Questo ti permetterà di cercare nei file:
5. In Sublime vai su Project -> Add Folder to Project
6. Scegli la cartella themes che hai salvato sul tuo computer.
7. Ora puoi cercare nei file, andando su Find -> Find in Files. Puoi anche scegliere di cercare solo nei file .php, che è normalmente il tipo di file utilizzato per i file dei temi in WooCommerce:
2. Far funzionare il link alla pagina di ricerca #
Se hai già seguito la guida per impostare la ricerca e hai creato una pagina in WooCommerce per i Risultati di Ricerca, ma il tuo campo di ricerca non si collega correttamente, ecco cosa devi fare.
1. Inizia guardando il webshop nel tuo browser. Ti consigliamo di utilizzare Chrome.
2. Localizza qualsiasi HTML che sembra essere unico per il campo di ricerca. Ad esempio, searchform:
3. Cerca questo in Sublime, per trovare un elenco di file in cui si trova:
4. Trova il file corrispondente su FTP.
5. Ora puoi cambiare le impostazioni necessarie per far sì che Clerk.io si colleghi alla pagina corretta. Le 3 cose che devi cambiare sono:
L’URL a cui il cliente è collegato, spesso trovato nell’elemento
L’attributo “name” del campo di input, che deve essere searchterm
Il campo di input nascosto con name=“post_type” deve essere commentato.
6. Un modulo di ricerca potrebbe apparire così prima di cambiarlo:
7. E dovrebbe apparire così dopo la modifica:
8. Ora dovresti essere collegato alla pagina di ricerca quando cerchi: www.mywebshop.com/soegeresultater?searchterm=test
Utilizzo di formattatori nei design #
Clerk.js ti consente di scrivere funzioni javascript personalizzate, che aggiungono nuove funzionalità ai Designs.
I formattatori possono essere aggiunti in due modi:
- Attraverso my.clerk.io > Settings > Formatters, dove ogni Formatter 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 WooCommerce, questo file contiene lo script di tracciamento:
wp-content->plugins->clerkio->includes->class-clerk-visitor-tracking.php
Un esempio può essere visto qui sotto. Si prega di notare che questa è Clerk V2 (ultima versione):
Clerk('config', {
key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
formatters: {
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 Formattatori, puoi usarli nei tuoi Designs utilizzando questa sintassi:
{%raw%}{{ price | log_price }} {{ price | calculate_discount | special_price }}{%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 non invitati.
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:
https//USER:PASS@www.ewoksRus.com
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 il plugin WooCommerce di Clerk.io, il server del webshop è responsabile dell’invio dei dati sui prodotti, categorie e vendite a Clerk.io.
Tuttavia, in alcuni casi, la configurazione del server potrebbe impedire all’importazione di ottenere accesso, causando un errore in Data Sync.
Di seguito è riportato un elenco degli errori più comuni e come risolverli.
401 Errore del 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@woocommerce.clerk.io
403 Errore del Server: Vietato #
Questo errore si verifica se 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.
Controlla anche che la tua chiave pubblica, chiave privata e URL di importazione siano corretti per il negozio in cui operi su my.clerk.io
Cosa fare se ho già whitelistato ma si verifica ancora lo stesso errore?
Ci sono alcuni casi in cui hai whitelistato l’indirizzo IP dell’importatore e l’errore persiste ancora, quindi ti consigliamo di esaminare queste parti:
La parte di autenticazione del corpo potrebbe essere rimossa dalla richiesta dal server del negozio.
Limite di frequenza per il server riguardo a cloudflares.
404 Errore del 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é il plugin è:
Non installato affatto
Disattivato a causa di un aggiornamento
Una cache causa il link di non essere inizializzato
I permalink di WooCommerce sono impostati su Nome post invece di Mese e nome
Prima assicurati di aver installato correttamente il plugin e che sia attivato.
Se hai recentemente aggiornato automaticamente il plugin, WooCommerce a volte disattiva il plugin. Se questo è successo, vai semplicemente su Plugins > Clerk e fai clic su Attiva per riattivarlo.
In secondo luogo, assicurati di svuotare la cache del tuo webshop prima di provare un nuovo import.
Se ancora non si sincronizza correttamente, vai su Impostazioni => Permalinks e cambia le Impostazioni comuni in Mese e nome e premi Salva:
429 Errore del 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 richieste più alto, per il tuo server o impostando la Dimensione Pagina a un valore più alto nell’ importatore Clerk.io, causando all’importatore di effettuare meno richieste, ma 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 whitelistare l’User-Agent dell’importatore " clerk".
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 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 una funzione chiamata in modo errato nel webshop.
Un esempio di un tale errore potrebbe verificarsi una volta che aggiorni sia WooCommerce che Klarna. In questo caso, il problema è creato dal plugin ‘woocommerce-gateway-klarna’ che non si aggiorna.
Se questo ti succede, vai su woocommerce-gateway-klarna ->includes->variables-checkout.php .
Cerca:
if ( ! is_admin() && ! empty( $klarna_country )) {
e cambialo in:
if ( ! is_admin() && ! empty( $klarna_country ) && WC()->session ) {
503 Errore del 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 si avvicina alla capacità massima.
Controlla il carico del server per identificare se questo è il caso.
520 Il Server Web ha Restituito un Errore Sconosciuto #
Di solito questo errore viene restituito da CloudFlare e spesso si verifica a causa di un collo di bottiglia in WooCommerce che causa problemi con dimensioni di pagina più elevate. Per risolverlo, imposta semplicemente la tua Dimensione Pagina a 50 e avvia una nuova sincronizzazione:
522 Errore del Server: Timeout di Connessione #
Questo errore si verifica di solito se il server è troppo occupato per rispondere, o se il nostro importatore non è autorizzato ad accedere al server.
Prima, aspetta qualche minuto e riprova a sincronizzare, per vedere se il server era occupato.
Se ancora non funziona, assicurati di whitelistare l’IP dell’importatore nella configurazione del tuo server. L’ultimo indirizzo IP può essere trovato qui.
Risposta non valida restituita dall’API di WooCommerce #
Questo errore si verifica di solito se il Debugging di WooCommerce è stato attivato. Non è mai una buona idea avere attivato su un’installazione live perché rallenta le pagine e potenzialmente mostra messaggi di errore nel frontend.
Il problema di sincronizzazione si verifica se WooCommerce incontra un errore durante la generazione dei dati del prodotto per l’importazione.
Questo può essere risolto disattivando il Debugging in wp-config.php impostando define(WP_DEBUG’, false).
Questa guida spiega tutto in modo più dettagliato:
https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/
E questa guida spiega una soluzione alternativa:
https://aristath.github.io/blog/wp-hide-php-errors
Gli errori verranno comunque registrati anche quando non in modalità di debug, ma verranno registrati in un file invece.
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 aggiornare con successo.
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.
Passo 1: 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. Usa l’intuitivo Editor di Design per creare nuovi Designs, come descritto nei punti seguenti.
2. Converti i tuoi vecchi Designs. Segui questa guida per vedere come farlo.
1.1 Inizia andando su my.clerk.io -> Raccomandazioni / Ricerca -> Designs e fai clic su Nuovo Design:
1.2. Scegli il Tipo di Design e segui la procedura guidata per l’impostazione del design.
1.3. Nell’Editor di Design, clicca 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.4. Fai clic su Pubblica quando hai finito e vai al Passo 2 nella guida.
1.5. Infine, vai su Raccomandazioni / Ricerca -> Contenuto e cambia il tuo contenuto Clerk.io 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 il Passo 2. Scegli il nuovo Design per tutto il Contenuto che deve essere aggiornato.
1.7. Fatto! Ora sei pronto per passare a Clerk.js 2.
Passo 2: Aggiornamento del tuo plugin #
ATTENZIONE: Ricorda di fare il backup di tutti i file modificati, poiché verranno sovrascritti.
L’aggiornamento del Plugin può essere fatto direttamente dall’admin di WooCommerce.
Inizia andando su Plugin->Aggiungi Nuovo
Poi, cerca Clerk nel campo di ricerca a destra e fai clic su Aggiorna Ora.
Ecco fatto! Ora stai eseguendo l’ultima versione di Clerk.io per WooCommerce e Clerk.js 2 è in esecuzione sul tuo webshop!
Se hai già l’ultima versione, questo pulsante dirà semplicemente Attivo.
La documentazione completa per Clerk.js 2 può essere trovata qui:
https://docs.clerk.io/docs/clerkjs-quick-start
Link che puntano al backend #
Di tanto in tanto, i plugin di Wordpress / Woocommerce rovinano la regola di riscrittura di Wordpress.
La regola di riscrittura è l’insieme di configurazioni che assicura che link come questo
domain.com/?p=123
diventino link belli e ottimizzati per SEO come
domain.com/product/my-beautiful-product/
e siano effettivamente raggiungibili da te e dai tuoi clienti.
Se i tuoi link non funzionano correttamente, fai così:
1. Accedi al tuo backend di Wordpress
2. Poi vai su: Dashboard –> Impostazioni –> Permalink
3. Scorri verso il basso e fai clic sul pulsante “Salva modifiche” in fondo alla pagina senza cambiare nulla. Questo sovrascriverà la regola di riscrittura di Wordpress.
4. Una volta che la pagina è stata aggiornata, svuota la cache di Wordpress (se presente) e poi aspetta qualche minuto. Dovresti essere in grado di vedere di nuovo tutte le pagine del tuo sito web.
Se dopo tutto ciò non riesci ancora a visitare le pagine del tuo sito web, contattaci all’indirizzo support@clerk.io, siamo qui per aiutarti!
Avvisi mostrati nel backend e nel frontend #
Questo errore si verifica di solito se il Debugging di WooCommerce è stato attivato. Non è mai una buona idea avere attivato su un’installazione live perché rallenta le pagine e potenzialmente mostra messaggi di errore nel frontend.
Il problema di sincronizzazione si verifica se WooCommerce incontra un errore durante la generazione dei dati del prodotto per l’importazione.
Questo può essere risolto disattivando la modalità di debug sia tramite il plugin che direttamente nei file di WooCommerce.
Gestione di require.js #
Questa guida si applica solo quando si utilizza fino alla v.1.7.1 dell’estensione WooCommerce 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:
wp-content -> plugins -> clerkio -> includes -> class-clerk-visitor-tracking.php
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:
Utilizzando il Plugin
Se stai utilizzando Clerk.io’s v2.2.4 o versioni successive, il Debugging può essere disabilitato direttamente dalla pagina del Plugin nel tuo backend di WooCommerce.
Vai su Clerk -> Impostazioni Clerk -> Guida al Debug e fai clic su Disabilita la modalità di debug:
O direttamente nei file
La modalità di debug può anche essere disattivata tramite FTP, in wp-config.php impostando define(WP_DEBUG’, false).
Questa guida spiega tutto in modo più dettagliato:
https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/
E questa guida spiega una soluzione alternativa:
https://aristath.github.io/blog/wp-hide-php-errors
Gli errori verranno comunque registrati anche quando non in modalità di debug, ma verranno registrati in un file invece.
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.
Multi-lingua #
Quando utilizzi WPML in WooCommerce, dovresti essere in grado di differenziare le tue lingue tramite URL, in questo modo:
Se hai URL unici come questo, puoi estendere il plugin WooCommerce per supportare WPML.
Va anche bene definire la lingua tramite il parametro lang. Es.
Copia Negozio #
Il modo più semplice per implementare Clerk.io in più domini in configurazioni standard è creando un Negozio separato per ogni dominio in my.clerk.io. In questo modo, puoi separare prodotti, vendite, valute, ecc. per tenere traccia di ogni dominio.
Dopo aver completato la configurazione iniziale, fai clic sull’angolo in alto a sinistra del menu laterale e poi fai clic su "+ Aggiungi nuovo negozio" l’ultima opzione dell’elenco a discesa (generalmente sotto gli store esistenti e il nome della tua azienda).
Nella pagina Aggiungi Nuovo Negozio, compila i dettagli del tuo webshop e scegli il tuo Negozio principale dal menu a discesa Copia Contenuto da Negozio Esistente, quindi fai clic su Aggiungi Negozio:
Questo porterà il Contenuto e i Designs dal tuo Negozio principale. Ricorda di tradurre i Titoli nella lingua corretta.
Installa e Configura #
Il supporto ufficiale per WPML è stato aggiunto all’estensione Clerk.io WooCommerce, il che significa che finché utilizzi quella versione o una più recente, WPML dovrebbe essere supportato.
Nel pannello delle impostazioni per WooCommerce vedrai le impostazioni come al solito. Se WPML è attivo e configurato sul tuo sito WordPress, vedrai Ambito Multi Lingua con la lingua corrente nella parte superiore della pagina delle impostazioni.
Per cambiare lingua, utilizza semplicemente il selettore nel pannello superiore. Dovresti selezionare la lingua per cui desideri configurare Clerk e fornire le impostazioni desiderate. Ripeti questo per ogni lingua.
Nota che selezionare Tutte le Lingue da questo menu a discesa non è consigliato, quando salvi la tua configurazione, poiché salverà solo le tue impostazioni come fallback.
Sincronizza i tuoi domini #
Una volta che hai esteso il plugin, puoi ora sincronizzare ciascuno dei tuoi Negozio con il loro dominio linguistico.
Poiché hai già installato l’estensione, puoi saltare il primo passaggio e iniziare a configurarlo e sincronizzare i dati.
Quando la Sincronizzazione è terminata, il tuo dominio è pronto e utilizza la stessa configurazione del tuo Negozio principale.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.