FAQ

Haben Sie Probleme mit Ihrer Magento 1-Integration? Diese FAQ behandelt die häufigsten Probleme und deren Lösungen, von Währungsumrechnung bis zu Synchronisationsfehlern.

Währungsumrechnung #

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

Sie wird in my.clerk.io -> Designs mit dem Formatierer price_in_currency hinzugefügt.

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 den Preis automatisch in die Währung der aktuellen Sitzung und fügt das Währungssymbol hinzu.

Beispielausgabe:

Verwendung von Formatierern #

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

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

• Über my.clerk.io > Developers > Formatters, wo jeder Formatierer als separater Eintrag erstellt werden kann.

• Als Konfiguration für Clerk.js, im tracking-script, das auf allen Seiten eingefügt wird, wobei 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

Beispiel-Formatter #

Ein Beispiel finden Sie unten. 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);
    }
  }
});

Mehrere Formatter #

Sie können beliebig viele Formatter schreiben, getrennt durch Kommas:

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;
  }
}

Verwendung in Designs #

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

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

Damit können Sie beliebige Funktionen in Ihren Designs realisieren, die Sie benötigen.

HTTP-Authentifizierung #

HTTP-Authentifizierung wird häufig auf Staging-Seiten verwendet, um unerwünschte Besucher zu vermeiden.

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

Sie können dies beheben, indem Sie die Anmeldedaten in die Import-URL eintragen.

Aktualisieren Sie in my.clerk.io > Data > Configuration Ihre Import-URL wie folgt:

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

Häufige Synchronisationsfehler #

Hinweis: Wir empfehlen, die Erweiterung immer auf die neueste Version zu aktualisieren, um alle aktuellen Funktionen von Clerk zu erhalten.

Beim Import von Daten mit der Magento 1-Erweiterung ist der Server Ihres Webshops dafür verantwortlich, Produkt-, Kategorie- und Verkaufsdaten an Clerk zu senden.

In einigen Fällen kann jedoch die Serverkonfiguration verhindern, dass der Importer Zugriff erhält, was zu einem Fehler in der Daten-Synchronisation führt.

Im Folgenden finden Sie eine Liste der häufigsten Fehler und deren Behebung.

401 Unauthorized #

Dieser Fehler tritt auf, wenn Ihr Webshop oder Ihre Entwicklungsumgebung HTTP-Authentifizierung zur Zugriffskontrolle verwendet.

Dies lässt sich lösen, 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 Forbidden #

Dieser Fehler tritt auf, wenn Ihr Server den Zugriff des Importers blockiert.

In den meisten Fällen müssen Sie einfach die IP-Adresse des Importers auf die Whitelist setzen, um Zugriff zu gewähren.

Die aktuelle IP-Adresse finden Sie hier.

Überprüfen Sie außerdem, ob Ihr public key, private key und Ihre Import-URL für den Store, in dem Sie sich in my.clerk.io befinden, korrekt sind.

Was ist, wenn ich bereits zugelassen habe, aber der gleiche Fehler weiterhin auftritt?

Es gibt einige Fälle, in denen Sie die IP-Adresse des Importers zugelassen haben, aber der Fehler weiterhin besteht.

In diesen Fällen empfehlen wir, diese Aspekte zu überprüfen:

• Der Authentifizierungs-Teil des Body könnte durch den Server des Shops aus der Anfrage entfernt werden.

• Begrenzung der Anfrage-Rate des Servers in Bezug auf Cloudflare.

404 Not Found #

Dieser Fehler tritt auf, wenn der Importer nicht auf den Link zugreifen konnte, der die Daten vom Webshop überträgt.

In den meisten Fällen liegt das daran, dass die Erweiterung entweder:

• Überhaupt nicht installiert ist

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

Vergewissern Sie sich zuerst, dass Sie die Erweiterung korrekt installiert haben.

Löschen Sie außerdem den Cache Ihres Webshops, bevor Sie einen neuen Import versuchen.

429 Too Many Requests #

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 Request-Limit für Ihren Server erhöhen oder die Page Size in my.clerk.io > Data > Configuration auf einen höheren Wert setzen, sodass der Importer weniger, aber dafür größere Anfragen stellt:

Wenn Sie den Hosting-Anbieter Byte.nl verwenden, gibt der Importer in der Regel diesen Fehler aufgrund deren Rate Limiter zurück. Kontaktieren Sie in diesem Fall Byte.nl und bitten Sie darum, den User-Agent des Importers “clerk” auf die Whitelist zu setzen.

500 Internal Server Error #

Dieser Fehler bedeutet, dass Ihr Server einen internen Fehler festgestellt hat und nicht angeben konnte, welcher Fehler aufgetreten ist.

In diesem Fall überprüfen Sie bitte Ihr Serverprotokoll, um herauszufinden, welcher Prozess abgestürzt ist und warum.

