Extension

Konfigurer dine Magento 2 udvidelsesindstillinger, administrer datasynkroniseringsmuligheder, og tilpas søge-, anbefalings- og logningsfunktioner. Denne guide dækker også installation via Toolbox Script, opgradering og afinstallation.

Installation med toolbox #

Clerk Toolbox Script er lavet for at gøre det nemt at installere Clerk udvidelsen i din Magento webshop uden at bruge Magento Connect.

Toolbox Scriptet skal køres direkte fra en terminal.

Vi foreslår disse:

- Apple: iTerm, du skal downloade det fra internettet;

- Windows: Kommandoprompt, det er allerede installeret på din computer.

Scriptet opretter også en backup af Magento2 mappen, så den kan gendannes, hvis noget går galt.

Hvad du skal bruge #

For at kunne installere det, skal du have SSH eller SFTP adgang til din webshop, inklusive dit Brugernavn og Adgangskode.

Naviger til mappen #

1. Start med at logge ind på din Magento server via en terminal, ved at bruge dit Brugernavn og Domæne sådan her:

ssh Stefan@mywebshop.com

2. Du vil blive bedt om at indtaste adgangskoden til din bruger (terminalen vil ikke vise noget feedback, mens du taster adgangskoden, men den registrerer den alligevel).

Naviger til root-mappen af Magento2. Det gør du ved at skrive:

cd /var/www/html

og skrive:

ls

Dette giver dig en liste over mapper, som hjælper dig med at finde den rigtige:

I listen over mapper skal du finde den rigtige mappe, i dette tilfælde ville det være magento2.

På dette tidspunkt skal du gå ind i mappen, det gør du ved at skrive:

cd NAVN_PÅ_MAPPE

NAVN_PÅ_MAPPE udskiftes med det rigtige navn på mappen.

Installation af udvidelsen #

1. Når du er i din Root Folder, skal du hente Toolbox Scriptet med denne linje:

sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento2/master/clerk_toolbox_magento2.sh

2. Skriv derefter denne linje for at se en liste over de tilgængelige muligheder i Toolboxen:

sh clerk_toolbox_magento2.sh

3. Da du ønsker at installere udvidelsen, skal du bruge -i sammen med seneste versionsnummer for udvidelsen. Skriv denne linje:

sudo sh clerk_toolbox_magento2.sh -i

4. Du bliver nu bedt om at indtaste din adgangskode. Når det er gjort, vil scriptet tage backup af din Magento2 mappe og begynde at installere udvidelsen:

5. Færdig! Nu er udvidelsen installeret, og du kan konfigurere den i din Magento2 backend.

Valgfrie kommandoer #

Afinstallering

Toolboxen lader dig også afinstallere udvidelsen. Du kan gøre dette med denne linje:

sudo sh clerk_toolbox_magento2.sh -u

Gendannelse

Hvis noget går galt i din webshop, kan du altid gendanne gennem den backup, der blev lavet ved installation af udvidelsen.

Brug denne linje til det:

sudo sh clerk_toolbox_magento2.sh -r

Backup

Når du installerer udvidelsen, laver scriptet altid en backup først, men du kan også oprette en backup separat med denne linje:

sudo sh clerk_toolbox_magento2.sh -b

my.clerk.io indstillinger #

For at tilgå og redigere dine Magento 2 dataindstillinger i Clerk, gå til my.clerk.io, klik på “Data” i menuen til venstre og gå derefter til “Configuration”.

Bemærk: Information om Magento 2 Clerk udvidelsen, tilgængelig via Magento admin portalen, kommer senere i denne artikel.

Her kan du angive din butiks URL, sidestørrelsen for dine datasynkroniseringer, samt tidspunktet på dagen hvor dine data skal sync til Clerk (standard er “når nødvendigt”).

Udvidelsesindstillinger #

Hvis du bruger v6.7.0 eller en senere version af udvidelsen, vil du kunne tilgå nedenstående indstillinger på to måder efter at have tilføjet dine Public og Private Keys til udvidelsen:

• Gennem Magento2 backend i Stores > Settings > Configuration > Clerk > Configuration

• Gennem my.clerk.io under Developers > Extensions

Det er ligegyldigt, hvor du laver ændringerne, da udvidelsen synkroniserer med eventuelle ændringer lavet i my.clerk.io og omvendt.

I my.clerk.io vil du også kunne se din aktuelle version af udvidelsen, din platform og PHP-versionen.

Klik blot på “Edit” ved en indstilling for at se de tilgængelige muligheder:

Oversigt #

For at tilgå din Clerk udvidelse i Magento 2, log ind på din webshops admin portal og følg stien Stores > Settings > Configuration > Clerk > Configuration

Generelt #

Du finder versionsnummeret på din Clerk Extension samt butikkens public og private API keys i sektionen Generelt.

For at inkludere Sider i din data synk med Clerk, vælg “Yes” i næste dropdown, og indtast eventuelle yderligere felter, du ønsker at inkludere med dine sidedata (såsom billeder eller sidetype) som kommaseparerede værdier.

Du kan også angive standardsprog for dine synkroniserede butikdata i den sidste dropdown i Generelt.

Legacy Authentication #

Denne indstilling styrer, om udvidelsen bruger JWT header authentication eller den ældre private key metode. Det anbefales kraftigt at deaktivere dette, da JWT giver et mere sikkert og moderne autentificeringsflow for alle API-anmodninger mellem Magento 2 og Clerk.io.

Store ID #

Dette er et ældre konfigurationsfelt, der ikke længere benyttes i moderne installationer af Clerk.io. Det kan sikkert ignoreres, da udvidelsen automatisk identificerer og håndterer store scopes ved hjælp af Magentos native store og website APIs.

Synkronisering #

I Synchronization sektionen i Clerk plugin’et, har du mulighed for at tilpasse de synkroniserede kunde-, ordre-, kurv- og produktdata.

Valgmuligheder er gråtonede og utilgængelige for opdatering, når der bruges websitedata, hvilket fremgår af afkrydsningsfeltet til højre for hver sektion.

Fjern blot markeringen i det relevante felt for at kunne ændre.

• Brug Real-time Updates: vælg “Yes” for at aktivere realtid-opdateringer af dine data synkroniseret med Clerk.

• Indsaml Emails: vælg “Yes” her for at synkronisere kunde-emails.

• Indsaml Kurve: for at indsamle kurvdata og synkronisere til Clerk, vælg “Yes” her.

• I de næste to dropdowns vælger du “yes” for kun at synkronisere salgbar produkter, og/eller kun at synkronisere produkter med synlighed til Clerk.

• Hvis du har brug for at deaktivere ordre-synkronisering, kan du gøre det ved at vælge “Yes” i denne dropdown.

Yderligere felter #

En kommasepareret liste over yderligere produktattributter, du ønsker at synkronisere med Clerk.io (for eksempel, color, size, material). Dette giver dig mulighed for at bruge disse tilpassede attributter i dine Clerk.io anbefalingsdesigns, søgefiltre eller e-mail kampagner.

Søgning i ikke-indekserede attributter #

Når det er aktiveret, vil Clerk.io foretage en dybere forespørgsel for at hente værdier for brugerdefinerede attributter, der ikke er præindekseret i den standard Magento produktkollektion. Dette sikrer, at alle ønskede brugerdefinerede felter bliver synkroniseret korrekt, selvom det kan kræve lidt flere serverressourcer.

Tænk på det som at sende en meget høflig assistent for at rode gennem de støvede baghylder på dit lager i stedet for bare at læse clipboardet ved døren.

Spor returnerede ordrer #

Aktivering af denne mulighed tillader udvidelsen at lytte efter oprettelse af kreditnota i Magento (refunderinger og returneringer). Den sender automatisk oplysninger om returnerede produkter og mængder tilbage til Clerk.io for at holde dine anbefalinger og analyse helt nøjagtige.

Billedtype #

Denne dropdown giver dig mulighed for at vælge, hvilken Magento billedtype og dimensioner (såsom base image, small image eller thumbnail) der skal sendes til Clerk.io. Dette er meget nyttigt for at matche billedkvaliteten og billedformatet til dit butiks specifikke tema og design.

Kunde-synkronisering #

Aktivér kunde-data synk ved at vælge “Yes” i denne sektion.

Hvis du har ekstra kundeattributter, du gerne vil medtage i Clerk synken, skriver du deres værdier i tekstboksen her som en kommasepareret liste.

Sync Subscribers #

Aktivering af denne mulighed synkroniserer din butiks nyhedsbrevabonnenter til Clerk.io.

For registrerede kunder, som også er nyhedsbrevabonnenter, opdaterer udvidelsen automatisk deres eksisterende kundeprofil med subscribed: true og inkluderer deres unikke afmeldingslink.

For gæsteabonnenter (som har tilmeldt sig nyhedsbrevet, men ikke har en registreret kundekonto), synkroniserer udvidelsen dem som uafhængige profiler—som i Clerk.io blot identificeres via deres e-mailadresse—med et SUB ID præfiks. Dette sikrer, at hele din abonnentaudience bliver fanget uden at oprette dobbeltprofiler for registrerede kunder. Dette er yderst nyttigt, når du opbygger omfattende e-mail marketingmålgrupper og kører personlige e-mail kampagner.

Search #

Aktivér din butiks Search Page ved at vælge “Yes” i dropdown her.

• Når du har valgt “Enabled”, skal du indtaste dit Search Page Element navn, som matcher data-template feltet i embedkoden for dit Element i my.clerk.io. I dette eksempel: search-page.

• Du kan angive den tekst, der vises ved “load more” og “no results”, ved at skrive den ønskede sætning i disse tekstbokse.

Medtag kategorier #

Når denne funktion aktiveres, viser du kategoriresultater direkte på din hovedsøgeside sammen med produktresultater. Det hjælper kunderne med nemmere navigation ved at vise relevante kollektioner og kategorier, der matcher deres søgeforespørgsel.

Antal kategorier #

Angiver det maksimale antal kategorier, der vises på søgesiden. F.eks. ved opsætning til 5 vises op til fem matchende kategorier, så brugeren hurtigt kan hoppe til relevante sektioner af dit katalog.

Antal sider #

Angiver det maksimale antal CMS- eller indholdssideresultater, der skal vises på søgesiden. Dette er ideelt til at vise matchende blogindlæg, guides eller informationssider (f.eks. returpolitikker) sammen med produkter.

Sider-type #

Filtrer de typer CMS- eller indholdssider, der skal vises i søgeresultaterne. Du kan vælge kun at vise standard CMS-sider, specifikke blogindlæg eller alle indholdssider synkroniseret til Clerk.io.

Live search #

• Når du har valgt “Enabled” fra dropdown for at aktivere Live Search, vælger du, om du ønsker Categories vist i dine søgeresultater.

  • Du kan også vælge antal søgeresultater for suggestions, categories og content der skal vises i Live Search ud over dine produktresultater.

• Du kan også vælge, hvilke side-typer, der vises som søgeresultater, f.eks “CMS Pages”, “Blog Posts” eller “All”.

• Du kan vælge positionen af dropdownen for live search fra din søgeboks med Dropdown Positioning.

• Indtast derefter Element-navnet for din live search, som findes ved siden af data-template i din Live Search-embedkode i my.clerk.io elementet. Dette er sandsynligvis live-search.

• Til sidst har du mulighed for at angive dit Live Search Input Selector og Form Selector, som kan findes ved at inspicere din webshops søgeboks med din browser og identificere ID eller klassen for inputfeltet og formularen.

  • I dette eksempel, #search som input selector, og brug af webstedet vælges for identifikation af form selector.

Facetteret navigation #

For at tilføje facetter til din Search Page, skal du først vælge “Enabled” boksen under Faceted Navigation.

• Klik på de attributter, du vil tilføje til dine facetter, og klik på gem konfiguration.

• Når de er tilføjet, vil de vises under Titles. I denne sektion kan du oprette titlen, der vises for den facet, og hvilken position i listen den skal have.

Facets In Url #

Når det er aktiveret, føjer dette udvalgte søgefacetter (filtre) direkte til browserens URL-queryparametre. Det betyder, at kunder kan bogmærke, opdatere eller dele deres filtrerede søgeresultater med andre og bevare deres filtertilstand.

Multiselect Attributes #

Tillader dig at vælge, hvilke søgefacetter der skal understøtte valg af flere muligheder samtidig (f.eks. filtrering på både “Rød” og “Blå”). Dette giver meget mere fleksibel og brugervenlig filtrering.

Bemærk: Du kan nu hente data til kategorier og sider i din Search Page på samme måde som i Live Search, så du får et større udvalg af information til at involvere dine kunder med. For mere info kan du læse her.

Tilpasning af facetter #

• Clerk tillader dig at style dine søgefacetter via design, og du kan vise dette ved at referere til det med design ID feltet.

• Design ID kan findes i Clerk backend, i venstre kolonne på hver design på design-oversigtssiden og nederst til venstre, når du redigerer designet.

Powerstep og exit intent #

Ligesom med Search, aktivér din Clerk Powerstep ved at vælge “Yes” fra dropdownen, og vælg derefter typen af powerstep du ønsker (enten Page eller Popup).

• Angiv Element-navnet for din Powerstep, som findes ved siden af data-template i embedkoden i dit my.clerk.io Powerstep Element, for eksempel power-step-others-also-bought.

• Følg samme proces som ovenfor for at aktivere din Exit Intent og identificér og tilføj det korrekte Exit Intent Element.

Powerstep Filter Duplicates #

Aktivering af dette forhindrer dubletter af produkter i at blive anbefalet på tværs af flere sliders indenfor Powerstep. Hvis et produkt allerede vises i en slider, filtrerer Clerk.io det automatisk ud i efterfølgende sliders på samme side.

Recommendations #

Ligesom med Search, aktiver dine Clerk Product, Category og Cart Page Settings ved at vælge “Enabled” i de relevante dropdowns.

• Ligesom Search funktionalitet, finder du elementnavnet ved siden af data-template i embedkoden på my.clerk.io > Recommendations > Elements.

  • I dette eksempel har vi aktiveret Product Page, Category Page og Cart Page-indstillinger, og inkluderet category-page-popular som vores Category Page element, product-page-alternatives og product-page-others-also-bought på vores Product Page, samt cart-others-also-bought som vores Category Page element.

Category Filter Duplicates #

Aktivering af dette forhindrer dublerede produkter i at blive anbefalet på tværs af flere sliders på dine kategorisider. Det sikrer, at kunderne ser et forskelligartet produktsortiment i stedet for at se samme vare gentaget flere steder.

Product Filter Duplicates #

Aktivering af dette forhindrer dublerede produkter i at blive anbefalet på tværs af flere sliders på dine produktsidesder. Det holder dine anbefalinger friske og øger chancen for at fange kundens interesse med forskellige varer.

Cart Filter Duplicates #

Aktivering af dette forhindrer dublerede produkter i at blive anbefalet på tværs af flere sliders på indkøbskurvsiden. Dette er meget effektivt for mersalg, da det sikrer et bredere og mere engagerende udvalg af sidste-øjebliks tilføjelser.

Når alt kommer til alt—hvis en kunde allerede har valgt ikke at købe en neongrøn brødrister i den første slider, vil det næppe hjælpe at vise den tre gange mere inden checkout, og det får dem måske endda til at tvivle på din butiks sindstilstand.

Logging #

Det første du skal gøre for at ændre logningsindstillingerne er at gå ind i din Magento2 backend og vælge Stores => Configuration => Clerk => Configuration:

Find dropdownen kaldet Logging Settings og sæt dine foretrukne logningsindstillinger.

Afslut med at klikke på Save:

Logningsindstillingerne inkluderer:

Vælg logniveau

• Kun Fejl: Logger fejl, der forhindrer modulet i at fungere korrekt.

• Fejl + Advarsel: Logger også advarsler, der ikke stopper modulet, men som kan være relevante at rette.

• Fejl + Advarsel + Debug: Logger alt som modulet interagerer med. Dette bør IKKE aktiveres på en live webshop, da det vil gøre siden langsommere.

Vælg hvor der logges

• Fil: Gemmer loggen til en fil på Magento2 serveren.

• my.clerk.io: Logger alt til Developers->Logs i my.clerk.io backend.

Log Fil Link #

Viser absolutte sti til den lokale logfil på din Magento server (typisk /var/log/clerk_log.log). Dette gør det nemt for udviklere eller administratorer at finde og gennemgå rå logfiler, når de fejlsøger udvidelsens opførsel.

Opgradering #

Hvis du bruger en version før 3.0.0, vil opgradering ødelægge dine Designs, da Clerk.js 2 vil blive brugt. Hvis du bruger en ældre version, følg denne guide i stedet.

Vigtigt: Husk at tage backup af alle ændrede filer, da de bliver overskrevet.

Opgradering af Magento 2 udvidelsen sker via kommando-linje.

Det gøres ved at følge disse trin:

1. Log ind på din server via kommando-linje.

2. Navigér til din webroot-mappe (typisk " /var/www/your_domain/public_html")

3. Aktiver Root Access ved at skrive su og indtast din adgangskode.

4. Indtast følgende kommandoer i rækkefølge:

   composer update clerk/magento2

   php bin/magento setup:upgrade

   php bin/magento setup:di:compile

5. Vent på at udvidelsen bliver færdig.

Din Magento 2 er nu opgraderet til den nyeste version.

Afinstallation #

Ligesom ved installation af udvidelsen i Magento 2, skal afinstallering gøres fra Command Line.

Indtast blot følgende kommandoer i rækkefølge for at fjerne den:

1. php bin/magento setup:module:disable Clerk_Clerk

2. composer remove clerk/magento2