Magento 1

Häufig gestellte Fragen

Umgang mit Währungsumrechnungen #

Ab v3.0.3 der Magento 1 Erweiterung ist die Währungsumrechnung standardmäßig enthalten, wenn Sie die Standardumrechnungsfunktion von Magento 1 verwenden.

Es wird in my.clerk.io -> Designs hinzugefügt, mit dem Formatter price_in_currency.

Der Helper kann auf folgende Weise zu Ihrem Design hinzugefügt werden:

{%raw%}
<div class="clerk-product-price">
{{ product.price_final_excl_tax | price_in_currency }}
</div>{%endraw%}

Der Helper konvertiert automatisch den Preis in die Währung der aktuellen Sitzung und fügt das Währungssymbol hinzu.

Beispielausgabe:

Verwendung von Formatierern in Designs #

Clerk.js ermöglicht es Ihnen, benutzerdefinierte JavaScript-Funktionen zu schreiben, die neue Funktionen zu den Designs hinzufügen.

Formatierer können auf zwei Arten hinzugefügt werden:

  • Über my.clerk.io > Einstellungen > Formatierer, wo jeder Formatierer als separate Einträge erstellt werden kann.
  • Als Konfiguration für Clerk.js, im Tracking-Skript, das auf allen Seiten eingefügt wird, wo mehrere Formatierer auf einmal hinzugefügt werden können.

Für Magento 1 enthält diese Datei das Tracking-Skript:

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

Ein Beispiel ist unten zu sehen. Bitte beachten Sie, dass dies für Clerk V2 (neueste Version) ist:

    Clerk('config', {
      key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
      formatters: {
                form_key: function () {
                    return '<?php echo $this->getFormKey(); ?>';
                },
                price_in_currency: function(price) {
                    price =  Math.round(price * 100) / 100;
                    var price_converted = Math.round((price * <?php echo (float)$rates[$currentCurrencyCode]; ?>) * 100) / 100;
                    var retVal = <?php echo json_encode($currentCurrencySymbol); ?> + ' ' + price_converted.toFixed(2).toString();

                    return retVal;
                },
                log_price: function(price) {
                   console.log(price);
                }
            }
        });

Sie können beliebig viele Formatierer schreiben, die durch Kommas getrennt sind:

formatters: {
   log_price: function(price) {
      console.log(price);
   },
   calculate_discount: function(price,special_price) {
      return price-special_price;
   },
   substring: function(text) {
      var short_string = text.substring(0,20);
      return short_string;
   }
}

Nachdem Sie Ihre Formatierer erstellt haben, können Sie diese in Ihren Designs mit dieser Syntax verwenden:

{%raw%}{{ x  formatter | attribute }} {{ x | formatter | attribute1 | attribute2 }}{%endraw%}

Dies ermöglicht es Ihnen, jede Funktionalität in Ihren Designs zu erstellen, die Sie benötigen.

Synchronisierung mit HTTP Auth #

Oft wird die HTTP-Authentifizierung auf Staging-Seiten verwendet, um ungebetene Besucher zu vermeiden.

Dies blockiert auch den Clerk-Importer und zeigt einen 401 Unauthorized-Fehler im Synchronisierungsprotokoll an.

Sie können den Importer einfach überprüfen, indem Sie die Authentifizierungsinformationen in die Import-URL wie unten eingefügt, in der Datensynchronisierung bei my.clerk.io:

http//USER:PASS@magento.clerk.io/clerk/api/store/1:

Häufige Synchronisierungsprobleme #

Hinweis: Wir empfehlen Ihnen, die Erweiterung immer auf die neueste Version zu aktualisieren, um alle aktuellen Funktionen von Clerk zu erhalten.
Beim Importieren von Daten mit der Magento 1 Erweiterung ist der Server des Webshops dafür verantwortlich, die Produkt-, Kategorie- und Verkaufsdaten an Clerk.io. zu senden.