In den meisten Fällen liegt es einfach an einem Produkt mit einem ungültigen Attribut oder einer Funktion, die im Webshop falsch aufgerufen wird.

503 Service Unavailable #

Dieser Fehler ist meist nur temporär und wird verursacht, wenn der Server zu beschäftigt ist, um die Anfrage zu bearbeiten.

Versuchen Sie es später erneut.

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

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

Magento API error #

Dieser Fehler bedeutet ebenfalls, dass Ihr Server einen internen Fehler festgestellt hat und nicht angeben konnte, welcher Fehler oder Fehlercode aufgetreten ist.

In diesem Fall überprüfen Sie bitte Ihr Serverprotokoll, um herauszufinden, welcher Prozess abgestürzt ist und warum.

In den meisten Fällen liegt es an einem Produkt mit einem ungültigen Attribut oder daran, dass Ihr Speicherlimit überschritten wurde.

Powerstep wird nicht angezeigt #

Wenn der Add-To-Basket-Schritt nicht aktiviert ist, liegt das typischerweise an zwei Gründen:

• Sie haben ein anderes Add-To-Basket-Popup oder eine Funktion aktiviert, die Clerk’s Funktion blockiert.

• Es wurden die falschen Content IDs in der Erweiterung eingefügt.

Anderes Popup aktiviert #

Prüfen Sie zunächst Ihre bestehende Magento-Installation, um festzustellen, ob bereits ein Popup oder Dropdown angezeigt wird, wenn ein Produkt in den Warenkorb gelegt wird.

Diese können normalerweise verhindern, dass Clerk’s Add-To-Basket-Schritt angezeigt wird.

Deaktivieren Sie diese Funktion und versuchen Sie es erneut.

Falsche Content-IDs #

Sollten Sie kein anderes Add-To-Basket-Popup haben und Ihr Powerstep ist aktiviert, wird aber nicht angezeigt, liegt es wahrscheinlich daran, dass die falschen Template-IDs in den Clerk-Erweiterungseinstellungen eingetragen wurden.

Dadurch funktioniert der Powerstep nicht.

Um dies zu beheben, melden Sie sich zuerst in Ihrem Magento-Admin an und gehen Sie zu System > Configuration > Clerk > Settings.

Wählen Sie dann den richtigen Configuration Scope für Ihren Shop aus.

Überprüfen Sie unter Power step settings das Feld Templates.

Dieses Feld sollte die richtigen IDs enthalten, mit Kommas getrennt, wenn Sie mehrere verwenden.

Um sicherzustellen, dass Ihre IDs korrekt sind, loggen Sie sich in my.clerk.io ein.

Wählen Sie den richtigen Store aus und gehen Sie zu Recommendations/Search > Content.

Klicken Sie auf Edit Content für einen Slider, den Sie im Powerstep anzeigen wollen.

Überprüfen Sie den letzten Tab “Insert into website” und finden Sie den Embed-Code.

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

Klicken Sie auf Save Config in der Magento-Erweiterung; danach sollte der Powerstep funktionieren.

Cache-Probleme #

Wenn Sie das Powerstep-Popup aktiviert haben und es dennoch nicht angezeigt wird, wenn ein Produkt in den Warenkorb gelegt wird, liegt dies meist an Cache.

1. Gehen Sie zu System > Cache und löschen Sie alle internen sowie Drittanbieter-Caches.

2. Wenn das nicht hilft, verwenden Sie vermutlich Full Page Cache, der nur von Seiten betroffen ist, die ein Besucher in seiner Sitzung bereits angesehen hat. Die Deaktivierung hat minimalen Einfluss auf die Seitenladegeschwindigkeit.

3. Der Screenshot unten zeigt, welchen Sie deaktivieren müssen:

Sobald Sie den Full Page Cache deaktiviert haben, sollte das Clerk-Popup erscheinen.

Falls nicht, kontaktieren Sie bitte den Clerk Support über das Live-Chat-Symbol unten rechts, damit wir eine Lösung für Ihr spezifisches Setup finden können.

Frontpage-Slider werden gecached #

Normalerweise passiert dies nur, wenn Embed-Codes über die CMS Pages im Magento-Backend eingefügt werden, da die Startseite gecached wird:

Stattdessen sollten Sie die Embed-Codes direkt in die Frontpage-Dateien über FTP einfügen:

Magento cached die Ergebnisse auf diese Weise nicht.

Bilder werden nicht angezeigt #

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

Das bedeutet, dass die an Clerk gesendeten Bildpfade nicht mehr funktionieren.

Dies kann einfach behoben werden:

1. Loggen Sie sich in my.clerk.io ein.

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

3. Gehen Sie zu Data.

4. Klicken Sie oben rechts auf Start New Data Sync.

