Woocommerce

Faq

Manuel installation af elementer #

WooCommerce er bygget op omkring temaer, hvilket ofte betyder, at Clerk.io plugin ikke kan indsætte vores indlejringskoder, fordi kroge ikke er placeret, hvor de skal.

Denne vejledning forklarer, hvordan man manuelt indsætter koder, hvis det er tilfældet.

1. Find den rigtige fil #

1. Start med at finde din søgeformular. Det kan du gøre ved at tjekke din kildekode og finde en unik tekst til feltet.

2. Når du har identificeret dette, skal du bruge en god måde at søge gennem dine filer for at finde det. Vi anbefaler at bruge Sublime tekst.

3. Åbn din webshops FTP-filer, og find public_html -> wp-indhold -> temaer

4. Træk temaerne til dit skrivebord for at kopiere dem til din computer. Dette giver dig mulighed for at søge i filerne:

5. På Sublime skal du gå til Project -> Tilføj mappe til projekt

6. Vælg mappen temaer, som du har gemt på din computer.

7. Nu kan du søge i filerne ved at gå til Find -> Find i filer.. Du kan endda vælge kun at søge i .php -filer, som normalt er den filtype, der bruges til temafiler i WooCommerce:

2. Sådan får du linket til søgesiden til at virke #

Hvis du allerede har fulgt guiden til opsætning af søgning og har oprettet en side i WooCommerce til søgeresultaterne, men dit søgefelt ikke linker korrekt, skal du gøre følgende.

1. Start med at kigge på webshoppen i din browser. Vi anbefaler at bruge Chrome.

2. Find enhver HTML, der ser ud til at være unik for søgefeltet. For eksempel searchform:

3. Søg efter dette i Sublime for at finde en liste over de filer, det er i:

4. Find den matchende fil på FTP.

5. Nu kan du ændre de nødvendige indstillinger for at få Clerk.io til at linke til den rigtige side. De 3 ting, du skal ændre, er

Den URL, som kunden er linket til, og som ofte findes i
-elementet, skal ændres, så den matcher navnet på den side, du har oprettet i WooCommerce. Dette vil ofte være “soegeresultater” eller “search-results”.
Attributten “name” i input-feltet, som skal være searchterm
Det skjulte input-felt med name=“post_type” skal kommenteres ud.

6. En søgeformular kunne se sådan ud, før den blev ændret:

7. Og bør se sådan ud efter ændringen:

8. Nu bør du blive linket til søgesiden, når du søger: www.mywebshop.com/soegeresultater?searchterm=test

Brug af formattere i design #

Clerk.js giver dig mulighed for at skrive brugerdefinerede javascript-funktioner, der tilføjer ny funktionalitet til Design.

Formatters kan tilføjes på to måder:

Gennem my.clerk.io > Indstillinger > Formatering,, hvor hver formatter kan oprettes som separate poster.
Som en PLACEHOLDER_11 til Clerk.js, i tracking-script, der indsættes på alle sider, hvor flere formattere kan tilføjes på én gang.

For WooCommerce indeholder denne fil tracking-scriptet:

wp-content->plugins->clerkio->includes->class-clerk-visitor-tracking.php

Et eksempel kan ses nedenfor. Vær opmærksom på, at dette er Clerkio 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;
   }
}

Når du har oprettet dine Formatters, kan du bruge dem i din Design ved hjælp af denne syntaks:

{%raw%}{{ price | log_price }} {{ price | calculate_discount |  special_price }}{%endraw%}

Det giver dig mulighed for at skabe alle de funktioner i dine designs, som du har brug for.

Synkronisering med HTTP Auth #

Ofte bruges HTTP-godkendelse på staging-sider for at undgå ubudne besøgende.

Dette vil også blokere Clerk importøren og vise en 401 Uautoriseret fejl i synkroniseringsloggen.

Du kan nemt verificere importøren ved at indsætte godkendelsesoplysningerne i import-URL’en som nedenfor, i Data Sync på my.clerk.io:

https//USER:PASS@www.ewoksRus.com

Almindelige synkroniseringsproblemer #

> Bemærk: Vi anbefaler, at du altid opdaterer plugin’et til den nyeste version for at få alle de opdaterede funktioner fra Ekspedient.

Når du importerer data med Clerk.io’s WooCommerce-plugin, er webshoppens server ansvarlig for at sende produktkategori- 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 Datasynkronisering.

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 den.

Dette løses ganske enkelt ved at indsætte Brugernavn og Adgangskode som en del af import-URL’en:

http://username:password@woocommerce.clerk.io

403 Serverfejl: Forbudt #

Denne fejl opstår, hvis din server blokerer for importørens adgang til den. I de fleste tilfælde skal du blot hvidliste importørens IP-adresse for at give den adgang.

Den seneste IP-adresse kan findes her.

Tjek også, at dine offentlig nøgle, privat nøgle og importere url er korrekte for den butik, du driver i min.clerk.io

Hvad hvis jeg allerede har hvidlistet, men den samme fejl stadig opstår?

Der er nogle få tilfælde, hvor du har hvidlistet importørens IP-adresse, og fejlen stadig fortsætter, så anbefaler vi, at du undersøger disse dele:

Godkendelsesdelen af brødteksten kan være fjernet fra anmodningen fra butikkens server.
Hastighedsgrænse for serveren i forhold til cloudflares.

404 Serverfejl: Ikke fundet #

Denne fejl opstår, hvis importøren ikke kunne få adgang til det link, der sender os data fra webshoppen. I de fleste tilfælde sker det, fordi pluginet enten er:

slet ikke er installeret
Deaktiveret på grund af en opdatering
En cache gør, at linket ikke bliver initialiseret
WooCommerce-permalinks er indstillet til Navn på indlæg i stedet for Måned og navn.

Sørg først for, at du har installeret plugin’et korrekt, og at det er aktiveret.

Hvis du for nylig har opdateret plugin’et automatisk, deaktiverer WooCommerce Nogle gange plugin’et. Hvis dette er sket, skal du blot gå til Plugins > Ekspedient og klikke på Aktiver for at få det tilbage igen.

For det andet skal du sørge for at tømme din webshops cache, før du prøver en ny import.

Hvis den stadig ikke synkroniserer korrekt, skal du gå til Indstillinger => Permalinks og ændre Almindelige indstillinger til Måned og navn. og trykke på Gem:

429 Serverfejl: For mange forespørgsler #

Denne fejl opstår, hvis din server nægter importøren adgang på grund af for mange indgående anmodninger.

Du kan løse dette ved at sætte Anmodningsgrænse højere for din server eller ved at sætte Sidestørrelse til en højere værdi i Clerk.io Importør , hvilket får importøren til at lave færre, større anmodninger:

Hvis du bruger værtsudbyderen Byte.nl, returnerer importøren normalt denne fejl på grund af deres hastighedsbegrænser. I dette tilfælde skal du blot kontakte Byte.nl og bede dem om at hvidliste importørens User-Agent " ekspedient".

500 Intern serverfejl #

Denne fejl betyder, at din Server stødte på en intern fejl og ikke var i stand til at specificere, hvilken fejl der skete.

I disse tilfælde kan du tjekke din Serverlog for at identificere, hvilken proces der gik ned, og hvorfor. I de fleste tilfælde er det simpelthen på grund af et produkt med en ugyldig attribut eller en funktion, der kaldes forkert i webshoppen.

Et eksempel på en sådan fejl kan opstå, når du opgraderer både WooCommerce og Klarna. I dette tilfælde er problemet skabt af plugin’et ‘woocommerce-gateway-klarna’, som ikke opgraderes.

Hvis dette sker for dig, skal du gå til woocommerce-gateway-klarna ->includes->variables-checkout.php .