In einigen Fällen könnte jedoch die Serverkonfiguration den Importer daran hindern, Zugriff zu erhalten, was einen Fehler in Data Sync verursacht.

Unten finden Sie eine Liste der häufigsten Fehler und wie Sie diese beheben können.

401 Serverfehler: Nicht autorisiert #

Dieser Fehler tritt auf, wenn Ihr Webshop-/Entwicklungsumgebung HTTP-Authentifizierung benötigt, um darauf zuzugreifen.

Dies wird einfach gelöst, indem Sie den Benutzernamen und das Passwort als Teil der Import-URL einfügen:

http://username:password@magento.clerk.io/clerk/api/store/1

403 Serverfehler: Verboten #

Dieser Fehler tritt auf, wenn Ihr Server den Importer daran hindert, darauf zuzugreifen. In den meisten Fällen müssen Sie einfach die IP-Adresse des Importers auf die Whitelist setzen, um ihm Zugriff zu gewähren.

Die neueste IP-Adresse finden Sie hier.

Überprüfen Sie auch, ob Ihr öffentlicher Schlüssel, privater Schlüssel und Import-URL korrekt sind für den Store, in dem Sie bei my.clerk.io arbeiten.

Was ist, wenn ich bereits auf die Whitelist gesetzt habe, aber der gleiche Fehler weiterhin auftritt?

Es gibt einige Fälle, in denen Sie die IP-Adresse des Importers auf die Whitelist gesetzt haben und der Fehler weiterhin besteht. In diesem Fall empfehlen wir Ihnen, diese Punkte zu überprüfen:

  • Der Authentifizierungsteil des Körpers könnte von der Anfrage des Shop-Servers entfernt worden sein.

  • Ratenlimit für den Server in Bezug auf Cloudflares.

404 Serverfehler: Nicht gefunden #

Dieser Fehler tritt auf, wenn der Importer nicht auf den Link zugreifen konnte, der uns Daten vom Webshop sendet. In den meisten Fällen geschieht dies, weil die Erweiterung entweder:

  • Überhaupt nicht installiert ist

  • Ein Cache dazu führt, dass der Link nicht initialisiert wird

Stellen Sie zunächst sicher, dass Sie die Erweiterung korrekt installiert haben.

Zweitens sollten Sie den Cache Ihres Webshops leeren, bevor Sie einen neuen Import versuchen.

429 Serverfehler: Zu viele Anfragen #

Dieser Fehler tritt auf, wenn Ihr Server dem Importer den Zugriff aufgrund zu vieler eingehender Anfragen verweigert.

Sie können dies beheben, indem Sie das Anforderungs-Limit für Ihren Server erhöhen oder die Seitenanzahl auf einen höheren Wert im Clerk.io Importer setzen, wodurch der Importer weniger, größere Anfragen stellt:

Wenn Sie den Hosting-Anbieter Byte.nl verwenden, gibt der Importer normalerweise diesen Fehler aufgrund ihres Ratenbegrenzers zurück. In diesem Fall kontaktieren Sie einfach Byte.nl und bitten Sie sie, den User-Agent des Importers " clerk" auf die Whitelist zu setzen.

500 Interner Serverfehler #

Dieser Fehler bedeutet, dass Ihr Server auf einen internen Fehler gestoßen ist und nicht in der Lage war, anzugeben, welcher Fehler aufgetreten ist.

In diesen Fällen können Sie Ihr Serverprotokoll überprüfen, um zu identifizieren, welcher Prozess abgestürzt ist und warum. In den meisten Fällen liegt es einfach an einem Produkt mit einem ungültigen Attribut oder an einer Funktion, die im Webshop falsch aufgerufen wird.

503 Serverfehler: Dienst nicht verfügbar #

Dieser Fehler ist normalerweise vorübergehend und wird durch den Server verursacht, der zu beschäftigt ist, um die Anfrage zu bearbeiten. Versuchen Sie es später noch einmal.

