FAQ
Ændring af billedstørrelser #
Som standard bruger udvidelsen de originale billedstørrelser, der er indstillet i Magento 2, men disse kan ændres, hvis det er nødvendigt.
Start med at logge ind på din Magento 2 backend og gå til:
Stores -> Configuration ->Clerk ->Configuration
Under Synchronization-> Image type kan du vælge præcis, hvilken opløsning billederne skal sendes i:
![](/integrations/magento-2/faq/screenshot_935825995.png)
Klik derefter på Save Config.
Nu skal du blot køre en ny synkronisering i my.clerk.io og dine nye billedstørrelser vil blive importeret.
Brug af formaterere i designs #
Clerk.js giver dig mulighed for at skrive brugerdefinerede javascript-funktioner, der tilføjer ny funktionalitet til Designs.
Formaterere kan tilføjes på to måder:
- Gennem my.clerk.io > Settings > Formatters, hvor hver Formatter kan oprettes som separate poster.
- Som en konfiguration for Clerk.js, i tracking-scriptet der indsættes på alle sider, hvor flere formaterere kan tilføjes på én gang.
For Magento 2 indeholder denne fil tracking-scriptet:
vendor->view->frontend->templates->tracking.phtml
Et eksempel kan ses nedenfor. Vær opmærksom på, at dette er for Clerk V2 (seneste version):
Clerk('config', {
key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
formatters: {
log_price: function(price) {
console.log(price);
}
});
Du kan skrive et vilkårligt antal Formatters, adskilt af komma:
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;
}
}
Efter at have oprettet dine Formaterere kan du bruge dem i dine Designs ved hjælp af denne syntaks:
{% raw %} {{{ price | log_price }} {{ price | calculate_discount | special_price }}) {% endraw %}
Dette giver dig mulighed for at skabe enhver funktionalitet i dine Designs, som du har brug for.
Synkronisering med HTTP Auth #
Ofte bruges HTTP-godkendelse på staging-sider for at undgå uønskede besøgende.
Dette vil også blokere Clerk-importøren og vise en 401 Unauthorized fejl i synkroniseringsloggen.
Du kan nemt bekræfte importøren ved at indsætte godkendelsesoplysningerne i import-URL’en som nedenfor, i Data Sync på my.clerk.io:
http://USER:PASS@magento2.clerk.io/
![](/integrations/magento-2/faq/screenshot_993154726.png)
Almindelige synkroniseringsproblemer #
Bemærk: Vi anbefaler, at du altid opdaterer plugin’et til den nyeste version for at få alle opdaterede funktioner fra Clerk.
Når du importerer data med Clerk.io’s Magento 2-udvidelse, er webshop-serveren ansvarlig for at sende produkt-, kategori- og salgsdata til Clerk.io.
Men i nogle tilfælde kan serverens konfiguration forhindre importen i at få adgang, hvilket forårsager en fejl i Data Sync.
Nedenfor er en liste over de mest almindelige fejl og hvordan man løser dem.
401 Serverfejl: Uautoriseret #
Denne fejl opstår, hvis din webshop/dev-miljø kræver HTTP-godkendelse for at få adgang til det.
Dette løses enkelt ved at indsætte Brugernavn og Adgangskode som en del af Import-URL’en:
http://username:password@magento2.clerk.io
403 Serverfejl: Forbudt #
Denne fejl opstår ofte af en af disse grunde:
Din server blokerer importøren fra at få adgang til det. I de fleste tilfælde skal du blot whiteliste importørens IP-adresse for at give den adgang. Den nyeste IP-adresse kan findes her.
Du kan have en forkert offentlig nøgle, privat nøgle og/eller import-URL inden for butikken i my.clerk.io
Du bruger Storeviews med skjulte URL’er, som mywebshop.com?__store=b2b. Nogle gange kan disse URL’er også indeholde 3 understregninger som dette: mywebshop.com?___store=b2b
Hvis det sidste, skal du blot inkludere __store parameteren i URL’en i Data:
![](/integrations/magento-2/faq/screenshot_329240822.png)
Hvad hvis jeg allerede har whitelisted, men den samme fejl stadig opstår?
Der er et par tilfælde, hvor du har whitelisted importørens IP-adresse, og fejlen stadig vedvarer, så anbefaler vi at se nærmere på disse.
Den godkendelsesdel af kroppen kan være blevet fjernet fra anmodningen fra butikkens server.
Rate limit for serveren i forhold til cloudflares.
404 Serverfejl: Ikke fundet #
Denne fejl opstår, hvis importøren ikke kunne få adgang til linket, der sender os data fra webshoppen. I de fleste tilfælde sker det, fordi udvidelsen enten er:
Ikke installeret overhovedet
En cache forårsager, at linket ikke bliver initialiseret
Først skal du sikre dig, at du har installeret udvidelsen korrekt.
For det andet skal du sørge for at tømme din webshops cache, før du prøver en ny import.
429 Serverfejl: For mange anmodninger #
Denne fejl opstår, hvis din server nægter importøren adgang på grund af for mange indkommende anmodninger.
Du kan løse dette ved at sætte anmodningsgrænsen højere for din server eller ved at sætte Side Størrelse til en højere værdi i Clerk.io importøren, hvilket får importøren til at lave færre, større anmodninger:
![](/integrations/magento-2/faq/screenshot_2711061074.png)
Hvis du bruger hostudbyderen hypernode.com/nl, returnerer importøren normalt denne fejl på grund af deres rate limiter. I dette tilfælde skal du blot kontakte hypernode.com/nl og bede dem om at whiteliste importørens User-Agent " clerk".
500 Intern serverfejl #
Denne fejl betyder, at din server har stødt på en intern fejl og ikke kunne specificere, hvilken fejl der skete.
I disse tilfælde kan du tjekke din Server Log for at identificere, hvilken proces der gik ned, og hvorfor. I de fleste tilfælde skyldes det simpelthen et produkt med en ugyldig attribut eller en funktion, der kaldes forkert i webshoppen.
503 Serverfejl: Tjenesten er utilgængelig #
Denne fejl er normalt midlertidig og skyldes, at serveren er for travl til at håndtere anmodningen. Prøv igen lidt senere.
Hvis problemet fortsætter, kan det betyde, at serveren er overbelastet med processer og er tæt på maksimal kapacitet.
Tjek serverbelastningen for at identificere, om dette er tilfældet.
Ugyldigt svar modtaget #
Denne fejl opstår normalt, hvis din webshop bruger et omdirigeringssystem til at sende kunder til forskellige domæner.
For eksempel kan det at gå til " https://mywebshop.com" omdirigere til " https://mywebshop.com/it"
Hvis dette er tilfældet, skal du blot bruge den fulde URL, når du importerer i my.clerk.io:
![](/integrations/magento-2/faq/screenshot_2374307436.png)
Opgradering til Clerk.js 2 #
Clerk.js 2 er en hurtigere og meget mere fleksibel version af vores JavaScript-bibliotek, der gør installationen af Clerk.io på enhver webshop til en leg.
Men da de to versioner fungerer lidt forskelligt, skal du følge disse trin for at opgradere med succes.
De to hovedforskelle i Clerk.js 2 er, at Designs i my.clerk.io bruger Liquid skabelonsprog, men de kan også nemt oprettes ved hjælp af Design Editor.
Trin 1: Konvertering af Designs #
Da Clerk.js 2 har en anden tilgang til Designs, skal du oprette nye.
Du kan oprette dine Clerk.js 2 Designs på en af to måder:
1. Brug den intuitive Design Editor til at oprette nye Designs, som beskrevet i de følgende punkter.
2. Konverter dine gamle Designs. Følg denne guide for at se, hvordan du gør det.
1.1 Start med at gå til my.clerk.io -> Recommendations / Search -> Designs og klik på New Design:
![](/integrations/magento-2/faq/screenshot_1126116339.png)
1.2 På den følgende skærm skal du give dit Design et Navn (vi anbefaler at tilføje " V2", så det er tydeligt, at du bruger Clerk.js2).
1.3. Vælg Design Type.
![](/integrations/magento-2/faq/screenshot_27730150.png)
1.4. I Design Editor skal du klikke på et af de eksisterende elementer som navn, billede, knap osv. for at redigere det, eller tilføje nye elementer til Designet for at tilføje flere oplysninger om produkter.
![](/integrations/magento-2/faq/screenshot_1347899334.png)
1.5. Klik på Udgiv, når du er færdig, og gå til Trin 2 i guiden.
1.6. Til sidst skal du gå til Recommendations / Search -> Content og ændre dit Clerk.io Indhold til at bruge dit nye Design.
1.7. Klik på Opdater Indhold. Dette vil midlertidigt få dem til ikke at vises på din webshop, indtil du er færdig med Trin 2. Vælg det nye Design for alt Indhold, der skal opdateres.
![](/integrations/magento-2/faq/screenshot_3946841264.png)
1.9. Der! Du er nu klar til at skifte over til Clerk.js 2.
Trin 2: Opgradering af din udvidelse #
ADVARSEL: Husk at tage sikkerhedskopier af eventuelle ændrede filer, da de vil blive overskrevet.
Opgradering af Magento 2-udvidelsen sker via commandline.
Det gøres ved at følge disse trin:
2.1. Log ind på din server via commandline.
2.2. Naviger til din webroot-mappe (normalt " /var/www/your_domain/public_html")
2.3. Aktiver Root Access ved at skrive su og derefter indtaste din adgangskode.
2.4. Skriv følgende kommandoer i rækkefølge:composer update clerk/magento2php bin/magento setup:upgradephp bin/magento setup:di:compile
2.5. Vent på, at udvidelsen er færdig.
Din Magento 2 er nu opgraderet til den nyeste version.
Nu har du den nyeste version af Clerk.io til Magento 2 installeret, og Clerk.js 2 kører på din webshop!
Den fulde dokumentation for Clerk.js 2 kan findes her:
https://docs.clerk.io/docs/clerkjs-quick-start
Håndtering af require.js #
Denne guide gælder kun, når du bruger op til v.2.8.3 af Magento 2 Clerk-udvidelsen.
I nogle opsætninger stopper Require.js Clerk.js fra at indlæse, hvilket betyder, at ingen skyder eller søgeresultater vises.
Når dette sker, vises følgende fejl i din konsol:
Uncaught ReferenceError: Clerk is not defined
Magento 2-udvidelsen håndterer allerede Require.js, men i nogle tilfælde er det nødvendigt at få den til at ignorere Clerk.js.
Du kan gøre dette i følgende fil:
vendor->clerk->magento2->templates->tracking.phtml
Indsæt simpelthen window.__clerk_ignore_requirejs = true;
øverst i tracking-scriptet:
![](/integrations/magento-2/faq/screenshot_3471197186.png)
Efter at have brugt denne tilgang vil Require.js nu være kompatibel med Clerk.io.
Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.