Magento 1

Sync Data

Zusätzliche Produktattribute zu Clerk durch die Magento Extension hinzufügen

Synchronisieren Sie Ihre Magento 1 Produkte, Attribute und Bestelldaten mit Clerk. Diese Anleitung deckt das Anpassen von Produktdaten, das Auswählen, welche Produkte importiert werden sollen, das Ändern von Bildgrößen und das Verwalten der Auftragsynchronisierung.

Auftragsynchronisierung deaktivieren #

Nachdem die erste Datensynchronisierung erfolgreich durchgeführt wurde, kann die Auftragsynchronisierung von Magento1 deaktiviert werden, da die Verkaufsverfolgung durch die Erweiterung übernommen wird.

Um die Auftragsynchronisierung zu deaktivieren, wechseln Sie in das Magento1- Backend, wählen SYSTEM in der Menüleiste und klicken Sie CONFIGURATION:

System configuration

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

Current configuration scope

Dann klicken Sie unter dem CLERK-Tab im linken Seitenbereich auf SETTINGS und ändern Sie anschließend das Feld neben DISABLE ORDER SYNCHRONIZATION von NO zu YES.

Klicken Sie SAVE CONFIG, damit die Änderungen sofort wirksam werden:

Disable order synchronization

Ändern der Bildgrößen #

Standardmäßig holt die Clerk-Erweiterung für Magento Bilder in der Größe 210x210 px.

Dies kann in der folgenden Datei geändert werden:

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

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

Image size variables

Ändern Sie diese Werte auf die gewünschte Bildgröße und speichern Sie die Datei.

Dann gehen Sie zu my.clerk.io -> Data Sync und führen Sie eine neue Synchronisierung durch, indem Sie Start Sync anklicken.

Ihre neuen Bilder werden jetzt synchronisiert.

Auswählen der Produkte zum Import #

Anzeigen nicht vorrätiger Produkte #

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

Gehen Sie zunächst zu:

System -> Configuration -> CLERK -> Settings

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

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

Include out of stock products

Gehen Sie schließlich zu my.clerk.io -> Data und klicken Sie Start New Data Sync, um alle Produkte zu importieren, einschließlich derjenigen, die nicht vorrätig sind.

Erweiterte Änderungen #

In Magento steuert die folgende Datei, welche Produkte zu Clerk importiert werden:

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

Die Funktion load($page,$limit) ist dafür verantwortlich, die Sammlung von Produkten zu steuern, die an Clerk gesendet wird.

Standardmäßig werden nur Produkte mit Sichtbarkeit: beides (Catalog, Search), die auch vorrätig sind, importiert.

Dies kann an zwei folgenden Stellen geändert werden:

Product collection function

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

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

{% if product.is_saleable %}
   <div class="in-stock">In Stock</div>
{% else %}
  <div class="not-in-stock">Not In Stock</div>
{% endif %}

Zuletzt gehen Sie zu my.clerk.io -> Data und klicken Sie Start New Data Sync, um Ihre neuen Daten zu importieren.

Start new data sync

Anpassen von Produktdaten #

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

Hinzufügen einfacher Attribute #

Hinweis: Dieses Feature funktioniert nur ab Version v.4.2.3.

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

  1. Öffnen Sie im Magento-Backend zuerst Catalog -> Attributes -> Manage Attributes

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

Manage attributes page
  1. Gehen Sie zu System -> Configuration
System configuration
  1. Unter Clerk -> Settings tragen Sie Ihre Attribute in Additional Fields ein und klicken Sie Save Config:
Additional fields
  1. Nachdem Sie Ihre Attribute implementiert haben, gehen Sie zu my.clerk.io->Data und klicken Sie oben rechts auf Start New Data Sync in der oberen rechten Ecke.
Start new data sync

Wenn die Attribute, die Sie senden möchten, bereits als Teil Ihrer konfigurierbaren/ gruppierten Produktdaten im Magento-Admin verfügbar sind, können sie einfach mit der neuesten Version Ihres Plug-ins synchronisiert werden.

Sie erscheinen als child_attribute, zum Beispiel child_color, child_skus usw.

Child attributes

Attribute über Code hinzufügen #

Wenn Ihr Attribut eine Standard-Magento-Funktion verwendet, lässt es sich direkt in Product.php: implementieren.

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

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

Get clerk export data function

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

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

wobei setAttributeName den Namen definiert, den es in Clerk haben soll, und insertMagentoLogic(); eine Magento-Logik verwendet, um einen Wert aus dem Produkt abzurufen.

Verwendung von benutzerdefinierten Attributfunktionen #

Manchmal erfordert ein Magento-Attribut eine fortgeschrittenere Logik als eine einfache Funktion.

In diesem Fall finden 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.

Productbase.php file

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

Zum Beispiel:

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

Nach der Implementierung Ihrer Attribute gehen Sie zu my.clerk.io->Data und klicken Sie oben rechts auf Start New Data Sync.

Start new data sync

Erweiterung ändern #

Hinzufügen/Ändern von Produktdaten #

Falls Sie zusätzliche Attribute hinzufügen oder bestehende ändern möchten, finden Sie diese Dateien:

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

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

Product.php erstellt das Produktmodell und erlaubt das Hinzufügen von einfachen Attributen.

Productpage.php ermöglicht das Erstellen von fortgeschrittenen Logiken zum Abrufen von Attributen und deren Verwendung in Product.php.

Product and productpage files

Ändern der Kategoriedaten #

Vielleicht müssen Sie Kategorienamen neu ordnen oder bestimmte Kategorien aus Clerk entfernen.

In diesen Fällen finden Sie diese Datei:

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

Diese Datei regelt, welche Kategorien eingeschlossen 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.

Category data handling

Styling des Powersteps #

Der Powerstep hat ein Standard-Styling, 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-Erweiterung, einschließlich des Powersteps.

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

Powerstep styling files

Änderung der Search Page #

Wenn Sie das Layout der Search Page ändern möchten, z. B. einen Slider auf der No-Results-Seite hinzufügen, müssen Sie diese Datei finden:

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

Dies ermöglicht es Ihnen, den Embedcode der Suche zu ändern und andere Teile der Suchseite.

Search page template

Live-Suche-Titel ändern #

Die Titel, die in der Live-Search 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:

Live search template

Gruppierte Produkte als Varianten #

Standardmäßig verwendet Magento Configurable Products, um Hauptprodukte und Varianten zu handhaben.

Die Clerk-Erweiterung wurde so entwickelt, dass sie dies unterstützt, da es die Best Practice für Magento ist.

Wenn Sie jedoch Ihre Varianten mithilfe von Grouped Products eingerichtet haben, funktioniert Ihre Verkaufsverfolgung nicht, da Sie IDs von Produkten nachverfolgen, die Clerk nicht aus Ihrem Magento-Webshop importiert hat.

Dies liegt daran, dass Varianten in der Regel nicht sichtbar sind.

Clerk kann keine Verbindungen zwischen Produkten sehen, wenn sie nicht importiert werden:

Grouped products issue

Für Clerk ist es normalerweise egal welche Variante gekauft wird, solange das dazugehörige Hauptprodukt nachverfolgt wird.

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

Die Verkaufsverfolgung #

Die Datei, die die Verkaufsverfolgungsdaten erzeugt, ist diese:

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

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

Sales tracking code

Dies muss geändert werden, damit ganz gleich, welche gruppierte Produktvariante gekauft wurde, immer die ID des “Haupt”-Produkts gesendet wird.

Die importierten Bestellungen #

Der gleiche Vorgang muss auch 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

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

Order formatter function

Ändern Sie dies auf dieselbe Logik wie bei der Verkaufsverfolgung.

Prüfen, ob Ihre Änderungen funktionieren #

Gehen Sie jetzt zu my.clerk.io -> Data und klicken Sie Start New Data Sync, um die neuesten Daten zu importieren:

Start new data sync

Führen Sie eine Test-Bestellung durch, bei der Sie ein Produkt mit Varianten kaufen.

Gehen Sie anschließend zu Orders und öffnen Sie die Bestellung, die Sie gerade aufgegeben haben.

Wenn Sie die Hauptprodukte in der Bestellung sehen können, einschließlich ihres Namens und Bildes, funktioniert Ihr Code:

Orders overview

Diese Seite wurde von einer hilfreichen KI übersetzt, daher kann es zu Sprachfehlern kommen. Vielen Dank für Ihr Verständnis.