Extension

Installation mit dem Toolbox-Skript #

Das Clerk.io Toolbox-Skript wurde erstellt, um die Installation der Clerk.io Erweiterung in deinem Magento-Webshop ohne Verwendung von Magento Connect zu erleichtern.

Das Toolbox-Skript wird direkt von einem Terminal ausgeführt. Wir empfehlen diese:

- Apple: iTerm, du musst es aus dem Internet herunterladen;

- Windows: Eingabeaufforderung, es ist bereits auf deinem Computer installiert.

Das Skript erstellt auch ein Backup des Magento2-Ordners, sodass es wiederhergestellt werden kann, falls etwas schiefgeht.

Was benötige ich? #

Um es zu installieren, benötigst du SSH- oder SFTP-Zugriff auf deinen Webshop, einschließlich deines Benutzernamens und Passworts.

1. Navigieren zum Magento2-Ordner #

1.1 Melde dich zunächst über ein Terminal bei deinem Magento-Server an, indem du deinen Benutzernamen und Domain wie folgt verwendest:

ssh Stefan@mywebshop.com

1.2 Du wirst aufgefordert, das Passwort für deinen Benutzer einzugeben (das Terminal gibt dir beim Eingeben des Passworts kein Feedback, registriert es jedoch trotzdem).

Navigiere zum Root-Ordner von Magento2. Du kannst dies tun, indem du schreibst:

cd /var/www/html

und schreibst:

ls

Dies gibt dir eine Liste von Ordnern, um dir zu helfen, den richtigen zu finden:

In der Liste der Ordner suche nach dem richtigen Ordner, in diesem Fall wäre es magento2. An diesem Punkt musst du in den Ordner wechseln, du kannst dies tun, indem du schreibst:

cd NAME_FOLDER

NAME_FOLDER wird durch den tatsächlichen Namen des Ordners ersetzt.

2. Erweiterung installieren #

2.1. Wenn du in deinem Root-Ordner bist, musst du das Toolbox-Skript mit dieser Zeile herunterladen:

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

2.2. Danach gib diese Zeile ein, um eine Liste der verfügbaren Optionen innerhalb des Toolbox zu sehen:

sh clerk_toolbox_magento2.sh

2.3. Da du die Erweiterung installieren möchtest, verwendest du -i zusammen mit der letzten Versionsnummer der Erweiterung. Gib diese Zeile ein:

sudo sh clerk_toolbox_magento2.sh -i

2.4. Du wirst jetzt aufgefordert, dein Passwort einzugeben. Nachdem du dies getan hast, wird das Skript deinen Magento2-Ordner sichern und mit der Installation der Erweiterung beginnen:

2.5. Fertig! Jetzt ist die Erweiterung installiert, und du kannst sie in deinem Magento2-Backend konfigurieren.

Optional #

Deinstallation

Das Toolbox ermöglicht es dir auch, die Erweiterung zu deinstallieren. Du kannst dies mit dieser Zeile tun:

sudo sh clerk_toolbox_magento2.sh -u

Wiederherstellung

Falls etwas in deinem Webshop schiefgeht, kannst du es immer über das Backup wiederherstellen, das bei der Installation der Erweiterung erstellt wurde.

Verwende diese Zeile, um das zu tun:

sudo sh clerk_toolbox_magento2.sh -r

Backup

Bei der Installation der Erweiterung wird das Skript immer zuerst ein Backup erstellen, aber du kannst auch separat ein Backup mit dieser Zeile erstellen:

sudo sh clerk_toolbox_magento2.sh -b

my.clerk.io Einstellungen #

Um auf deine Magento 2-Dateneinstellungen in Clerk.io zuzugreifen und sie zu ändern, gehe zu my.clerk.io, klicke im linken Menü auf “Daten” und scrolle dann zu “Daten-Synchronisationseinstellungen”.

Hinweis: Informationen über die Magento 2 Clerk.io-Erweiterung, die über das Magento-Admin-Portal verfügbar sind, findest du später in diesem Artikel.

Hier kannst du die URL deines Shops, die Seitenanzahl deiner Datensynchronisationen sowie die Uhrzeit, zu der deine Daten mit Clerk.io synchronisiert werden sollen (der Standard ist “wenn nötig”), festlegen.

Erweiterungseinstellungen #

Wenn du v6.7.0 oder eine spätere Version der Erweiterung verwendest, kannst du die untenstehenden Einstellungen auf zwei Arten aufrufen, nachdem du deine Öffentlichen und Privaten Schlüssel zur Erweiterung hinzugefügt hast:

• Über das Magento2-Backend in Stores > Einstellungen > Konfiguration > Clerk > Konfiguration
• Über my.clerk.io, unter Einstellungen > Erweiterungen

Es spielt keine Rolle, wo du die Änderungen vornimmst, da die Erweiterung mit allen Änderungen, die in my.clerk.io vorgenommen werden, synchronisiert wird und umgekehrt.

In my.clerk.io kannst du auch die aktuelle Version der Erweiterung, deine Plattform und die PHP-Version sehen.

Klicke einfach auf “Bearbeiten” bei einer beliebigen Einstellung, um die verfügbaren Optionen zu sehen:

Übersicht #

Um auf deine Clerk.io-Erweiterung in Magento 2 zuzugreifen, melde dich im Admin-Portal deines Webshops an und folge dem Pfad Stores > Einstellungen > Konfiguration > Clerk > Konfiguration

Allgemein #

Du findest die Versionsnummer deiner Clerk.io-Erweiterung sowie die öffentlichen und privaten API-Schlüssel deines Shops im Abschnitt Allgemein.

Um Seiten in deiner Datensynchronisation mit Clerk.io einzuschließen, wähle “Ja” im nächsten Dropdown und gib alle zusätzlichen Felder ein, die du mit deinen Seitendaten einbeziehen möchtest (wie Bilder oder Seitentyp) als durch Kommas getrennte Werte.

Du kannst auch die Standardsprache für deine synchronisierten Shopdaten im letzten Dropdown im Abschnitt Allgemein festlegen.

Synchronisation #

Im Abschnitt Synchronisation des Clerk.io-Plugins hast du die Möglichkeit, deine synchronisierten Kunden-, Bestell-, Warenkorb- und Produktdaten anzupassen.

Optionen sind ausgegraut und nicht verfügbar für Updates, wenn die Website-Daten verwendet werden, was durch das Kontrollkästchen auf der rechten Seite jedes Abschnitts angezeigt wird. Deaktiviere einfach das entsprechende Kästchen, um Änderungen vorzunehmen.

• Echtzeit-Updates verwenden: wähle “Ja”, um Echtzeit-Updates für deine mit Clerk.io synchronisierten Daten zu aktivieren.

• E-Mails sammeln: wähle hier “Ja”, um Kundene-Mails zu synchronisieren.

• Warenkörbe sammeln: um Warenkorbdaten zu sammeln und mit Clerk.io zu synchronisieren, wähle hier “Ja”.

  • Um zusätzliche Warenkorbdatenfelder hinzuzufügen, füge diese als durch Kommas getrennte Werte im Abschnitt “zusätzliche Felder” unten ein.

• Wähle in den nächsten beiden Dropdowns “Ja”, um nur verkäufliche Produkte zu synchronisieren und/oder nur Produkte mit Sichtbarkeit zu Clerk.io zu synchronisieren.

• Solltest du die Bestellsynchronisation deaktivieren müssen, kannst du dies tun, indem du “Ja” in diesem Dropdown auswählst.

Kundensynchronisation #

Aktiviere die Kundendaten-Synchronisation, indem du “Ja” aus dem Dropdown in diesem Abschnitt auswählst. Wenn du zusätzliche Kundenattribute hast, die du in die Clerk.io-Synchronisation einbeziehen möchtest, gib deren Werte hier als durch Kommas getrennte Liste in das Textfeld ein.

Suche #

Aktiviere die Suchseite deines Shops, indem du “Ja” im Dropdown hier auswählst.

• Nachdem du “Aktiviert” ausgewählt hast, gib den Namen deines Suchseiteninhalts ein, der mit dem Daten-Template-Feld im Embed-Code deines Inhalts in my.clerk.io übereinstimmt. In diesem Beispiel, suchseite.

• Du kannst den Text für " mehr laden" und " keine Ergebnisse", der angezeigt wird, eingeben, indem du die gewünschte Phrase in diese Textfelder eingibst.

Live-Suche #

• Nachdem du “Aktiviert” aus dem Dropdown ausgewählt hast, um die Live-Suche zu aktivieren, wähle, ob du Kategorien in deinen Suchergebnissen angezeigt haben möchtest oder nicht.

  • Du kannst auch die Anzahl der Such-Vorschläge, Kategorien und Inhalts Ergebnisse auswählen, die zusätzlich zu deinen Produkt Ergebnissen in der Live-Suche angezeigt werden sollen.

• Du hast auch die Möglichkeit zu wählen, welche Seitentypen als Suchergebnisse angezeigt werden, zum Beispiel “CMS-Seiten”, “Blog-Beiträge” oder “Alle”.

• Du kannst die Position des Dropdowns für die Live-Suche aus deinem Suchfeld mit Dropdown-Positionierung wählen.

• Gib den Inhalts Namen für deine Live-Suche an, der neben dem Daten-Template in deinem Live-Suche Embed-Code innerhalb deines my.clerk.io Inhalts zu finden ist. Dies ist wahrscheinlich live-suche.

• Zuletzt hast du die Möglichkeit, deinen Live-Suche Eingabewähler und Formularwähler anzugeben, die du finden kannst, indem du das Suchfeld deines Webshops mit deinem Browser inspizierst und die ID oder Klasse identifizierst, die mit seiner Eingabe und seinem Formular verbunden ist.

  • In diesem Beispiel, #search als Eingabewähler, und die Website wird für die Identifizierung des Formularwählers gewählt.

Facettierte Navigation #

Um Facetten zu deiner Suchseite hinzuzufügen, stelle sicher, dass du das Kästchen “Aktiviert” unter Facettierte Navigation auswählst.

• Klicke auf die Attribute, die du zu deinen Facetten hinzufügen möchtest und klicke auf Konfiguration speichern.

• Sobald hinzugefügt, erscheinen deine hinzugefügten Attribute unter Titel. In diesem Abschnitt kannst du den Titel erstellen, der für diese Facette angezeigt werden soll, und welche Position in der Liste der Facetten du möchtest, dass dieses Attribut erscheint.

Hinweis: Du kannst jetzt die Daten für Kategorien und Seiten auf deiner Suchseite auf die gleiche Weise abrufen, wie du es in deiner Live-Suche tun würdest, was dir eine größere Bandbreite an Informationen bietet, um deine Kunden zu engagieren. Für weitere Informationen kannst du hier nachsehen.

Anpassung deiner Suchseiten-Facetten #

• Clerk.io ermöglicht es dir, die Facetten deiner Suchseite innerhalb des Designs zu gestalten, und du kannst dies tun, indem du auf das Design-ID-Feld verweist.
• Die Design-ID findest du im Clerk.io-Backend, in der äußeren linken Spalte jedes Designs auf der Designübersichtsseite und in der unteren linken Ecke der Seite, sobald du das Design zum Bearbeiten öffnest.
  
  

Powerstep und Exit-Intent #

Ähnlich wie bei der Suche, aktiviere deinen Clerk.io Powerstep, indem du “Ja” aus dem Dropdown auswählst, und wähle den Typ von Powerstep, den du anzeigen möchtest (entweder Seite oder Popup).

