Extension

Konfigurieren Sie Ihre Magento 1 Extension-Einstellungen, verwalten Sie Optionen zur Datensynchronisierung und passen Sie Such-, Recommendations- und Protokollierungsfunktionen an. Diese Anleitung behandelt außerdem die Installation über das Toolbox Script, ein 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 über ein Terminal ausgeführt.

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

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

Was Sie benötigen #

Um es zu installieren, benötigen Sie SSH- oder SFTP-Zugang zu Ihrem Webshop, einschließlich Ihres Benutzernamens, Passworts und Domain.

Navigieren zum Ordner #

1. Melden Sie sich zunächst über ein Terminal bei 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 dennoch registriert).

3. Navigieren Sie zum Root-Ordner von Magento. Oft können Sie dies tun, indem Sie eingeben:

cd /var/www/html

und weiter mit:

ls

Dies gibt Ihnen eine Liste von Ordnern, um Ihnen beim Auffinden des richtigen zu helfen:

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

Nun müssen Sie in diesen Ordner wechseln. Das gelingt mit:

cd NAME_FOLDER

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

Extension installieren #

1. Sobald Sie sich im Root-Ordner befinden, müssen Sie das Toolbox Script mit folgendem Befehl herunterladen:

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

2. Danach geben Sie diese Zeile ein, um eine Liste der verfügbaren Optionen im Toolbox Script einzusehen:

sh clerk_toolbox_magento.sh

3. Da Sie die Extension installieren möchten, verwenden Sie -i zusammen mit der gewünschten Version. Geben Sie diese Zeile ein, wobei x.x.x durch die gewünschte Version ersetzt wird:

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

4. Sie werden nun aufgefordert, Ihr Passwort einzugeben. Nach der Eingabe sichert das Script Ihren Magento1-Ordner und beginnt mit der Installation der Extension:

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

Optionale Befehle #

Deinstallation Das Toolbox Script ermöglicht auch die Deinstallation der Extension. Das geht mit dieser Zeile:

sudo sh clerk_toolbox_magento.sh -u

Falls Dateien beschädigt wurden oder fehlen, können Sie auch eine Deinstallation erzwingen:

sudo sh clerk_toolbox_magento.sh -u --force

Wiederherstellung Falls in Ihrem Webshop etwas schiefgeht, können Sie ihn dank des Backups wiederherstellen, das bei der Installation der Extension angelegt wurde.

Folgende Zeile wird dafür verwendet:

sudo sh clerk_toolbox_magento.sh -r

Backup Bei der Installation der Extension wird durch das Script immer zuerst ein Backup erstellt, Sie können jedoch auch separat ein Backup erstellen:

sudo sh clerk_toolbox_magento.sh -b

my.clerk.io Einstellungen #

Um auf Ihre Synchronisationseinstellungen zwischen Clerk und Ihrer Magento 1 Extension zuzugreifen, gehen Sie zu my.clerk.io, klicken Sie im linken Menü auf „Data“ und dann auf „Configuration“.

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

Weitere Informationen zur Magento 1 Extension, die Sie über Ihr Magento 1 Admin-Portal erreichen, finden Sie unten.

Bestellhistorie #

Wählen Sie hier aus, für welchen Zeitraum Sie Bestelldaten nachträglich aus Ihrem Shop zu Clerk synchronisieren möchten.

Seitengröße #

Wählen Sie die Seitengröße Ihrer synchronisierten Daten im unten stehenden Dropdown-Menü.

Kleinere Seitengrößen können helfen, Host-Timeouts während der Synchronisation zu vermeiden, während größere Seitengrößen schneller synchronisieren können.

Server Timeout #

Legen Sie fest, wie lange ohne Antwort gewartet wird, bevor der Server ein Timeout auslöst – zum Schutz Ihrer Daten und um sicherzustellen, dass für größere Datensätze genügend Zeit für die Synchronisation mit Clerk zur Verfügung steht.

Standardwert ist 60 Sekunden.

