Sync Data

Deaktivieren der Bestell-Synchronisierung #

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

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

Wählen Sie die Hauptseite (die Seite, die Sie beeinflussen möchten) unter CURRENT CONFIGURATION SCOPE:

Klicken Sie dann auf SETTINGS unter dem CLERK-Tab in der linken Seitenleiste und ändern Sie das Feld neben DISABLE ORDER SYNCHRONIZATION von NO auf YES. Drücken Sie SAVE CONFIG, um die Änderungen sofort wirksam werden zu lassen:

Ä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 -> Data Sync und führen Sie eine neue Synchronisierung durch, indem Sie auf Start Sync klicken.

Ihre neuen Bilder werden jetzt 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, indem Sie zu gehen:

System -> Configuration -> CLERK -> Settings

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

Hier setzen Sie Include Out Of Stock Products auf Yes und klicken Sie auf Save Config:

Gehen Sie schließlich zu my.clerk.io -> Data und klicken Sie auf Start New Data Sync, um alle Produkte, einschließlich der nicht vorrätigen, zu importieren.

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 dafür verantwortlich, die Kollektion von Produkten zu steuern, 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 in Designs wie folgt 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 -> Data und klicken Sie auf Start New Data Sync, 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 beginnen Sie mit Catalog -> Attributes -> Manage Attributes

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

3. Gehen Sie zu System -> Configuration

4. Unter Clerk -> Settings geben Sie Ihre Attribute in Additional Fields ein und klicken Sie auf Save Config:

5. Nachdem Sie Ihre Attribute implementiert haben, gehen Sie zu my.clerk.io->Data und klicken Sie auf Start New Data Sync 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 in der neuesten Version Ihres Plugins ganz einfach 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 komplexere 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 erweiterte PHP-Funktionen schreiben, um benutzerdefinierte Attribute zu laden.

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

Zum Beispiel:

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

Nachdem Sie Ihre Attribute implementiert haben, gehen Sie zu my.clerk.io->Data und klicken Sie auf Start New Data Sync in der oberen rechten Ecke.

Modifizieren 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 diese 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 einbezogen werden, und 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 Warenkorb-Schrittes (Powerstep) #

Der Powerstep hat ein Standard-Design, aber Sie möchten es möglicherweise an Ihre Designs anpassen.

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.

Modifizieren 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-Embedcode und andere Teile der Suchseite zu ändern.

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

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

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

Hier übersetzen Sie einfach Categories und Products 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 kann keine Verbindungen zwischen Produkten sehen, wenn sie nicht importiert sind:

Für Clerk.io spielt es normalerweise keine Rolle, welche Variante gekauft wird, solange das " Haupt" Produkt, zu dem es 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 -> Data und klicken Sie auf Start New Data Sync, um die neuesten Daten zu importieren:

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

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: