Sync Data

Deaktivieren der Bestellsynchronisierung #

Nachdem die erste Datensynchronisierung erfolgreich durchgeführt wurde, kann die Bestellsynchronisierung von Magento1 deaktiviert werden, da das Verkaufs-Tracking von der Erweiterung übernommen wird.

Um die Bestellsynchronisierung zu deaktivieren, gehen Sie in Ihr Magento1-Backend, wählen Sie SYSTEM in der Menüleiste und drücken Sie KONFIGURATION:

Wählen Sie die Hauptseite (die Seite, die Sie beeinflussen möchten) unter AKTUELLER KONFIGURATIONSGELTUNGSBEREICH:

Klicken Sie dann auf EINSTELLUNGEN unter dem CLERK-Tab in der linken Seitenleiste und ändern Sie das Feld neben BESTELLSYNCHRONISIERUNG DEAKTIVIEREN von NEIN auf JA. Drücken Sie KONFIGURATION SPEICHERN, um die Änderungen sofort wirksam zu machen:

Ändern der Produktbildgrößen #

Standardmäßig ruft die Clerk.io Erweiterung für Magento Bilder mit einer Größe von 210x210 px ab.

Dies kann in der folgenden Datei geändert werden:

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

Im oberen Teil dieser Datei steuern die Variablen $imageHeight und $imageWidth die Höhe und Breite jedes Bildes:

Ändern Sie diese Werte auf die Größe, die Sie für die Bilder wünschen, und speichern Sie die Datei.

Gehen Sie dann zu my.clerk.io -> Daten-Synchronisierung und führen Sie eine neue Synchronisierung durch, indem Sie auf Synchronisierung starten klicken.

Ihre neuen Bilder werden nun synchronisiert.

Auswahl der zu importierenden Produkte #

Anzeige von nicht vorrätigen Produkten #

Wenn Sie auch Produkte anzeigen möchten, die nicht vorrätig sind, in Ihren Clerk.io Ergebnissen, können Sie dies ganz einfach im Magento-Backend steuern.

Beginnen Sie damit, zu gehen zu:

System -> Konfiguration -> CLERK -> Einstellungen

Wählen Sie Ihre Store-Ansicht aus dem linken Menü und gehen Sie zu den Clerk-Einstellungen.

Hier setzen Sie Nicht vorrätige Produkte einbeziehen auf Ja und klicken Sie auf Konfiguration speichern:

Gehen Sie schließlich zu my.clerk.io -> Daten und klicken Sie auf Neue Daten-Synchronisierung starten, um alle Produkte zu importieren, einschließlich der nicht vorrätigen.

Erweiterte Änderungen #

In Magento steuert die folgende Datei, welche Produkte in Clerk.io importiert werden:

app->code->community->Clerk->Clerk->Model->Productpage.php

Die Funktion load($page,$limit) ist verantwortlich für die Steuerung der Sammlung von Produkten, die an Clerk.io gesendet werden. Standardmäßig werden nur Produkte mit Sichtbarkeit: beide (Katalog, Suche), die auch vorrätig sind, importiert.

Dies kann an den folgenden zwei Stellen geändert werden:

Wenn Sie die von Clerk.io importierten Produkte ändern, empfehlen wir dringend, dass Sie auch ein zusätzliches Attribut hinzufügen, das angibt, wann ein Produkt nicht verkäuflich oder sichtbar ist, damit Sie es in Ihrem Design anzeigen und darauf filtern können.

Angenommen, Sie erstellen ein Attribut namens is_saleable, das entweder true oder false ist, können Sie es so in Designs verwenden:

{% if product.is_saleable %}
   <div class="in-stock">Auf Lager</div>
{% else %}
  <div class="not-in-stock">Nicht auf Lager</div>
{% endif %}

Gehen Sie schließlich zu my.clerk.io -> Daten und klicken Sie auf Neue Daten-Synchronisierung starten, um Ihre neuen Daten zu importieren.

Anpassen von Produktdaten #

