Magento 2

Extension

Konfigurer dine Magento 2-udvidelsesindstillinger, og administrer installation, opgraderinger og indstillinger for datasynkronisering

Konfigurer dine Magento 2 udvidelsesindstillinger, administrer datasynkroniseringsmuligheder, og tilpas search, recommendations 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 Script 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å det kan gendannes, hvis noget går galt.

Hvad du skal bruge #

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

  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
  1. Du bliver bedt om at indtaste adgangskoden til din bruger (terminalen giver ingen feedback under indtastningen af adgangskoden, men den registrerer det alligevel).

Naviger til root-mappen for Magento2. Det kan du gøre ved at skrive:

cd /var/www/html

og derefter skrive:

ls

ls-kommandoen viser mapperne, så du kan finde din Magento root-mappe.

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

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

cd NAME_FOLDER

NAME_FOLDER erstattes med det rigtige navn på mappen.

Installation af udvidelsen #

  1. Når du er i din Root-mappe, skal du hente Toolbox Script med denne linje:
sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento2/master/clerk_toolbox_magento2.sh
  1. Derefter skal du skrive denne linje for at se en liste over tilgængelige valgmuligheder i Toolbox:
sh clerk_toolbox_magento2.sh
  1. Da du ønsker at installere udvidelsen, skal du bruge -i sammen med det nyeste versionsnummer af udvidelsen. Indtast denne linje:
sudo sh clerk_toolbox_magento2.sh -i

  1. Du vil nu blive bedt om at indtaste din adgangskode. Efter dette vil scriptet tage backup af din Magento2-mappe og begynde at installere udvidelsen:

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

Valgfrie kommandoer #

Afinstallation

Toolbox gør det også muligt at afinstallere udvidelsen. Det kan du gøre med denne linje:

sudo sh clerk_toolbox_magento2.sh -u

Gendan

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

Brug denne linje til det:

sudo sh clerk_toolbox_magento2.sh -r

Backup

Når du installerer udvidelsen, opretter 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 få adgang til og ændre dine Magento 2 dataindstillinger i Clerk skal du gå til my.clerk.io, klikke på “Data” i menuen i venstre side og derefter gå til “Configuration”.

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

Her kan du indstille din butiks URL, sidestørrelsen på dine datasynkroniseringer samt tidspunkt for, hvornår dine data skal synkroniseres til Clerk (standarden er “når det er nødvendigt”).

Udvidelsesindstillinger #

Hvis du bruger v6.7.0 eller en nyere 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 under Stores > Settings > Configuration > Clerk > Configuration

  • Gennem my.clerk.io under Developers > Extensions

Det er ligegyldigt hvor du foretager ændringerne, da udvidelsen vil synkronisere med alle ændringer foretaget i my.clerk.io og omvendt.

I my.clerk.io kan du også se den nuværende version af udvidelsen, din platform og PHP-versionen.

Klik på Edit ud for en indstilling for at se de tilgængelige muligheder.

Overblik #

For at få adgang til din Clerk-udvidelse i Magento 2 skal du logge ind på din webshops admin-portal og derefter følge stien Stores > Settings > Configuration > Clerk > Configuration

Generelt #

Du finder versionsnummeret på din Clerk Extension samt din butiks offentlige og private API-nøgler under Generelt-sektionen.

For at inkludere Pages i din datasynkronisering med Clerk, vælg “Yes” i den næste dropdown og angiv eventuelle ekstra felter, du ønsker at inkludere sammen med dine sidedata (såsom billeder eller sidetype) som kommaseparerede værdier.

Du kan også indstille standardsproget for dine synkroniserede butikdata i den sidste dropdown i Generelt.

Legacy Authentication #

Denne indstilling bestemmer, om udvidelsen bruger JWT header-autentifikation eller den ældre private key-metode. Det anbefales stærkt at deaktivere dette, da JWT giver et mere sikkert og moderne autentifikationsflow for alle API-forespørgsler mellem Magento 2 og Clerk.io.

Store ID #

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

Synkronisering #

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

Valgmuligheder er gråtonede og utilgængelige for opdatering ved brug af website-data, indikeret af afkrydsningsfeltet til højre for hver sektion.

Fjern afkrydsningen i det relevante felt for at kunne ændre dem.

  • Use Real-time Updates: vælg “Yes” for at aktivere realtidsopdateringer af dine data, som synkroniseres med Clerk.

Med realtidsopdateringer aktiveret, vil lager nu blive opdateret efter ordrer samt efter produktsave i Magento 2 admin.

  • Collect Emails: vælg “Yes” her for at synkronisere kundemails.

  • Collect Baskets: for at indsamle basket-data og synkronisere til Clerk, vælg “Yes” her.

  • I de næste to dropdowns, vælg “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.

Additional Fields #

En kommasepareret liste over ekstra produktattributter, du ønsker at synkronisere med Clerk.io (for eksempel, color, size, material). Dette gør det muligt at bruge disse attributter i Clerk.io recommendations design, search filtre eller emailkampagner.

Search Non-Indexed Attributes #

Når aktiveret, vil Clerk.io foretage en dybere forespørgsel for at hente værdier for tilpassede attributter, der ikke er pre-indekserede i standard Magento produktkollektionen. Dette sikrer, at alle anmodede brugerdefinerede felter bliver synkroniseret, dog kan det kræve lidt flere serverressourcer.

Forestil dig, at det er som at sende en meget høflig assistent på jagt gennem lagerets støvede baglokaler i stedet for bare at læse tjeklisten ved døren.

Track Returned Orders #

Når dette er aktiveret, lytter udvidelsen efter oprettelse af kreditnota i Magento 2. Kreditnotaer synkroniserer lagerændringer og sporer returnerede varer i Clerk.io.

Image Type #

Denne dropdown giver dig mulighed for at vælge, hvilken Magento-billedtype og dimensioner (f.eks. base image, small image eller thumbnail), der skal sendes til Clerk.io. Dette er meget nyttigt for at matche billedkvalitet og aspekforhold til din butiks specifikke tema og design.

Kundesynkronisering #

Aktiver kundedata-synkronisering ved at vælge “Yes” i denne sektion.

Hvis du har ekstra kundeattributter, du vil inkludere i Clerk-synkroniseringen, kan du indtaste deres værdier her som en kommasepareret liste.

Sync Subscribers #

Når dette er aktiveret, synkroniseres din butiks nyhedsbrevsabonnenter til Clerk.io.

For registrerede kunder, som også er nyhedsbrevsabonnenter, 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 med deres e-mailadresse—med et SUB ID-præfiks. Dette sikrer, at hele dit abonnent-audience bliver fanget uden at oprette dublette profiler for registrerede kunder. Dette er ekstremt nyttigt til at opbygge omfattende email marketing audiences og køre personlige emailkampagner.

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

  • Efter aktivering af Search Page, indtast Element-navnet fra dets embed-kodes data-template-felt. For eksempel, brug search-page, hvis det er navnet på dit Element.

  • Du kan sætte teksten til “load more” og “no results”, der vises, ved at skrive det ønskede udtryk i disse tekstbokse.

Include Categories #

Når dette er aktiveret, inkluderes kategoriresultater direkte på din hoved-search-side sammen med produktresultater. Dette hjælper kunder med at navigere lettere ved at vise relevante kollektioner og kategorier, der matcher deres søgeforespørgsel.

Number of Categories #

Indstiller det maksimale antal kategoriresultater, der skal vises på search-siden. Sætter du dette til 5, vil der for eksempel blive vist op til fem matchende kategorier, så brugere hurtigt kan gå til relevante dele af kataloget.

Number of Pages #

Indstiller det maksimale antal CMS- eller indholdssideresultater, der vises på search-siden. Dette er ideelt for at vise matchende blogindlæg, guides eller informationssider (såsom returpolitik) sammen med produkterne.

Pages Type #

Filtrerer hvilke typer CMS- eller indholdssider, der skal vises i search-resultaterne. Du kan vælge kun at vise standard CMS-sider, bestemte blogindlæg, eller alle indholdssider synkroniseret til Clerk.io.

  • Efter at have valgt “Enabled” i dropdown for at aktivere Live Search, vælg om du vil have Categories vist i dine søgeresultater.

    • Du kan også vælge antallet af search suggestions, categories og content resultater, der skal vises i Live Search, ud over dine produktresultater.

  • Derudover kan du vælge, hvilke page types der vises som søgeresultater, for eksempel “CMS Pages”, “Blog Posts” eller “All”.

  • Du kan vælge positionen af live search-dropdown’en fra din søgeboks med Dropdown Positioning.

  • Angiv herefter Element-navnet for din live search, som kan findes ud for data-template i din Live Search embed-kode i din my.clerk.io Element. Det hedder sandsynligvis live-search.

  • Til sidst har du mulighed for at angive dine Live Search Input Selector og Form Selector, som du kan finde ved at inspicere din webshops søgeboks med din browser og identificere det ID eller den klasse, der er knyttet til dens input og form.

    • For et input med ID search bruges #search som input-selector. Vælg derefter den relevante form-selector for din webshop.

Faceted navigation #

For at tilføje facetter til din Search Page skal du først sørge for at markere “Enabled” under Faceted Navigation.

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

  • Når de er tilføjet, vises dine tilføjede attributter under Titles. I denne sektion kan du oprette titlen, der skal vises for den facet, og hvilken position i facetrækkets liste, attributten skal have.

Facets In Url #

Når dette er aktiveret, tilføjes valgte search-facetter (filtre) direkte til browserens URL-query-parametre. Dette gør det muligt for kunder at bogmærke, opdatere eller dele deres filtrerede søgeresultater med andre, mens den nøjagtige filtertilstand bevares.

Multiselect Attributes #

Giver mulighed for at vælge hvilke search-facetter, der skal understøtte valg af flere muligheder samtidigt (f.eks. filter på både “Rød” og “Blå” farver). Dette giver en mere fleksibel og brugervenlig filtreringsoplevelse.

Bemærk: Du kan nu kalde data for kategorier og sider i din Search Page på samme måde, som du kan i Live Search, så du har adgang til flere informationer til at engagere dine kunder. For mere information kan du se her.

Tilpasning af facetter #

  • Clerk gør det muligt at style dine search page-facetter direkte fra designet, og du kan vise dette ved at referere til det med design ID-feltet.

  • Design ID kan findes i Clerk backend, på helt venstre kolonne for hvert design på design oversigten og i nederste venstre hjørne, når du redigerer designet.

Powerstep og exit intent #

Ligesom Search, aktiver din Clerk Powerstep ved at vælge “Yes” i dropdown, og vælg derefter typen af powerstep du ønsker (enten Page eller Popup).

  • Indtast Powerstep-Element-navnet fra embed-kodens data-template-felt. For eksempel, brug power-step-others-also-bought, hvis det er navnet på dit Element.

  • Følg samme proces som ovenfor for at aktivere din Exit Intent og identificere og tilføje det relevante Exit Intent Element.

Powerstep Filter Duplicates #

Når dette er aktiveret, forhindres det, at dubletprodukter anbefales på tværs af flere sliders i Powerstep. Hvis et produkt allerede vises i én slider, vil Clerk.io automatisk filtrere det væk fra de næste sliders på samme side.

Recommendations #

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

  • Ligesom med Search-funktionaliteterne, kan du finde elementnavnet ud for data-template i embed-koden i my.clerk.io > Recommendations > Elements.

    • For eksempel kan du aktivere Category, Product og Cart Page-indstillinger og tildele category-page-popular, product-page-alternatives, product-page-others-also-bought, og cart-others-also-bought til deres respektive sider.

Category Filter Duplicates #

Når dette er aktiveret, forhindres dubletprodukter i at blive anbefalet på tværs af flere sliders på dine kategorisider. Det sikrer, at kunder præsenteres for et varieret udvalg af produkter i stedet for at se de samme varer gentaget i forskellige sektioner.

Product Filter Duplicates #

Når dette er aktiveret, forhindres dubletprodukter i at blive anbefalet på tværs af flere sliders på dine produktsidedetaljer. Dette holder dine recommendations friske og øger chancen for at fange kundens interesse med forskellige varer.

Cart Filter Duplicates #

Når dette er aktiveret, forhindres dubletprodukter i at blive anbefalet på tværs af flere sliders på indkøbskurvsiden. Dette er meget effektivt til mersalg, da det sikrer et bredere og mere engagerende udvalg af sidste-minuts-tilføjelser.

Når alt kommer til alt: Hvis en kunde allerede har sagt nej til at købe en neongrøn brødrister i den første slider, ændrer det næppe noget at vise den tre gange mere før kassen, og det kan endda få kunden til at sætte spørgsmålstegn ved din butiks sund fornuft.

Logging #

For at ændre logningsindstillinger, åbn Stores > Configuration > Clerk > Configuration i din Magento 2 backend.

Find dropdown’en kaldet Logging Settings og vælg dine foretrukne logningsindstillinger.

Klik på Save for at gemme ændringerne.

Logningsindstillingerne omfatter:

Vælg logningsniveau

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

  • Error + Warn: Logger også advarsler, som ikke får modulet til at stoppe, men som stadig kan være nødvendige at rette.

  • Error + Warn + 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

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

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

Viser den 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å de rå logfiler, når de fejlfinder udvidelsens opførsel.

Opgradering #

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

Vigtigt: Husk at tage backup af ændrede filer, da de vil blive overskrevet.

Opgradering af Magento 2-udvidelsen udføres via commandline.

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

  1. Log ind på din server via commandline.

  2. Naviger til din webroot-mappe (normalt " /var/www/your_domain/public_html")

  3. Aktiver Root Access ved at skrive su, og indtast derefter 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 er færdig.

Din Magento 2 er nu opgraderet til den nyeste version.

Afinstallation #

Præcis som når du installerer udvidelser i Magento 2, skal afinstallation foretages via 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

Denne side er oversat af en hjælpsom AI, og der kan derfor være sproglige fejl. Tak for forståelsen.