Daten-Parsing #

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

Das automatische Parsen ist Standard und wird empfohlen.

Synchronisationszeit #

Legen Sie fest, zu welcher Tageszeit Ihre Shop-Daten mit Clerk synchronisiert werden sollen.

Standard ist „bei Bedarf“.

Extension Einstellungen #

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

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

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

Es ist egal, wo Sie Änderungen vornehmen, denn die Extension synchronisiert sich mit allen Änderungen aus my.clerk.io und umgekehrt.

In my.clerk.io sehen Sie außerdem Ihre aktuell installierte Version der Extension, Ihr Plattform sowie die PHP-Version.

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

Extension-Übersicht #

Um auf Ihre Magento 1 Clerk Extension zuzugreifen, melden Sie sich im Admin-Konto Ihres Shops an und wählen Sie “Configuration” > “Clerk” > “Settings”.

Clerk Einstellungen #

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

Hier können Sie auch die Extension aktivieren/deaktivieren sowie Ihre Public und Private API Keys hinterlegen.

• Echtzeitaktualisierungen:

  • Zusätzliche Felder

• Seiten einbeziehen

  • Zusätzliche Felder

• E-Mails und Kundenkörbe erfassen:

• Bestell-Synchronisierung deaktivieren:

• Ausverkaufte Produkte einbeziehen

• Sprache & Import-URL: Diese wurden wahrscheinlich bei der ersten Installation der Clerk Extension gesetzt und mit my.clerk.io synchronisiert. Falls sich diese Werte ändern, wählen Sie einfach die neue Shop-Sprache oder geben 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 passenden Dropdown „Yes“ aus.

Search Page Settings:

• Nach Auswahl von „Yes“ erscheinen Optionen, um den Namen Ihres Search Page Elements einzugeben. Dieser entspricht dem data-template-Feld im Embed-Code Ihres Elements in my.clerk.io. In diesem Beispiel: search-page.

• Hier können Sie außerdem den Text für den “Load More"-Button sowie den Text für den Fall einstellen, dass keine Ergebnisse für eine Anfrage gefunden werden.

Faceted Search Settings:

• Nach Aktivierung der Facetten-Suche können Sie die Attribute angeben, die als Facetten auf Ihrer Search Page erscheinen sollen.

Sie können diese Facetten beschriften und die Reihenfolge festlegen, in der jede Facette angezeigt wird.

Facetten anpassen #

Mit Clerk können Sie die Facetten Ihrer Search Page im Design anpassen und diese durch Referenzierung über das Design-ID-Feld anzeigen.

Die Design-ID finden Sie im Clerk Backend, in der ganz linken Spalte jedes Designs auf der Design-Übersichtsseite sowie unten links auf der Seite, sobald Sie das Design zum Bearbeiten aufrufen.

Hinweis: Sie können jetzt die Daten für Kategorien und Seiten in Ihrer Search Page genauso abrufen wie in Ihrer Live Search und so Ihren Kunden ein breiteres Spektrum an Informationen bieten. Mehr Informationen finden Sie hier.

Live Search Einstellungen

• Nach Aktivierung der Live Search können Sie auswählen, ob Categories in den Ergebnissen erscheinen sollen sowie die Anzahl der Such-Vorschläge, Kategorien und Content-Ergebnisse, die in der Live Search angezeigt werden sollen.

  • Sie haben auch die Möglichkeit, auszuwählen, welche Seitentypen als Suchergebnisse angezeigt werden, z.B. „CMS Pages“ oder „Blog Posts“.

  • Die Position des Live-Search-Dropdowns können Sie mit Dropdown Positioning festlegen.

• Geben Sie als Nächstes den Elementnamen für Ihre Live Search an, den Sie im Embed-Code Ihrer Live Search in Ihrem my.clerk.io Element neben data-template finden. Vermutlich ist das live-search.

• Zum Schluss geben Sie Ihren Live Search Input Selector an, den Sie finden, indem Sie mit Ihrem Browser die Suchbox Ihres Webshops untersuchen und die zugehörige ID oder Klasse identifizieren. In diesem Beispiel: #search.

Recommendations Einstellungen #

Wie bei Search aktivieren Sie die Clerk Powerstep, Exit Intent, Category Page, Product Page und Cart-Einstellungen, indem Sie „Yes“ im entsprechenden Dropdown auswählen.

Nach Auswahl von „Yes“ erscheint ein Feld, in das Sie den Elementnamen für die Recommendations von Clerk eintragen, die Sie auf dieser Seite einbinden möchten.

• Wie bei den Search-Funktionen finden Sie den Elementnamen neben data-template im Embed-Code innerhalb von my.clerk.io > Recommendations > Elements. In diesem Beispiel haben wir die Category Page Einstellungen aktiviert und category-page-popular als Element angegeben.

• Sie können an dieser Stelle auch mehrere Elementnamen als kommagetrennte Werte angeben, falls mehrere Elemente auf der Seite angezeigt werden sollen.

Protokollierung (Logging) #

Die Logging-Einstellungen umfassen:

Logging Level

• Nur Fehler: Protokolliert Fehler, die die korrekte Funktionsweise des Moduls verhindern.

• Fehler + Warnungen: Protokolliert zusätzlich Warnungen, die das Modul nicht zum Stoppen bringen, aber möglicherweise dennoch zu beheben sind.

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

Protokollierung nach

• Datei: Speichert das Protokoll als Datei auf dem Magento-Server.

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

Übersetzen von Texten #

Die Clerk für Magento Extension enthält standardmäßig Übersetzungen für Dänisch, Englisch, Niederländisch und Italienisch.

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

Dazu gehen Sie wie folgt in diesen Ordner im FTP:

app->locale

Gehen Sie 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-Ordner) und fügen Sie die Datei dort ein.

Nun können Sie die Texte auf Ihrer Sprache übersetzen, auf der rechten Seite der CSV-Datei:

Upgrade #

Diese Anleitung zeigt Ihnen, wie Sie von einer älteren Version unserer Extension auf die neueste upgraden.

Sie können die neueste Extension unter folgendem Link herunterladen:

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

Änderungen speichern #

Bevor Sie ein Upgrade versuchen, stellen Sie sicher, dass Sie entweder:

• Die geänderten Dateien lokal auf Ihrem FTP gespeichert haben, oder

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

Meistens sind die Dateien, die am häufigsten geändert werden, Product.php und Productbase.php, welche die 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 #

Vor dem Upgrade 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. Danach deinstallieren Sie sie entweder über Magento Connect oder indem Sie die Dateien direkt vom FTP löschen, falls Sie sie dort installiert haben.

Andernfalls könnte Ihre Configuration-Seite nicht mehr funktionieren und beide Extensions nicht mehr einsatzfähig sein.

Neueste Version installieren #

Zum Schluss installieren Sie die neueste Extension erneut und übertragen alle gesicherten Dateien auf Ihren FTP-Server.

Ihre Konfiguration sollte erhalten bleiben, auch wenn Sie die neue Version installieren.

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

Nun haben Sie die neueste Version von Clerk für Magento installiert!

Deinstallation #

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

Melden Sie sich im Magento 1 Portal Ihres Webshops an und wählen Sie dann „System“ > „Configuration“ im oberen Menü.

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

Hier erscheint „Clerk Settings“. Wählen Sie neben „Enable“ im Dropdown-Menü „No“, damit die Clerk Extension nicht mehr aktiviert ist.

Wenn Sie Clerk über die Extension implementiert haben, können Sie auch die einzelnen Module deaktivieren, indem Sie in diesem Abschnitt in den entsprechenden Search- und Recommendations-Dropdowns ebenfalls „No“ wählen:

Wenn Sie Teile von Clerk direkt über Ihre FTP-Dateien installiert haben, entfernen Sie bitte die entsprechenden Embed-Codes aus diesen Dateien.