In Magento 1 können Sie benutzerdefinierte Produktattribute über das Magento-Backend oder über die Clerk.io Erweiterung im Code hinzufügen, falls erforderlich.

Hinzufügen einfacher Attribute #

Hinweis: Diese Funktion funktioniert nur ab v.4.2.3.

Wenn die Attribute, die Sie senden möchten, bereits als einfache Attribute in Ihrem Magento-Admin verfügbar sind, können sie ganz einfach auf der Erweiterungsseite hinzugefügt werden.

1. Gehen Sie in Ihr Magento-Backend und starten Sie mit Katalog -> Attribute -> Attribute verwalten

2. Finden Sie die Attributcodes der Attribute, die Sie hinzufügen möchten:

3. Gehen Sie zu System -> Konfiguration

4. Unter Clerk -> Einstellungen geben Sie Ihre Attribute in Zusätzliche Felder ein und klicken Sie auf Konfiguration speichern:

5. Nachdem Sie Ihre Attribute implementiert haben, gehen Sie zu my.clerk.io->Daten und klicken Sie auf Neue Daten-Synchronisierung starten in der oberen rechten Ecke.

Wenn die Attribute, die Sie senden möchten, bereits als Teil Ihrer konfigurierbaren/gruppierten Produktdaten in Ihrem Magento-Admin verfügbar sind, können sie ganz einfach in der neuesten Version Ihres Plugins synchronisiert werden. Sie erscheinen als child_attribute, zum Beispiel child_color, child_skus usw.

Hinzufügen von Attributen über Code #

Wenn Ihr Attribut eine Standard-Magento-Funktion verwendet, kann dies direkt in Product.php implementiert werden:

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

Die Funktion getClerkExportData() erstellt das Produktobjekt mit allen Attributen:

Sie können dann neue Attribute in der Liste mit dieser Syntax hinzufügen:

$data->setAttributeName($this->insertMagentoLogic());

wobei setAttributeName den Namen definiert, den Sie in Clerk.io haben möchten, und insertMagentoLogic(); eine Magento-Logik verwendet, um einen Wert aus dem Produkt abzurufen.

Verwendung benutzerdefinierter Attributfunktionen #

Manchmal kann ein Magento-Attribut eine fortgeschrittenere Logik erfordern als eine einfache Funktion. In diesem Fall lokalisieren Sie diese Datei:

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

In Productbase.php können Sie fortgeschrittene PHP-Funktionen schreiben, um benutzerdefinierte Attribute zu laden.

Nachdem Sie eine Funktion definiert haben, können Sie sie in Product.php genau wie die vorhandenen Funktionen einfügen.

Zum Beispiel:

$data->setAge($this->getAge());

Nachdem Sie Ihre Attribute implementiert haben, gehen Sie zu my.clerk.io->Daten und klicken Sie auf Neue Daten-Synchronisierung starten in der oberen rechten Ecke.

Ändern der Erweiterung #

Hinzufügen/Ändern von Produktdaten #

Falls Sie zusätzliche Attribute hinzufügen oder vorhandene für Ihre Produkte ändern möchten, sollten Sie diese Dateien finden:

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

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

Product.php erstellt das Produktmodell und ermöglicht es Ihnen, einfache Attribute hinzuzufügen.

Productpage.php ermöglicht es Ihnen, erweiterte Logiken zum Abrufen von Attributen zu erstellen und sie in Product.php zu verwenden.

Ändern von Kategoriedaten #

Vielleicht müssen Sie die Kategorienamen umstrukturieren oder bestimmte Kategorien von Clerk.io entfernen.

In diesen Fällen finden Sie diese Datei:

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

Diese Datei behandelt, welche Kategorien enthalten sind, sowie die Daten id, name, URL und Unterkategorien für jede Kategorie.

Sie können keine zusätzlichen Daten zu jeder Kategorie hinzufügen, aber Sie können ändern, was gesendet wird.

Styling des Hinzufügen-zum-Warenkorb-Schrittes (Powerstep) #

