FAQ

Brug disse tjek, når den standard ideal.shop opsætning importerer ufuldstændige data eller opfører sig anderledes end det oprindelige webshop-front.

Ufuldstændige feeds #

Tjek det faktiske feed-svar, før du betragter en vellykket Clerk.io-synkronisering som fuldført. Som standard er hver datatype begrænset til 50 poster.

Sæt products og categories højt nok til hele kataloget og orders højt nok til den tiltænkte historiske import. Kontrollér for duplikerede parametre eller et andet ?, og sammenlign derefter kilde, feed og importerede antal.

Et antal præcist lig med en grænse antyder afkortning. Hvis feedet indeholder den manglende post, men Clerk.io ikke gør, inspicer sync-logger og datakonfiguration. Hvis den mangler i feedet, undersøg platformens eksport eller synlighedsregler.

For en stor eksport, der tidsudløber, reducer det ønskede antal historiske ordrer for at opnå et succesfuldt udgangspunkt, og aftal derefter en fuldstændig eksport-metode med ideal.shop. Et mindre succesfuldt svar er ikke et bevis for fuldstændig historik.

Fodmagasinet rapporterede en HTTP 524, da der blev anmodet om 100.000 ordrer. Dette er et eksempel på en eksport-tidsudløb og ikke et anbefalet universelt maksimum.

Antag ikke, at endpointet understøtter pagination, offsets, cursors eller datofiltering. Spørg platform-udvikleren, hvilke muligheder der understøttes, og hvordan man opdager slutningen på eksporten. Verificér, at Clerk.io’s importer kan håndtere denne metode, før du bruger den.

Se løbende imports for at gendanne standard ordre-vinduet uden at deaktivere importer. Efter et udfald, øg midlertidigt ordre-dækning og tjek for huller.

Skjulte kategorier #

Sammenlign skjulte eller upublicerede kategorier med deres importerede poster og de kategori-ID’er, der refereres af produkter.

Korrigér synligheds-regler i eksport eller import mapping og synkronisér igen. Verificér både kategori-poster og produkt-referencer bagefter. At skjule en kategori i et Search Design reparerer ikke inkonsekvente importerede data.

Forkerte priser #

Sammenlign et simpelt produkt, et nedsat produkt og et variant-produkt med den oprindelige webshop, inklusiv moms og valuta.

Hvis en parent importerer med price: 0, mens varianter har betalte priser, ret kilden eller import mapping. Et Fra-label, som viser den mindste importerede variantpris, kan forbedre kortet, men sortering bruger stadig den importerede pris, der er konfigureret til sorteringen.

Brug et enkelt verificeret normalpris-felt til rabatberegninger og gennemstregede priser. Antag ikke, at list_price eller retail_price findes blot fordi en generisk skabelon bruger det.

Utydelige billeder #

Undersøg billedets indlæste dimensioner i forhold til dens faktisk viste kortstørrelse og skærmtæthed. En stor CSS-boks kan ikke tilføje detaljer til et lille kildebillede.

Fodmagasinet ændrede sin billed-URL for at anmode om et større billede, med et /450-0/ størrelses-segment og 450-pixel indlæste billeder verificeret under opsætning. Dette var specifikt for deres billedservice; det er ikke en transformation, der skal bruges på alle ideal.shop billed-URL’er.

Inden du ændrer URL’er, verificér hvilke størrelser billedservicen understøtter, og hvordan billedet, billedformatforhold og indlæsning opfører sig. Foretræk et korrekt kildebillede-felt eller understøttet billedservice-mulighed frem for en ikke-verificeret strengudskiftning.

Variantkøb #

Brug den oprindelige flow for simple produkter og åbn produktsiden, når påkrævede valgmuligheder ikke er valgt.

Fodmagasinets tilpassede adapter indsendte et parent-ID gennem de oprindelige købsfunktioner og omdirigerede kun ved specifik afvisning af aktive varianter. Den adapter er afhængig af platformens svarbesked og kan gå i stykker, hvis det ændres.

Installer det ikke som en universel variant-løsning. Genbrug verificeret variant-metadata eller en understøttet oprindelig valgmuligheds-flow, eller behold et produkt-side link. Andre fejl skal beholde deres oprindelige håndtering.

Search-konflikter #

Hvis to resultatpaneler vises, inspicér både det oprindelige dropdown og mobilt Search-panel. Kontrollér deres åbne/lukke-handlere og beregnede synlighed, mens Clerk.io Search er åben.

Afgræns enhver undertrykkelse til den relevante Search-komponent eller åben-tilstand. Retest indtastning, piletaster, Enter på både keydown og keyup, formular-indsendelse, Escape, kurv-adgang og genåbning af Search.

Hvis Close eller Escape ændrer siden eller URL uventet, undersøg den oprindelige panels historikhåndtering. Lukning af et overlay må ikke afhænge af Back-navigation til en antaget historik-post.

Navigationsfejl #

Når resultater forsvinder efter navigation, sammenlign en frisk sideindlæsning med en oprindelig link-transition og Tilbage/Frem.

Tjek Settings > Features > SPA Auto Detect Changes, nuværende side-ID’er, om injectionsmålet stadig eksisterer, og om Elementet laver en ny forespørgsel, når dets kontekst ændres.

Hvis et produkt mangler beskrivelsesfaner, ret placeringens mål eller tilføj en verificeret fallback. Hvis målet eksisterer, men Elementet stadig mangler eller er forældet, saml de berørte URL’er, navigations-trin, konsolfejl og forespørgselsbeviser til undersøgelse.

Fodmagasinet brugte et midlertidigt cleanup-script til afkoblede instanser under Preview-undersøgelse. Det afhænger af Clerk.io internals og må ikke blive standardinstallationsmetoden. Hold sådanne workarounds dokumenteret særskilt med omfang og fjernelsesplan og retest efter den understøttede rettelse.

Dobbelt-elementer #

Tjek for samme Element installeret via oprindelige ideal.shop-blokke, injection og manuelt indlejret kode på samme tid.

Behold én tiltænkt installation pr. placering. Inspicér DOM og Netværk-panel efter gentagen navigation; adskil legitime forespørgsler fra separate Elementer fra gentagne forespørgsler for én placering.

Hvis oprindelige recommendations-visninger også er synlige, deaktiver deres visning uden at slette manuelle produktrelationer. Kontroller, at Clerk.io-erstatningen fungerer, før den oprindelige visning fjernes.