Extension

Installation mit dem Toolbox-Skript #

Das Clerk.io Toolbox-Skript wurde entwickelt, um die Installation der Clerk.io Erweiterung in Ihrem Magento-Webshop zu erleichtern, ohne Magento Connect verwenden zu müssen.

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

- Apple: iTerm, Sie müssen es aus dem Internet herunterladen;

- Windows: Eingabeaufforderung, es ist bereits auf Ihrem 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ötigen Sie SSH- oder SFTP-Zugriff auf Ihren Webshop, einschließlich Ihres Benutzernamens und Passworts.

1. Navigieren zum Magento2-Ordner #

1.1 Beginnen Sie damit, sich über ein Terminal auf Ihrem Magento-Server anzumelden, indem Sie Ihren Benutzernamen und Domain wie folgt verwenden:

ssh Stefan@mywebshop.com

1.2 Sie werden aufgefordert, das Passwort für Ihren Benutzer einzugeben (das Terminal gibt Ihnen während der Eingabe des Passworts kein Feedback, registriert es jedoch trotzdem).

Navigieren Sie zum Root-Ordner von Magento2. Sie können dies tun, indem Sie schreiben:

cd /var/www/html

und schreiben:

ls

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

In der Liste der Ordner suchen Sie nach dem richtigen Ordner, in diesem Fall wäre es magento2. An diesem Punkt müssen Sie in den Ordner gelangen, das können Sie tun, indem Sie schreiben:

cd NAME_FOLDER

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

2. Erweiterung installieren #

2.1. Wenn Sie sich im Root-Ordner befinden, müssen Sie das Toolbox-Skript mit dieser Zeile herunterladen:

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

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

sh clerk_toolbox_magento2.sh

2.3. Da Sie die Erweiterung installieren möchten, verwenden Sie -i zusammen mit der letzten Versionsnummer der Erweiterung. Geben Sie diese Zeile ein:

sudo sh clerk_toolbox_magento2.sh -i

2.4. Sie werden nun aufgefordert, Ihr Passwort einzugeben. Nachdem Sie dies getan haben, wird das Skript Ihren Magento2-Ordner sichern und mit der Installation der Erweiterung beginnen:

2.5. Fertig! Jetzt ist die Erweiterung installiert, und Sie können sie in Ihrem Magento2-Backend konfigurieren.

Optional #

Deinstallation

Das Toolbox-Skript ermöglicht es Ihnen auch, die Erweiterung zu deinstallieren. Sie können dies mit dieser Zeile tun:

sudo sh clerk_toolbox_magento2.sh -u

Wiederherstellung

Falls etwas in Ihrem Webshop schiefgeht, können Sie es immer über das Backup wiederherstellen, das bei der Installation der Erweiterung erstellt wird.

Verwenden Sie diese Zeile, um dies zu tun:

sudo sh clerk_toolbox_magento2.sh -r

Backup

Bei der Installation der Erweiterung erstellt das Skript immer zuerst ein Backup, aber Sie können auch separat ein Backup mit dieser Zeile erstellen:

sudo sh clerk_toolbox_magento2.sh -b

my.clerk.io Einstellungen #

Um auf Ihre Magento 2-Dateneinstellungen in Clerk.io zuzugreifen und diese zu ändern, gehen Sie zu my.clerk.io, klicken Sie im linken Menü auf “Daten” und scrollen Sie dann zu “Daten-Synchronisationseinstellungen”.

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

Hier können Sie die URL Ihres Shops, die Seitenanzahl Ihrer Datensynchronisation sowie die Uhrzeit, zu der Ihre Daten mit Clerk.io synchronisiert werden sollen (standardmäßig “wenn erforderlich”), festlegen.

Erweiterungseinstellungen #

Wenn Sie v6.7.0 oder eine spätere Version der Erweiterung verwenden, können Sie die folgenden Einstellungen auf zwei Arten nach dem Hinzufügen Ihrer Öffentlichen und Privaten Schlüssel zur Erweiterung aufrufen:

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

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

In my.clerk.io können Sie auch die aktuelle Version der Erweiterung, Ihre Plattform und die PHP-Version sehen.

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

Übersicht #

Um auf Ihre Clerk.io-Erweiterung in Magento 2 zuzugreifen, melden Sie sich im Admin-Portal Ihres Webshops an und folgen Sie dem Pfad Stores > Einstellungen > Konfiguration > Clerk > Konfiguration

Allgemein #

Sie finden die Versionsnummer Ihrer Clerk.io-Erweiterung sowie die öffentlichen und privaten API-Schlüssel Ihres Shops im Abschnitt Allgemein.

Um Seiten in Ihre Datensynchronisation mit Clerk.io einzubeziehen, wählen Sie “Ja” im nächsten Dropdown und geben Sie alle zusätzlichen Felder ein, die Sie mit Ihren Seitendaten einbeziehen möchten (wie Bilder oder Seitentyp) als durch Kommas getrennte Werte.

Sie können auch die Standardsprache für Ihre synchronisierten Shopdaten im letzten Dropdown im Abschnitt Allgemein festlegen.

Synchronisation #

Im Abschnitt Synchronisation des Clerk.io-Plugins haben Sie die Möglichkeit, Ihre synchronisierten Kunden-, Bestell-, Warenkorb- und Produktdaten anzupassen.

Optionen sind ausgegraut und nicht verfügbar für Updates, wenn die Websitedaten verwendet werden, was durch das Kontrollkästchen rechts in jedem Abschnitt angezeigt wird. Deaktivieren Sie einfach das entsprechende Kästchen, um Änderungen vorzunehmen.

• Echtzeit-Updates verwenden: Wählen Sie “Ja”, um Echtzeit-Updates für Ihre mit Clerk.io synchronisierten Daten zu aktivieren.

• E-Mails sammeln: Wählen Sie hier “Ja”, um Kunden-E-Mails zu synchronisieren.

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

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

• Wählen Sie in den nächsten beiden Dropdowns “Ja”, um nur verkaufsfähige Produkte zu synchronisieren und/oder nur Produkte mit Sichtbarkeit zu Clerk.io zu synchronisieren.

• Falls Sie die Bestellsynchronisation deaktivieren müssen, können Sie dies tun, indem Sie “Ja” in diesem Dropdown auswählen.

Kundensynchronisation #

Aktivieren Sie die Kundendaten-Synchronisation, indem Sie “Ja” aus dem Dropdown in diesem Abschnitt auswählen. Wenn Sie zusätzliche Kundenattribute haben, die Sie in die Clerk.io-Synchronisation einbeziehen möchten, geben Sie deren Werte hier als durch Kommas getrennte Liste ein.

Suche #

Aktivieren Sie die Suchseite Ihres Shops, indem Sie “Ja” im Dropdown hier auswählen.

• Nachdem Sie “Aktiviert” ausgewählt haben, geben Sie den Namen Ihres Suchseiteninhalts ein, der mit dem Daten-Template-Feld im Embed-Code Ihres Inhalts in my.clerk.io übereinstimmt. In diesem Beispiel, such-seite.

• Sie können den Text für " mehr laden" und " keine Ergebnisse", der angezeigt wird, festlegen, indem Sie den gewünschten Satz in diese Textfelder eingeben.

Live-Suche #

• Nachdem Sie “Aktiviert” aus dem Dropdown ausgewählt haben, um die Live-Suche zu aktivieren, wählen Sie aus, ob Kategorien in Ihren Suchergebnissen angezeigt werden sollen oder nicht.

  • Sie können auch die Anzahl der Such-Vorschläge, Kategorien und Inhalts Ergebnisse auswählen, die zusätzlich zu Ihren Produktresultaten in der Live-Suche angezeigt werden sollen.

• Sie haben auch die Möglichkeit auszuwählen, welche Seitentypen als Suchergebnisse angezeigt werden, z. B. “CMS-Seiten”, “Blog-Beiträge” oder “Alle”.

• Sie können die Position des Dropdowns für die Live-Suche in Ihrem Suchfeld mit Dropdown-Positionierung auswählen.

• Geben Sie den Inhalts Namen für Ihre Live-Suche an, der neben dem Daten-Template in Ihrem Live-Suche-Embed-Code innerhalb Ihres my.clerk.io-Inhalts zu finden ist. Dies ist wahrscheinlich live-suche.

• Zuletzt haben Sie die Möglichkeit, Ihren Live-Suche-Eingabeselektor und Formularselektor anzugeben, die Sie finden können, indem Sie das Suchfeld Ihres Webshops mit Ihrem Browser inspizieren und die ID oder Klasse identifizieren, die mit dessen Eingabe und Formular verbunden ist.

  • In diesem Beispiel, #search als Eingabeselektor, und die Website wird zur Identifizierung des Formularselekors verwendet.

Facettierte Navigation #

Um Facetten zu Ihrer Suchseite hinzuzufügen, stellen Sie zunächst sicher, dass Sie das Kästchen “Aktiviert” unter Facettierte Navigation auswählen.

• Klicken Sie auf die Attribute, die Sie zu Ihren Facetten hinzufügen möchten, und klicken Sie auf Konfiguration speichern.

• Sobald hinzugefügt, erscheinen Ihre hinzugefügten Attribute unter Titel. In diesem Abschnitt können Sie den Titel erstellen, der für diese Facette angezeigt werden soll, und an welcher Position in der Liste der Facetten Sie möchten, dass dieses Attribut erscheint.

Hinweis: Sie können jetzt die Daten für Kategorien und Seiten in Ihrer Suchseite auf die gleiche Weise abrufen, wie Sie es in Ihrer Live-Suche tun würden, was Ihnen eine größere Informationsvielfalt bietet, um Ihre Kunden zu engagieren. Für weitere Informationen können Sie hier nachsehen.

Anpassen Ihrer Suchseitenfacetten #

• Clerk.io ermöglicht es Ihnen, die Facetten Ihrer Suchseite aus dem Design heraus zu gestalten, und Sie können dies tun, indem Sie sich auf das Design-ID-Feld beziehen.
• Die Design-ID finden Sie 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 Sie das Design zum Bearbeiten betreten.
  
  

Powerstep und Exit Intent #

Ähnlich wie bei der Suche aktivieren Sie Ihren Clerk.io Powerstep, indem Sie “Ja” aus dem Dropdown auswählen, und wählen Sie den Typ des Powersteps aus, den Sie anzeigen möchten (entweder Seite oder Popup).

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

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

Kategorie-, Produkt- und Warenkorbseite #

Ähnlich wie bei der Suche aktivieren Sie Ihre Clerk.io Produkt-, Kategorie- und Warenkorbseiteneinstellungen, indem Sie “Aktiviert” aus den entsprechenden Dropdowns auswählen.

• Genau wie bei den Suchfunktionen finden Sie den Inhaltsnamen neben dem Daten-Template im Embed-Code innerhalb von my.clerk.io > Empfehlungen > Inhalt.
  • In diesem Beispiel haben wir die Einstellungen für die Produktseite, die Kategorieseite und die Warenkorbseite aktiviert und category-page-popular als unseren Kategorieseiteninhalt, product-page-alternatives und product-page-others-also-bought auf unserer Produktseite sowie cart-others-also-bought als unseren Kategorieseiteninhalt hinzugefügt.

Protokollierung #

Das erste, was Sie tun müssen, um die Protokollierungseinstellungen zu ändern, ist, in Ihr Magento2-Backend zu gehen und Stores => Konfiguration => Clerk => Konfiguration auszuwählen:

Suchen Sie das Dropdown mit der Bezeichnung Protokollierungseinstellungen und legen Sie Ihre bevorzugten Protokollierungseinstellungen fest. Beenden Sie mit einem Klick auf Speichern:

Die Protokollierungseinstellungen umfassen:

Wählen Sie die Protokollierungsebene

• 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ählen Sie, 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 Sie eine Version vor 3.0.0 verwenden, wird das Upgrade Ihre Designs brechen, da Clerk.js 2 verwendet wird. Wenn Sie eine ältere Version verwenden, folgen Sie stattdessen diesem Leitfaden.

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

Es erfolgt durch die folgenden Schritte:

1. Melden Sie sich über die Befehlszeile bei Ihrem Server an.

2. Navigieren Sie zu Ihrem Webroot-Ordner (normalerweise " /var/www/your_domain/public_html").

3. Aktivieren Sie Root-Zugriff, indem Sie su eingeben und dann Ihr Passwort eingeben.

4. Geben Sie die folgenden Befehle in der richtigen Reihenfolge ein:

   composer update clerk/magento2

   php bin/magento setup:upgrade

   php bin/magento setup:di:compile

5. Warten Sie, bis die Erweiterung fertig ist.

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

Geben Sie einfach die folgenden Befehle in der richtigen Reihenfolge ein, um sie zu entfernen:

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

2. composer remove clerk/magento2