Wenn das Problem weiterhin besteht, könnte dies bedeuten, dass der Server mit Prozessen überlastet ist und nahe an der maximalen Kapazität ist.

Überprüfen Sie die Serverlast, um festzustellen, ob dies der Fall ist.

Magento API: "" #

Dieser Fehler bedeutet ebenfalls, dass Ihr Server auf einen internen Fehler gestoßen ist und nicht in der Lage war, anzugeben, welcher Fehler oder Fehlercode aufgetreten ist.

In diesen Fällen können Sie Ihr Serverprotokoll überprüfen, um zu identifizieren, welcher Prozess abgestürzt ist und warum. In den meisten Fällen liegt es einfach an einem Produkt mit einem ungültigen Attribut oder Ihr Speicherlimit wurde überschritten.

Schritt zum Hinzufügen zum Warenkorb wird nicht angezeigt #

Wenn der Schritt “In den Warenkorb legen” nicht aktiviert ist, liegt dies typischerweise an zwei Gründen:

  • Sie haben ein anderes Popup oder eine andere Funktion zum Hinzufügen zum Warenkorb aktiviert, die die Funktion von Clerk.io blockiert

  • Die falschen Inhalts-IDs sind in der Erweiterung eingefügt.

Ein anderes Popup zum Hinzufügen zum Warenkorb ist aktiviert

Überprüfen Sie zunächst Ihre bestehende Magento-Installation, um zu sehen, ob Sie bereits ein Popup oder Dropdown haben, das angezeigt wird, wenn ein Produkt in den Warenkorb gelegt wird.

Diese können normalerweise verhindern, dass der Schritt “In den Warenkorb legen” von Clerk.io angezeigt wird.

Wenn dies der Fall ist, deaktivieren Sie es und versuchen Sie es erneut.

Falsche Inhalts-IDs sind in der Erweiterung eingefügt

Wenn Sie kein anderes Popup zum Hinzufügen zum Warenkorb haben und Ihr Powerstep aktiviert ist, aber nicht angezeigt wird, liegt es wahrscheinlich daran, dass die falschen Template-ID*s in den Einstellungen der Clerk.io Erweiterung eingefügt wurden. Dies führt dazu, dass der Powerstep fehlschlägt.

Um dies zu beheben, melden Sie sich zunächst bei Ihrem Magento-Admin an und gehen Sie zu System->Konfiguration->Clerk->Einstellungen

Wählen Sie dann den richtigen Konfigurationsbereich aus, der zu Ihrem Store passt.

Überprüfen Sie im Bereich Powerstep-Einstellungen das Feld Templates.

Dieses Feld sollte die korrekten IDs enthalten, die durch Kommas getrennt sind, wenn Sie mehr als eine verwenden.

Um sicherzustellen, dass Ihre IDs korrekt sind, melden Sie sich bei my.clerk.io. an.

Wählen Sie den richtigen Store aus und gehen Sie zu Empfehlungen/Suche -> Inhalt.

Klicken Sie auf Inhalt bearbeiten für einen Slider, den Sie im Powerstep anzeigen möchten.

Überprüfen Sie den letzten Tab " In die Website einfügen" und suchen Sie den Embed-Code.

Die ID, die in data-template gefunden wird, ist die ID, die Sie in die Magento-Erweiterung kopieren müssen:

Klicken Sie auf Konfiguration speichern in der Magento-Erweiterung, und der Powerstep sollte danach funktionieren.

Wenn Sie das Powerstep-Popup aktiviert haben und es immer noch nicht angezeigt wird, wenn Sie ein Produkt in den Warenkorb legen, liegt das Problem oft am Cache.

1. Gehen Sie zunächst zu System => Cache und leeren Sie alle internen und Drittanbieter-Caches.

