FAQ

Usa questi controlli quando la configurazione standard di ideal.shop importa dati incompleti o si comporta diversamente rispetto allo storefront nativo.

Feed Incompleti #

Controlla la risposta effettiva del feed prima di considerare una sincronizzazione Clerk.io completata. Per impostazione predefinita, ogni tipo di dato è limitato a 50 record.

Imposta products e categories abbastanza alti per l’intero catalogo e orders abbastanza alto per l’import storico desiderato. Controlla la presenza di parametri duplicati o di un secondo ?, quindi confronta origine, feed e conteggi importati.

Un conteggio esattamente uguale al limite suggerisce un troncamento. Se il feed contiene il record mancante ma Clerk.io no, esamina i log di sincronizzazione e la configurazione dei dati. Se è assente dal feed, indaga le regole di esportazione o visibilità della piattaforma.

Per un’esportazione di grandi dimensioni che va in timeout, riduci il numero di ordini storici richiesti per stabilire una baseline riuscita, quindi concorda un metodo di esportazione completo con ideal.shop. Una risposta più piccola e riuscita non indica una cronologia completa.

Fodmagasinet ha riportato un HTTP 524 durante la richiesta di 100.000 ordini. Questo è un esempio di timeout di esportazione, non un massimo universale raccomandato.

Non assumere che l’endpoint supporti paginazione, offset, cursori o filtri per data. Chiedi allo sviluppatore della piattaforma quali opzioni sono supportate e come rilevare la fine dell’esportazione. Verifica che l’importatore di Clerk.io possa consumare quel metodo prima di utilizzarlo.

Vedi importazioni in corso per ripristinare la finestra ordini predefinita senza disabilitare le importazioni. Dopo un’interruzione, aumenta temporaneamente la copertura degli ordini e controlla la presenza di lacune.

Categorie Nascoste #

Confronta le categorie nascoste o non pubblicate con i loro record importati e con gli ID categoria referenziati dai prodotti.

Correggi le regole di visibilità nell’esportazione o nella mappatura d’import, e sincronizza di nuovo. Verifica sia i record di categoria che i riferimenti dei prodotti successivamente. Nascondere una categoria in un Search Design non corregge i dati importati incoerenti.

Prezzi Errati #

Confronta un prodotto semplice, uno scontato e uno variante con il webshop nativo, inclusi tasse e valuta.

Se un parent viene importato con price: 0 mentre le varianti hanno prezzi diversi da zero, correggi la sorgente o la mappatura d’importazione. Un’etichetta Da con il prezzo minimo della variante importata può migliorare la card, ma l’ordinamento userà comunque il prezzo importato configurato per quell’ordinamento.

Usa un solo campo di prezzo verificato per il calcolo dello sconto e i prezzi barrati. Non presumere che esista list_price o retail_price solo perché un template generico lo usa.

Immagini Sgranate #

Controlla le dimensioni dell’immagine caricata rispetto alla dimensione effettiva della card renderizzata e alla densità dello schermo. Un box CSS grande non può aggiungere dettaglio a un’immagine sorgente piccola.

Fodmagasinet ha modificato l’URL dell’immagine per richiedere una dimensione maggiore, con un segmento /450-0/ e immagini da 450 pixel verificate durante la configurazione. Questo era specifico per il suo servizio immagine; non è una trasformazione da applicare a ogni URL immagine di ideal.shop.

Prima di modificare gli URL, verifica le dimensioni supportate dal servizio immagini e il comportamento di caricamento, proporzioni e immagine restituita. Preferisci un campo sorgente immagini corretto o un’opzione supportata dal servizio rispetto a una sostituzione di stringa non verificata.

Acquisto di Varianti #

Usa il flusso nativo per i prodotti semplici e apri la pagina prodotto quando non sono state selezionate opzioni obbligatorie.

L’adapter personalizzato di Fodmagasinet inviava un parent ID tramite le funzioni native di acquisto e reindirizzava solo in caso di rifiuto su varianti attive specifiche. Quel adapter dipende dal messaggio di risposta della piattaforma e può smettere di funzionare se cambia.

Non installarlo come soluzione universale per le varianti. Riutilizza metadata di varianti verificati o un flusso nativo di selezione supportato, oppure mantieni un link alla pagina prodotto. Altri errori devono mantenere la gestione nativa.

Conflitti di Ricerca #

Se compaiono due pannelli risultati, ispeziona sia il menu a discesa nativo che il pannello di ricerca mobile. Controlla i relativi handler di apertura/chiusura e la visibilità calcolata quando Clerk.io Search è aperto.

Limita qualsiasi soppressione al componente di Search rilevante o allo stato di apertura. Ritesta digitazione, frecce, Invio su entrambi keydown e keyup, invio del form, Esc, accesso al carrello e riapertura di Search.

Se Close o Esc cambia inaspettatamente pagina o URL, controlla la gestione della cronologia del pannello nativo. Chiudere un overlay non deve dipendere da un ritorno indietro a una voce di cronologia presunta.

Errori di Navigazione #

Quando i risultati scompaiono dopo la navigazione, confronta un caricamento pagina fresco con una transizione tramite link nativo e Avanti/Indietro.

Controlla Settings > Features > SPA Auto Detect Changes, gli ID delle pagine correnti, se il target di iniezione esiste ancora e se l’Element effettua una nuova richiesta quando il suo contesto cambia.

Se un prodotto manca dei tab descrittivi, correggi il target di posizionamento o aggiungi una fallback verificata. Se il target esiste ma l’Element resta assente o non aggiornato, raccogli gli URL coinvolti, i passaggi di navigazione, gli errori console e le richieste per indagine.

Fodmagasinet ha usato uno script temporaneo di pulizia per istanze separate durante l’indagine in Preview. Dipende dagli internals di Clerk.io e non deve diventare il metodo di installazione predefinito. Documenta separatamente ogni workaround simile con il suo scope e piano di rimozione, poi ritesta dopo la correzione supportata.

Elementi Duplicati #

Controlla che lo stesso Element non sia installato tramite blocchi nativi ideal.shop, iniezione e codice manuale contemporaneamente.

Mantieni un’unica installazione per posizionamento. Ispeziona il DOM e il pannello Network dopo navigazioni ripetute; distingui richieste legittime da Element separati rispetto a richieste ripetute per un singolo posizionamento.

Se sono visibili anche i display nativi di recommendation, disattiva la loro visualizzazione senza cancellare le relazioni manuali tra prodotti. Controlla che la sostituzione Clerk.io funzioni prima di rimuovere il display nativo.