Dadurch wird eine neue vollständige Synchronisation Ihrer Produkte gestartet und Clerk erhält die korrekten Bildpfade.

In der Clerk Magento-Erweiterung v2.1.0 wird dieses Problem dadurch behoben, dass automatisch eine Synchronisation gestartet wird, wenn der Bildcache geleert wurde.

Wenn Sie eine ältere Erweiterungsversion verwenden, empfehlen wir dringend ein Update auf die neueste Version.

Upgrade auf Clerk.js 2 #

Clerk.js 2 ist eine schnellere und flexiblere Version unserer JavaScript-Bibliothek.

Das macht die Installation von Clerk in jedem Webshop einfacher.

Da sich die beiden Versionen jedoch geringfügig unterscheiden, müssen Sie die folgenden Schritte befolgen, um ein erfolgreiches Upgrade durchzuführen.

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

Designs erstellen #

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

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

• Verwenden Sie den intuitiven Design Editor, um neue Designs zu erstellen, wie in den folgenden Punkten beschrieben.

• Konvertieren Sie Ihre alten Designs. Folgen Sie dieser Anleitung, um zu sehen, wie das funktioniert.

Design Editor-Option #

1. Gehen Sie zu my.clerk.io > Recommendations/Search > Designs > New Design.

2. Wählen Sie den Designtyp aus.

3. Im Design Editor können Sie auf jedes vorhandene Element (wie Name, Bild, Button usw.) klicken, um es zu bearbeiten, oder Sie wählen neue Elemente aus, um weitere Produktinformationen hinzuzufügen.

4. Klicken Sie auf Publish, wenn Sie fertig sind, und gehen Sie zu Schritt 2 in der Anleitung.

5. Gehen Sie zu Recommendations/Search > Content und ändern Sie Ihren Clerk Content so, dass Ihr neues Design verwendet wird.

6. Klicken Sie auf Update Content. Dadurch werden sie vorübergehend auf Ihrem Webshop nicht angezeigt, bis Sie mit Schritt 2 fertig sind. Wählen Sie das neue Design für alle Inhalte aus, die aktualisiert werden sollen.

Nun sind Sie bereit auf Clerk.js 2 umzustellen.

Erweiterung aktualisieren #

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

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

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

Änderungen speichern #

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

• Die geänderten Dateien lokal auf Ihrem FTP gesichert haben, oder
• Ein Backup aller geänderten Dateien angelegt haben, das Sie in die neue Erweiterung übernehmen können.

In der Regel sind die Dateien, die die meisten Entwickler ändern, Product.php und Productbase.php, die 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

Erweiterung deaktivieren #

Bevor Sie das Upgrade versuchen, ist es sehr wichtig, dies zu tun:

1. Deaktivieren Sie die alte Erweiterung auf der Seite System > Configuration > Clerk > Settings in Magento. Setzen Sie einfach Enable auf No und klicken Sie auf Save Config.

2. Anschließend deinstallieren Sie sie entweder über Magento Connect oder löschen die Dateien per FTP, wenn Sie die Erweiterung direkt installiert haben.

Andernfalls könnte Ihre Configuration-Seite aufhören zu funktionieren und keine der beiden Erweiterungen funktioniert anschließend.

Erweiterung installieren #

Installieren Sie zuletzt die neueste Erweiterung erneut und kopieren Sie alle gesicherten Dateien auf Ihren FTP-Server.

Ihre Konfiguration sollte bestehen bleiben, selbst wenn Sie die neue Version installieren.

Überprüfen Sie System > Configuration > Clerk, um sicherzustellen, dass noch alles vorhanden ist.

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

Die vollständige Dokumentation zu Clerk.js 2 finden Sie hier:

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

Umgang mit require.js #

Dies gilt nur bei Verwendung der Version 3.7.2 oder niedriger der Magento 1 Clerk-Erweiterung.

In manchen Setups verhindert Require.js das Laden von Clerk.js, sodass keine Slider oder Suchergebnisse angezeigt werden.

Tritt das auf, wird folgender Fehler in Ihrer Konsole angezeigt:

Uncaught ReferenceError: Clerk is not defined

Es gibt zwei Möglichkeiten mit Require.js umzugehen. Beide erfordern Änderungen im tracking-script in dieser Datei:

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

In Require.js einbinden #

Die beste Variante ist zu versuchen, dass Require.js Clerk erkennt.

Fügen Sie dazu require(['clerk'], function() {}); am unteren Ende des Tracking-Scripts ein:

Require.js ignorieren #

Wenn die obige Lösung nicht funktioniert, können Sie Require.js ignorieren.

Fügen Sie dazu window.__clerk_ignore_requirejs = true; am Anfang des Tracking-Skripts ein:

Nach Anwendung einer dieser Methoden ist Require.js nun mit Clerk kompatibel.