Der Powerstep hat ein Standardstyling, aber Sie möchten es möglicherweise ändern, um es an Ihre Designs anzupassen.

Diese Dateien werden für das Styling verwendet:

app->design->frontend->base->default->template->clerk->powerpage.phtml

app->design->frontend->base->default->template->clerk->powerpopup.phtml

skin->frontend->base->default->clerk->style.css

powerpage.phtml enthält das HTML für die Seite, während powerpopup.phtml für das Popup ist.

style.css enthält das CSS für alle Teile der Clerk.io Erweiterung, einschließlich des Powersteps.

Sie können diese Dateien verwenden, um das Aussehen des Powersteps zu ändern.

Ändern der Suchseite #

Wenn Sie das Layout der Suchseite ändern möchten, einen Slider zur Seite ohne Ergebnisse hinzufügen usw., müssen Sie diese Datei finden:

app->design->frontend->base->default->template->clerk->powerpage.phtml

Dies ermöglicht es Ihnen, den Such-Embed-Code und andere Teile der Suchseite zu ändern.

Ändern von Titeln für Produkte und Kategorien in der Live-Suche #

Die in der Live-Suche für Produkte und Kategorien angezeigten Titel können in dieser Datei geändert werden:

app->design->frontend->base->default->template->clerk->livesearch.phtml

Hier übersetzen Sie einfach Kategorien und Produkte in das, was Sie möchten:

Gruppierte Produkte als Varianten #

Standardmäßig verwendet Magento konfigurierbare Produkte, um Hauptprodukte und Varianten zu verwalten. Die Clerk.io Erweiterung wurde entwickelt, um dies zu unterstützen, da es die beste Praxis für Magento ist.

Wenn Sie jedoch Ihre Varianten mit gruppierten Produkten eingerichtet haben, funktioniert Ihr Verkaufs-Tracking nicht, da Sie die IDs von Produkten verfolgen, die Clerk.io nicht aus Ihrem Magento-Webshop importiert hat. Dies liegt daran, dass Varianten normalerweise nicht sichtbar sind.

Clerk.io wird keine Verbindungen zwischen Produkten sehen können, wenn sie nicht importiert werden:

Für Clerk.io spielt es normalerweise keine Rolle, welche Variante gekauft wird, solange das " Haupt" Produkt, zu dem sie gehört, verfolgt wird.

Um dies zu beheben, müssen Sie 2 Dateien in der Erweiterung ändern, um sie an Ihre Einrichtung anzupassen.

Das Verkaufs-Tracking #

Die Datei, die die Verkaufs-Tracking-Daten generiert, ist diese:

app->code->Block->SalesTracking.php

In dieser Datei wird normalerweise um Zeile 65 der folgende Code verwendet, um die ID des gekauften Produkts zu erhalten:

Dies muss geändert werden, sodass unabhängig davon, welche gruppierte Produktvariante gekauft wurde, immer die ID des “Haupt” Produkts gesendet wird.

Die importierten Bestellungen #

Der gleiche Prozess muss für die vorherigen Bestellungen durchgeführt werden, die importiert werden, damit wir wissen, welche “Haupt” Produkte zuvor gekauft wurden.

Diese Datei behandelt es:

app->code->Model->Orderpage.php

Um Zeile 44 wird in der Funktion orderFormatter($order) die ID des Produkts von Magento gesendet:

Ändern Sie dies auf die gleiche Logik wie das Verkaufs-Tracking.

Überprüfen, ob Ihre Änderungen funktionieren #

Gehen Sie nun zu my.clerk.io -> Daten und klicken Sie auf Neue Daten-Synchronisierung starten, um die neuesten Daten zu importieren:

Fahren Sie fort, um eine Testbestellung aufzugeben, bei der Sie ein Produkt mit Varianten kaufen.

Gehen Sie danach zu Verfolgte Bestellungen und überprüfen Sie die Bestellung, die Sie gerade aufgegeben haben. Wenn Sie die Haupt Produkte in der Bestellung sehen können, einschließlich ihres Namens und Bildes, funktioniert Ihr Code: