Extension

Konfigurieren Sie die Einstellungen Ihrer Magento 1 Extension, verwalten Sie Daten-Sync-Optionen und passen Sie Search, Recommendations und Logging-Funktionen an. Dieser Leitfaden behandelt außerdem die Installation über das Toolbox Script, das Upgrade sowie die Deinstallation.

Installation mit Toolbox #

Das Clerk Toolbox Script wurde entwickelt, um die Installation der Clerk Extension in Ihrem Magento Webshop zu erleichtern, ohne Magento Connect zu verwenden.

Das Toolbox Script wird direkt aus einem Terminal ausgeführt.

Wir empfehlen diese: - Apple: iTerm, den Sie aus dem Internet herunterladen müssen; - Windows: Eingabeaufforderung, diese ist bereits auf Ihrem Computer installiert.

Das Script erstellt zudem ein Backup des Magento-Ordners, sodass es wiederhergestellt werden kann, falls etwas schiefgeht.

Was Sie benötigen #

Um die Installation durchzuführen, benötigen Sie SSH- oder SFTP-Zugang zu Ihrem Webshop, einschließlich Ihres Benutzernamens, Passworts und Domainnamens.

Navigieren zum Ordner #

1. Melden Sie sich zu Beginn per Terminal auf Ihrem Magento-Server an, indem Sie Ihren Benutzernamen und Domain wie folgt verwenden:

ssh Stefan@mywebshop.com

2. Sie werden aufgefordert, das Passwort für Ihren Benutzer einzugeben (das Terminal gibt beim Tippen des Passworts kein Feedback, es wird jedoch trotzdem übernommen).

3. Navigieren Sie in den Root-Ordner von Magento. Oft geht das mit folgendem Befehl:

cd /var/www/html

und dazu:

ls

Das gibt Ihnen eine Liste von Ordnern, um den richtigen Ordner zu finden:

In der Ordnerliste suchen Sie nach dem passenden Ordner, in diesem Fall wäre es magento1.

Nun müssen Sie in diesen Ordner wechseln, das machen Sie mit:

cd NAME_FOLDER

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

Extension installieren #

1. Sobald Sie im Root-Ordner sind, laden Sie das Toolbox Script mit folgendem Befehl herunter:

sudo wget https://raw.githubusercontent.com/clerkio/clerk-magento/master/clerk_toolbox_magento.sh

2. Geben Sie anschließend diesen Befehl ein, um eine Liste der verfügbaren Optionen innerhalb des Toolbox Scripts anzuzeigen:

sh clerk_toolbox_magento.sh

3. Da Sie die Extension installieren möchten, verwenden Sie -i zusammen mit der gewünschten Version. Geben Sie folgendes ein, wobei x.x.x für die Version steht, die Sie installieren möchten:

sudo sh clerk_toolbox_magento.sh -i x.x.x

4. Sie werden nun aufgefordert, Ihr Passwort einzugeben. Nach Eingabe erstellt das Script ein Backup Ihres Magento1-Ordners und beginnt mit der Installation der Extension:

5. Fertig! Die Extension ist nun installiert und kann im Magento1-Backend konfiguriert werden.

Optionale Befehle #

Deinstallation Das Toolbox Script ermöglicht auch die Deinstallation der Extension. Dies können Sie mit folgendem Befehl tun:

sudo sh clerk_toolbox_magento.sh -u

In einigen Fällen, wenn Dateien beschädigt wurden oder fehlen, können Sie eine Force Uninstall wie folgt ausführen:

sudo sh clerk_toolbox_magento.sh -u --force

Wiederherstellung Falls etwas in Ihrem Webshop schiefläuft, können Sie jederzeit durch das erstellte Backup von der Extension-Installation wiederherstellen.

Verwenden Sie dazu diesen Befehl:

sudo sh clerk_toolbox_magento.sh -r

Backup Beim Installieren der Extension erstellt das Script immer zuerst ein Backup, Sie können ein Backup aber auch separat mit folgendem Befehl erstellen:

sudo sh clerk_toolbox_magento.sh -b

my.clerk.io Einstellungen #

Um die Synchronisationseinstellungen zwischen Clerk und Ihrer Magento 1 Extension zu konfigurieren, gehen Sie zu my.clerk.io, klicken Sie in der linken Menüleiste auf „Data“ und dann auf „Configuration“.

Hier finden Sie Optionen, wie Ihre Produkt-, Kunden- und Bestelldaten mit Clerk synchronisiert werden.

Weitere Informationen zur Magento 1 Extension sind unten über Ihr Magento 1 Admin-Portal zugänglich.

Bestellhistorie #

Hier legen Sie fest, wie viele Bestelldaten Sie rückwirkend von Ihrem Shop zu Clerk synchronisieren möchten.

Seitengröße #

Wählen Sie die Seitengröße der zu synchronisierenden Daten im Dropdown-Menü.

Kleinere Seitengrößen helfen bei der Vermeidung von Host-Zeitüberschreitungen während der Synchronisation, während größere Seitengrößen schneller synchronisieren können.

Server-Timeout #

Legen Sie fest, wie lange ohne Rückmeldung gewartet wird, bevor der Server in den Timeout geht, um Ihre Daten zu schützen und ausreichend Zeit für größere Datensätze zum Synchronisieren mit Clerk zu gewährleisten.

Standardwert sind 60 Sekunden.

Daten-Parsing #

Wählen Sie, ob Ihre Magento 1 Daten in diesem Bereich Werte automatisch parsen sollen.

Automatisches Parsing ist die Standard- und empfohlene Option.

Sync-Zeit #

Legen Sie die Tageszeit fest, wann Ihr Shop Ihre Daten mit Clerk synchronisieren soll.

Standardwert ist „bei Bedarf“.

Extension-Einstellungen #

Wenn Sie v4.8.0 oder eine neuere Version der Extension verwenden, können Sie nach Hinzufügen Ihrer Public- und Private Keys zu der Extension auf die folgenden Einstellungen auf zwei Wegen zugreifen:

• Über das Magento-Backend unter Clerk > Configuration > Settings

• Über my.clerk.io unter Developers > Extensions

Es spielt keine Rolle, wo Sie Änderungen vornehmen, denn die Extension synchronisiert Änderungen zwischen my.clerk.io und umgekehrt.

In my.clerk.io sehen Sie außerdem Ihre aktuelle Extension-Version, Ihre Plattform und die PHP-Version.

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

Extension-Übersicht #

Um auf Ihre Magento 1 Clerk Extension zuzugreifen, loggen Sie sich in Ihr Admin-Konto Ihres Shops ein und gehen zu „Configuration“ > „Clerk“ > „Settings“.

Clerk-Einstellungen #

Legen Sie wichtige Parameter im Abschnitt Clerk Settings der Magento 1 Extension fest.

Hier finden Sie auch die Möglichkeit, die Clerk Extension zu aktivieren/deaktivieren sowie Ihre öffentlichen und privaten API-Keys.

• Echtzeit-Updates:

  • Zusätzliche Felder

• Seiten einbeziehen

  • Zusätzliche Felder

• E-Mails und Warenkörbe der Kunden sammeln:

• Bestell-Sync deaktivieren:

• Nicht-vorrätige Produkte einbeziehen

• Sprache & Import-URL: Diese wurden vermutlich gesetzt, als Sie die Clerk-Extension installiert und mit my.clerk.io synchronisiert haben. Wenn sich diese Werte ändern, wählen Sie einfach die neue Shop-Sprache oder tragen Sie hier die aktualisierte Import-URL ein.

Search-Einstellungen #

Um Ihre Clerk Search Page, Search Page Facets und/oder Live Search zu aktivieren, wählen Sie im entsprechenden Dropdown „Yes“.

Search Page Settings:

• Nach Auswahl von „Yes“ erscheinen Optionen zur Eingabe Ihres Search Page Element-Namens, der dem data-template Feld im Embed-Code Ihres Elements in my.clerk.io entspricht. In diesem Beispiel: search-page.

• Sie können hier außerdem den Text für die „ Load More“-Schaltfläche sowie den Text zur Anzeige bei keinen Treffern eingeben.

Faceted Search Settings:

• Nach Aktivierung von Faceted Search haben Sie die Möglichkeit, die Attribute einzugeben, die als Facetten auf Ihrer Search Page erscheinen sollen.

Sie können diesen Facetten zudem eigene Bezeichnungen zuweisen und die Reihenfolge festlegen, in der die Facetten angezeigt werden.

Facetten anpassen #

Clerk ermöglicht Ihnen das Styling der Suchseiten-Facetten und die Anzeige durch Verweis über das Design-ID-Feld.

Die Design-ID finden Sie im Clerk Backend, in der ganz linken Spalte jeder Designübersicht sowie unten links auf der Seite, wenn Sie die Designbearbeitung aufrufen.

Hinweis: Sie können jetzt Daten zu Kategorien und Seiten auf Ihrer Search page analog zur Live search abrufen, um Ihren Kunden eine größere Informationsbasis zu bieten. Weitere Informationen finden Sie hier.

Live Search Settings

• Nach Aktivierung von Live Search können Sie festlegen, ob Categories in den Ergebnissen angezeigt werden und wie viele Vorschläge, Kategorien und Content-Ergebnisse innerhalb der Live Search angezeigt werden sollen.

  • Sie können außerdem bestimmen, welche Seitentypen als Suchergebnisse angezeigt werden (z.B. „CMS Pages“ oder „Blog Posts“).

  • Die Position des Live Search Dropdowns in Bezug auf Ihr Suchfeld können Sie über Dropdown Positioning festlegen.

• Geben Sie nun den Element-Namen für Ihre Live Search an, den Sie neben data-template in Ihrem Live Search Embed-Code im my.clerk.io Element finden. Dieser lautet meist live-search.

• Anschließend geben Sie Ihren Live Search Input Selector an, den Sie durch Überprüfung der Suchbox Ihres Webshops mit dem Browser und Identifikation von ID oder Klasse des Eingabefelds herausfinden. In diesem Beispiel: #search.

Recommendations-Einstellungen #

Aktivieren Sie wie bei Search Ihre Clerk Powerstep, Exit Intent, Category Page, Product Page und Cart Einstellungen durch Auswahl von „Yes“ im jeweiligen Dropdown-Menü.

Nach Auswahl von „Yes“ erhalten Sie ein Eingabefeld für den Element-Namen der Clerk Recommendations, die Sie auf dieser Seite integrieren möchten.

• Wie bei den Such-Funktionen finden Sie den Element-Namen neben data-template im Embed-Code über my.clerk.io > Recommendations > Elements. Im Beispiel haben wir Category Page aktiviert und den Element-Namen category-page-popular gewählt.

• Sie können auch mehrere Element-Namen als kommaseparierte Werte eingeben, wenn Sie auf einer Seite mehrere Elemente anzeigen möchten.

Logging #

Die Logging-Einstellungen umfassen:

Logging Level

• Nur Fehler: Protokolliert Fehler, die das Modul am korrekten Betrieb hindern.

• Fehler + Warnungen: Protokolliert auch Warnungen, die das Modul nicht stoppen, aber behoben werden sollten.

• Fehler + Warnungen + Debug: Protokolliert alles, womit das Modul interagiert. Dies sollte nicht in einem Live-Webshop aktiviert werden, da dies die Seite verlangsamt.

Logging wohin

• Datei: Speichert das Log auf dem Magento-Server.

• my.clerk.io: Protokolliert alles unter Developers->Logs im my.clerk.io Backend.

Übersetzen von Texten #

Die Clerk for Magento Extension wird bereits mit Übersetzungen für dänisch, englisch, niederländisch und italienisch ausgeliefert.

Sie können ganz einfach eine Übersetzung für Ihre Sprache hinzufügen, sodass die Frontend-Elemente korrekt angezeigt werden.

Gehen Sie dazu in diesem FTP-Ordner wie folgt vor:

app->locale

Gehen Sie zunächst in den dänischen Ordner da_DA und kopieren Sie die Datei Clerk_Clerk.csv.

Suchen Sie den Ordner für Ihre Sprache (im Magento locale Verzeichnis) und fügen Sie die Datei hier ein.

Jetzt können Sie die Texte für Ihre Sprache in der rechten Spalte der CSV-Datei übersetzen:

Upgrade #

Diese Anleitung zeigt Ihnen, wie Sie von früheren Versionen unserer Extension auf die neueste Version upgraden.

Sie können die aktuellste Extension von diesem Link herunterladen:

https://github.com/clerkio/clerk-magento/releases/latest

Änderungen speichern #

Bevor Sie ein Upgrade durchführen, stellen Sie sicher, dass Sie entweder:

• Die geänderten Dateien lokal in Ihrem FTP gesichert haben oder

• Ein Backup jeder geänderten Datei erstellt haben, das Sie in die neue Extension übernehmen können.

In der Regel werden folgende Dateien am häufigsten angepasst: Product.php und Productbase.php, welche Produktattribute steuern.

Diese Dateien finden Sie hier:

app->code->community->Clerk->Clerk->Model->Catalog->Product.php

app->code->community->Clerk->Clerk->Model->Catalog->Productbase.php

Deaktivieren und deinstallieren #

Bevor Sie versuchen, ein Upgrade durchzuführen, ist Folgendes sehr wichtig:

1. Deaktivieren Sie die alte Extension auf der Seite System->Configuration->Clerk->Settings in Magento. Setzen Sie einfach Enable auf No und klicken Sie auf Save Config.

2. Anschließend deinstallieren Sie diese entweder über Magento Connect oder durch Löschen der Dateien aus dem FTP, wenn Sie sie direkt hier installiert haben.

Sonst funktioniert Ihre Configuration Seite möglicherweise nicht mehr, und keine Extension wird danach funktionieren.

Neueste Version installieren #

Installieren Sie dann erneut die neueste Extension und übertragen Sie alle gesicherten Dateien auf Ihren FTP-Server.

Ihre Konfiguration sollte auch nach Installation der neuen Version erhalten bleiben.

Prüfen Sie System->Configuration->Clerk, um sicherzustellen, dass noch alles vorhanden ist.

Jetzt läuft die neueste Version von Clerk für Magento!

Deinstallation #

Um Clerk aus Ihrem Magento 1 Store zu entfernen, müssen Sie die Extension im Magento 1 Admin-Portal deaktivieren.

Loggen Sie sich ins Admin-Portal Ihres Shops ein und wählen Sie dann im oberen Menü „ System“ > „ Configuration“.

Auf der nächsten Seite finden Sie „ Clerk“ im linken Menü und wählen „ Settings“.

Hier erscheint „Clerk Settings“. Wählen Sie neben „ Enable“ im Dropdown-Menü „ No“, um die Clerk Extension zu deaktivieren.

Wenn Sie Clerk mit der Extension implementiert haben, können Sie auch die einzelnen Module deaktivieren, indem Sie ebenso „No“ in den entsprechenden Search und Recommendations Dropdowns auswählen:

Haben Sie Clerk-Elemente direkt über Ihre FTP-Dateien eingebunden, stellen Sie sicher, dass Sie die entsprechenden Embed Codes aus diesen Dateien entfernen.