Kig efter:

if ( ! is_admin() && ! empty( $klarna_country )) {

og ændre det til:

if ( ! is_admin() && ! empty( $klarna_country ) && WC()->session ) {

503 Serverfejl: Tjeneste utilgængelig #

Denne fejl er normalt midlertidig og skyldes, at serveren har for travlt til at håndtere anmodningen. Prøv igen lidt senere.

Hvis problemet bliver ved med at opstå, kan det betyde, at serveren er overbelastet med processer og er tæt på sin maksimale kapacitet.

Tjek serverbelastningen for at finde ud af, om det er tilfældet.

520 Webserver returnerede en ukendt fejl #

Denne fejl returneres normalt fra CloudFlare, og sker ofte på grund af en flaskehals i Woocommerce, der forårsager problemer med højere sidestørrelser. For at løse det skal du blot indstille din sidestørrelse til 50 og køre en ny synkronisering:

522 Serverfejl: Forbindelsen blev afbrudt #

Denne fejl opstår normalt, hvis serveren har for travlt til at svare, eller hvis vores importør ikke har adgang til serveren.

Vent først et par minutter, og prøv at synkronisere igen for at se, om serveren var optaget.

Hvis det stadig ikke virker, skal du sørge for at hvidliste importørens IP i din serverkonfiguration. Den seneste IP-adresse kan findes her.

Ugyldigt svar returneret fra WooCommerce API #

Denne fejl opstår normalt, hvis WooCommerces Fejlfinding er blevet aktiveret. Det er aldrig en god idé at have den aktiveret i en live-opsætning, fordi den gør siderne langsommere og potentielt viser fejlmeddelelser i frontend.

Synkroniseringsproblemet opstår, hvis WooCommerce støder på en fejl under generering af produktdata til importen.

Dette kan løses ved at deaktivering Debugging i wp-config.php ved at indstille define(WP_DEBUG’, false).

Denne vejledning forklarer det mere detaljeret:

https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/

Og denne guide forklarer en alternativ løsning:

https://aristath.github.io/blog/wp-hide-php-errors

Fejl vil stadig blive logget, selv når man ikke er i fejlsøgningstilstand, men de vil blive logget i en fil i stedet.

Opgradering til Clerk.js 2 #

Clerk.js 2 er en hurtigere og meget mere fleksibel version af vores JavaScript-bibliotek, som gør det til en leg at installere Clerk.io på enhver webshop.

Men da de to versioner fungerer lidt forskelligt, skal du følge disse trin for at få succes med opgraderingen.

De to største forskelle i Clerk.js 2 er, at designene i my.clerk.io bruger PLACEHOLDER_26 templating-sprog , men de kan også nemt oprettes ved hjælp af Design Editor.

Trin 1: Konvertering af design #

Da Clerk.js 2 har en anden tilgang til designs, er du nødt til at 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 vejledning for at se, hvordan du gør det.

1.1 Start med at gå til PLACEHOLDER_29 -> Anbefalinger / Søg -> Design og klik på Nyt design:

1.2. Vælg Design Skriv og følg designopsætningen Wizzard.

1.3. I Design Editor, Klik på et af de eksisterende elementer som navn, billede, knap osv. for at redigere det, eller Tilføj nye elementer til Design for at tilføj mere information om produkter.

1.4. Klik på Udgiv, når du er færdig, og gå til Trin 2 i guiden.

1.5. Til sidst skal du gå til Anbefalinger / Søg -> Indhold og ændre dit Clerk.io -indhold, så det bruger dit nye design.

1.6. Klik på Opdater indhold. Dette vil midlertidigt medføre, at de ikke vises på din webshop, indtil du er færdig med Trin 2. Vælg det nye design for alt indhold, der skal opdateres.

1.7. Sådan! Du er nu klar til at skifte til Clerk.js 2.

Trin 2: Opgradering af dit plugin #

ADVARSEL: Husk at tage sikkerhedskopier af alle ændrede filer, da de vil blive overskrevet.

Opgradering af pluginet kan gøres direkte fra WooCommerce-administrator.

Start ved at gå til Plugin-> Tilføj nyt

Søg derefter efter Ekspedient i søgefeltet til højre, og klik på Opdater nu.

Så er den der! Nu kører du den nyeste version af Clerk.io for WooCommerce, og Clerk.js 2 kører på din webshop!

Hvis du allerede har den nyeste version, vil denne knap blot sige Aktiv.

Den fulde dokumentation for Clerk.js 2 kan findes her:

https://docs.clerk.io/docs/clerkjs-quick-start

Links, der peger på backend #

Af og til laver Wordpress/Woocommerce-plugins rod i Wordpress’ omskrivningsregel.

Omskrivningsreglen er det sæt af konfigurationer, der sørger for, at links som dette

domæne.dk/?p=123

bliver til smukke og SEO-optimerede links som

domain.com/product/my-beautiful-product/.

og er faktisk tilgængelige for dig og dine kunder.

Hvis dine links ikke virker ordentligt, skal du gøre dette:

1. Log ind på din Wordpress-backend

2. Gå derefter til: Dashboard –> Indstillinger –> Permalink.

3. Rul ned, og klik på knappen “Gem ændringer” nederst på siden uden at ændre noget. Det vil overskrive Wordpress’ omskrivningsregel.

4. Når siden er blevet opdateret, Tøm din Wordpress-cache (hvis der er nogen), så vent et par minutter. Du bør kunne se alle dine websider igen.

Hvis du efter alt dette stadig ikke kan besøge dine websider, så kontakt os på support@clerk.io, vi er her for at hjælpe!

Advarsler vises i backend og frontend #

Synkroniseringsproblemet opstår, hvis WooCommerce støder på en fejl under generering af produktdata til importen.

Dette kan løses ved at deaktivering Debug Mode enten via plugin eller direkte i WooCommerce-filerne.

Håndtering af require.js #

Denne vejledning gælder kun, når du bruger op til PLACEHOLDER_34 af WooCommerce Clerk-udvidelsen.

I nogle opsætninger stopper Kræv.js indlæsningen af Clerk.js, hvilket betyder, at der ikke vises slidere eller søgeresultater.

Når det sker, vil følgende fejl blive vist i konsollen:

Uncaught ReferenceError: Clerk is not defined

Der er to måder at håndtere Require.js. på. Begge tilgange kræver, at du ændrer tracking-script i denne fil:

wp-content -> plugins -> clerkio -> includes -> class-clerk-visitor-tracking.php.

Inkluder “clerk” i Require.js

Den bedste tilgang er at forsøge at få Require.js til at genkende Clerk.io.

Det kan du gøre ved at indsætte require([‘clerk’], function() {}); i bunden af sporingsscriptet:

Brug af pluginet

Hvis du bruger Clerk.io’s v2.2.4eller en nyere version, kan fejlfinding deaktiveres direkte fra pluginsiden i din WooCommerce-backend.

Gå til Clerk -> Clerk Settings -> Debug Guide og klik på Deaktiver fejlfindingstilstand:

Eller direkte i filerne

Debug Mode kan også deaktiveres via FTP, i wp-config.php ved at indstille define(WP_DEBUG’, false).

Denne vejledning forklarer det mere detaljeret:

https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/

Og denne guide forklarer en alternativ løsning:

https://aristath.github.io/blog/wp-hide-php-errors

Fejl vil stadig blive logget, selv når man ikke er i fejlsøgningstilstand, men de vil blive logget i en fil i stedet.

Ignorer Require.js

Hvis ovenstående løsning ikke virker, er det muligt at ignorere Require.js.

Det kan du gøre ved at indsætte window.__clerk_ignore_requirejs = true;

i toppen af sporingsscriptet:

Når du har brugt en af disse tilgange, 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.