2. Wenn dies das Problem nicht löst, verwenden Sie wahrscheinlich Full Page Cache, der nur die Seiten betrifft, die ein Besucher bereits in seiner Sitzung angesehen hat. Das Deaktivieren hat nur einen minimalen Einfluss auf die Seitenladegeschwindigkeit.

3. Der Screenshot unten zeigt genau, welches Sie deaktivieren sollten:

Sobald Sie den Full Page Cache deaktiviert haben, sollte das Clerk-Popup erscheinen. Wenn dies nicht der Fall ist, wenden Sie sich bitte an den Clerk-Support über das Live-Chat-Symbol in der unteren rechten Ecke, und wir können Ihnen helfen, eine Lösung für Ihr spezifisches Setup zu finden 😃

Startseiten-Slider zeigen immer die gleichen Produkte an #

Normalerweise passiert dies nur, wenn Embed-Codes über Magentos CMS-Seiten im Backend eingefügt werden, da die Startseite zwischengespeichert wird:

Stattdessen sollten Ihre Embed-Codes direkt in die Startseiten-Dateien über FTP eingefügt werden:

Magento wird keine Ergebnisse zwischenspeichern, wenn sie auf diese Weise eingefügt werden.

Clerk zeigt keine Bilder an #

Wenn der Bildcache von Magento gelöscht wird, entweder manuell oder automatisch, ändern sich alle Bildpfade.

Das bedeutet, dass die Bildpfade, die an Clerk.io gesendet werden, nicht mehr funktionieren.

Dies kann einfach behoben werden, indem Sie Folgendes tun:

  1. Melden Sie sich bei my.clerk.io an.

  2. Klicken Sie auf den Store, in dem Bilder fehlen.

  3. Gehen Sie zu Daten.

  4. Klicken Sie auf Neue Datensynchronisierung starten in der oberen rechten Ecke.

Dies startet eine neue vollständige Synchronisierung Ihrer Produkte, wodurch Clerk.io die korrekten Bildpfade erhält.

In der Magento-Erweiterung von Clerk.io v2.1.0 wurde dieses Problem behoben, indem automatisch eine Synchronisierung gestartet wird, wenn der Bildcache gelöscht wird.

Wenn Sie eine ältere Version der Erweiterung verwenden, empfehlen wir dringend, auf die neueste Version zu aktualisieren.

Upgrade auf Clerk.js 2 #

Clerk.js 2 ist eine schnellere und viel flexiblere Version unserer JavaScript-Bibliothek, die die Installation von Clerk.io auf jedem Webshop zum Kinderspiel macht.

Da die beiden Versionen jedoch leicht unterschiedlich funktionieren, müssen Sie diese Schritte befolgen, um erfolgreich zu upgraden.

Die beiden Hauptunterschiede in Clerk.js 2 bestehen darin, dass die Designs in my.clerk.io die Liquid Template-Sprache verwenden, aber sie können auch einfach mit dem Design-Editor erstellt werden.

Designs konvertieren #

Da Clerk.js 2 einen anderen Ansatz für Designs hat, müssen Sie neue erstellen.

Sie können Ihre Clerk.js 2 Designs auf eine von zwei Arten erstellen:

1.1 Beginnen Sie, indem Sie zu my.clerk.io -> Empfehlungen/Suche -> Designs gehen und auf Neues Design klicken:

1.2. Wählen Sie Ihren Design-Typ.

1.3. Klicken Sie im Design-Editor auf eines der vorhandenen Elemente wie Name, Bild, Schaltfläche usw., um es zu bearbeiten, oder wählen Sie neue Elemente aus, um dem Design weitere Informationen über Produkte hinzuzufügen.

1.4. Klicken Sie auf Veröffentlichen, wenn Sie fertig sind, und gehen Sie zu Schritt 2 im Leitfaden.

1.5. Gehen Sie schließlich zu Empfehlungen/Suche -> Inhalt und ändern Sie Ihren Clerk.io Inhalt, um Ihr neues Design zu verwenden.

1.6. Klicken Sie auf Inhalt aktualisieren. Dies wird vorübergehend dazu führen, dass sie nicht auf Ihrem Webshop angezeigt werden, bis Sie mit Schritt 2 fertig sind. Wählen Sie das neue Design für alle Inhalte aus, die aktualisiert werden sollen.

1.9. Da! Sie sind jetzt bereit, auf Clerk.js 2 umzuschalten.

Upgrade Ihrer Erweiterung #

Wenn Sie bereits die neueste Version der Clerk.io Magento-Erweiterung haben, können Sie diesen Schritt überspringen.

Sie können die neueste Erweiterung über diesen Link herunterladen:

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

2.1. Speichern Sie alle Änderungen an den Erweiterungsdateien

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

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

  • Eine Sicherungskopie aller geänderten Dateien gemacht haben, die Sie in die neue Erweiterung übertragen können.

In der Regel sind die Dateien, die die meisten Entwickler ändern, Product.php und Productbase.php, die Produktattribute steuern.

Diese Dateien befinden sich hier:

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

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

Deaktivieren und deinstallieren Sie die vorhandene Erweiterung

Bevor Sie versuchen, ein Upgrade durchzuführen, ist es sehr wichtig, dass Sie dies tun:

2.2.1. Deaktivieren Sie die alte Erweiterung auf der Seite System->Konfiguration->Clerk->Einstellungen von Magento. Setzen Sie einfach Aktivieren auf Nein und klicken Sie auf Konfiguration speichern.

2.2.2. Deinstallieren Sie sie anschließend entweder über Magento Connect oder indem Sie die Dateien von FTP löschen, wenn Sie sie direkt hier installiert haben.

Andernfalls könnte Ihre Konfigurations-Seite nicht mehr funktionieren und keine der Erweiterungen wird danach funktionieren.

2.3. Installieren Sie die neueste Erweiterung

Installieren Sie schließlich die neueste Erweiterung erneut und übertragen Sie alle Dateien, die Sie gesichert haben, auf Ihren FTP-Server.

Ihre Konfiguration sollte gespeichert bleiben, auch wenn Sie die neue Version installieren. Überprüfen Sie System->Konfiguration->Clerk, um sicherzustellen, dass alles noch vorhanden ist.

Jetzt haben Sie die neueste Version von Clerk.io für Magento installiert, und Clerk.js 2 läuft auf Ihrem Webshop!

Die vollständige Dokumentation für Clerk.js 2 finden Sie hier:

https://docs.clerk.io/docs/clerkjs-quick-start

Umgang mit require.js #

Dies gilt nur für die Verwendung von v.3.7.2 oder niedriger der Magento 1 Clerk-Erweiterung.

In einigen Setups verhindert Require.js, dass Clerk.js geladen wird, was bedeutet, dass keine Slider oder Suchergebnisse angezeigt werden.

Wenn dies geschieht, wird der folgende Fehler in Ihrer Konsole angezeigt:

Uncaught ReferenceError: Clerk is not defined

Es gibt zwei Möglichkeiten, mit Require.js umzugehen. Beide Ansätze erfordern, dass Sie Änderungen am Tracking-Skript in dieser Datei vornehmen:

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

“clerk” in Require.js einfügen #

Der beste Ansatz besteht darin, zu versuchen, Require.js dazu zu bringen, Clerk.io zu erkennen.

Sie können dies tun, indem Sie require([‘clerk’], function() {}); am Ende des Tracking-Skripts einfügen:

Require.js ignorieren #

Wenn die obige Lösung nicht funktioniert, ist es möglich, Require.js zu ignorieren.

Sie können dies tun, indem Sie window.__clerk_ignore_requirejs = true;

am Anfang des Tracking-Skripts einfügen:

Nach der Verwendung eines dieser Ansätze wird Require.js jetzt mit Clerk.io kompatibel sein.

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