• Gib den Inhalts Namen für deinen Powerstep an, der neben dem Daten-Template im Embed-Code innerhalb deines my.clerk.io Powerstep-Inhalts zu finden ist, power-step-others-also-bought in diesem Beispiel.

• Befolge den gleichen Prozess wie oben, um deinen Exit-Intent zu aktivieren und den entsprechenden Exit-Intent-Inhalt zu identifizieren und hinzuzufügen.

Kategorie-, Produkt- und Warenkorbseite #

Ähnlich wie bei der Suche aktiviere deine Clerk.io Produkt-, Kategorie- und Warenkorbseiteneinstellungen, indem du “Aktiviert” aus den entsprechenden Dropdowns auswählst.

• Genauso wie bei den Suchfunktionen findest du den Inhaltsnamen neben dem Daten-Template im Embed-Code innerhalb von my.clerk.io > Empfehlungen > Inhalt.
  • In diesem Beispiel haben wir die Produktseite, die Kategorieseite und die Warenkorbseiteneinstellungen aktiviert und die Kategorie-seite-beliebteste als unseren Inhalt für die Kategorieseite, produkt-seite-alternativen und produkt-seite-andere-auch-gemacht auf unserer Produktseite sowie warenkorb-andere-auch-gemacht als unseren Inhalt für die Kategorieseite hinzugefügt.

Protokollierung #

Das erste, was du tun musst, um die Protokollierungseinstellungen zu ändern, ist, in dein Magento2-Backend zu gehen und Stores => Konfiguration => Clerk => Konfiguration auszuwählen:

Finde das Dropdown mit dem Namen Protokollierungseinstellungen und stelle deine bevorzugten Protokollierungseinstellungen ein. Beende mit einem Klick auf Speichern:

Die Protokollierungseinstellungen umfassen:

Wähle das Protokollierungslevel

• Nur Fehler: Protokolliert alle Fehler, die das Modul daran hindern, korrekt zu funktionieren.

• Fehler + Warnung: Protokolliert auch Warnungen, die das Modul nicht daran hindern, zu funktionieren, aber möglicherweise ebenfalls behoben werden müssen.

• Fehler + Warnung + Debug: Protokolliert alles, mit dem das Modul interagiert. Dies sollte nicht auf einem Live-Webshop aktiviert werden, da es die Seite verlangsamt.

Wähle, wo protokolliert werden soll

• Datei: Speichert das Protokoll in einer Datei auf dem Magento2-Server.

• my.clerk.io: Protokolliert alles in Daten->Protokolle im my.clerk.io Backend.

Upgrade #

Wenn du eine Version vor 3.0.0 verwendest, wird das Upgrade deine Designs brechen, da Clerk.js 2 verwendet wird. Wenn du eine ältere Version verwendest, folge stattdessen diesem Leitfaden.

Das Upgrade der Magento 2-Erweiterung erfolgt über Befehlszeile.

Es erfolgt durch die folgenden Schritte:

1. Melde dich über Befehlszeile bei deinem Server an.

2. Navigiere zu deinem Webroot-Ordner (normalerweise “/var/www/deine_domain/public_html”).

3. Aktiviere Root-Zugriff, indem du su eingibst und dann dein Passwort eingibst.

4. Gib die folgenden Befehle in der angegebenen Reihenfolge ein:

   composer update clerk/magento2

   php bin/magento setup:upgrade

   php bin/magento setup:di:compile

5. Warte, bis die Erweiterung fertig ist.

Dein Magento 2 ist jetzt auf die neueste Version aktualisiert.

Deinstallation #

Genau wie bei der Installation von Erweiterungen in Magento 2 muss die Deinstallation über die Befehlszeile erfolgen.

Gib einfach die folgenden Befehle in der angegebenen Reihenfolge ein, um sie zu entfernen:

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

2. composer remove clerk/magento2