Magento 2

Häufig gestellte Fragen

Ändern der Bildgrößen #

Standardmäßig verwendet die Erweiterung die ursprünglichen Bildgrößen, die in Magento 2 festgelegt sind, aber diese können bei Bedarf geändert werden.

Beginnen Sie, indem Sie sich in Ihr Magento 2 Backend einloggen und gehen Sie zu:

Stores -> Configuration -> Clerk -> Configuration

Unter Synchronisierung -> Bildtyp können Sie genau auswählen, in welcher Auflösung Bilder gesendet werden sollen:

Klicken Sie anschließend auf Konfiguration speichern.

Jetzt müssen Sie einfach eine neue Synchronisierung in my.clerk.io ausführen und Ihre neuen Bildgrößen werden importiert.

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 2 enthält diese Datei das Tracking-Skript:

vendor->view->frontend->templates->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: {
             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 sie in Ihren Designs mit dieser Syntax verwenden:

{% raw %} {{{ price | log_price }} {{ price | calculate_discount |  special_price }}) {% endraw %}

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

Synchronisierung mit HTTP-Authentifizierung #

Oft wird die HTTP-Authentifizierung auf Staging-Seiten verwendet, um unerwünschte 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 einfügen, in der Datensynchronisierung bei my.clerk.io:

http://USER:PASS@magento2.clerk.io/

Häufige Synchronisierungsprobleme #

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

Beim Importieren von Daten mit der Magento 2-Erweiterung von Clerk.io 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 Import daran hindern, Zugriff zu erhalten, was zu einem Fehler in der Datensynchronisierung führt.

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

401 Serverfehler: Unautorisiert #

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@magento2.clerk.io

403 Serverfehler: Verboten #

Dieser Fehler tritt häufig aus einem dieser Gründe auf:

Ihr Server blockiert den Importer, um 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 kann hier gefunden werden.
Möglicherweise haben Sie einen falschen öffentlichen Schlüssel, privaten Schlüssel und/oder Import-URL im Store in my.clerk.io.
Sie verwenden Storeviews mit versteckten URLs, wie mywebshop.com?__store=b2b. Manchmal können diese URLs auch 3 Unterstriche enthalten, wie: mywebshop.com?___store=b2b

Falls letzteres der Fall ist, fügen Sie einfach den __store-Parameter in die URL in den Daten ein:

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, diese Punkte zu überprüfen.

Der Authentifizierungsteil des Körpers könnte von der Anfrage des Servers des Shops 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, stellen Sie sicher, dass 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 hypernode.com/nl verwenden, gibt der Importer normalerweise diesen Fehler aufgrund ihres Ratenbegrenzers zurück. In diesem Fall kontaktieren Sie einfach hypernode.com/nl und bitten Sie sie, den User-Agent des Importers " clerk" auf die Whitelist zu setzen.

500 Internal Server Error #

Dieser Fehler bedeutet, dass Ihr Server einen internen Fehler hatte 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 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 erneut.

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

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

Ungültige Antwort erhalten #

Dieser Fehler tritt normalerweise auf, wenn Ihr Webshop ein Umleitungssystem verwendet, um Kunden zu verschiedenen Domains zu senden.

Zum Beispiel könnte der Besuch von " https://mywebshop.com" zu " https://mywebshop.com/it" umgeleitet werden.

Wenn dies der Fall ist, müssen Sie einfach die vollständige URL beim Importieren in my.clerk.io: verwenden.

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 ein Upgrade durchzuführen.

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

Schritt 1: 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. Verwenden Sie den intuitiven Design-Editor, um neue Designs zu erstellen, wie in den folgenden Punkten beschrieben.
2. Konvertieren Sie Ihre alten Designs. Befolgen Sie diesen Leitfaden, um zu sehen, wie es geht.

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

1.2 Geben Sie auf dem folgenden Bildschirm Ihrem Design einen Namen (wir empfehlen, " V2" hinzuzufügen, damit klar ist, dass Sie Clerk.js2 verwenden).

1.3. Wählen Sie den Design-Typ.

1.4. Klicken Sie im Design-Editor auf eines der vorhandenen Elemente wie den Namen, das Bild, die Schaltfläche usw., um es zu bearbeiten, oder fügen Sie neue Elemente zum Design hinzu, um weitere Informationen zu Produkten hinzuzufügen.

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

1.6. Gehen Sie zuletzt zu Empfehlungen / Suche -> Inhalt und ändern Sie Ihren Clerk.io Inhalt, um Ihr neues Design zu verwenden.

1.7. 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, die aktualisiert werden sollen.

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

Schritt 2: Upgrade Ihrer Erweiterung #

WARNUNG: Denken Sie daran, Sicherungskopien aller modifizierten Dateien zu erstellen, da diese überschrieben werden.

Das Upgrade der Magento 2-Erweiterung erfolgt über die Befehlszeile.

Es erfolgt durch die folgenden Schritte:

2.1. Melden Sie sich über die Befehlszeile bei Ihrem Server an.

2.2. Navigieren Sie zu Ihrem Webroot-Ordner (normalerweise " /var/www/your_domain/public_html")

2.3. Aktivieren Sie Root-Zugriff, indem Sie su eingeben und dann Ihr Passwort eingeben.

2.4. Geben Sie die folgenden Befehle in der Reihenfolge ein:composer update clerk/magento2php bin/magento setup:upgradephp bin/magento setup:di:compile

2.5. Warten Sie, bis die Erweiterung abgeschlossen ist.

Ihr Magento 2 ist jetzt auf die neueste Version aktualisiert.

Jetzt haben Sie die neueste Version von Clerk.io für Magento 2 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 #

Dieser Leitfaden gilt nur für die Verwendung bis zur Version 2.8.3 der Magento 2 Clerk-Erweiterung.

In einigen Setups stoppt Require.js das Laden von Clerk.js, 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

Die Magento 2-Erweiterung behandelt bereits Require.js, aber in einigen Fällen ist es notwendig, dass es Clerk.js ignoriert.

Sie können dies in der folgenden Datei tun:

vendor->clerk->magento2->templates->tracking.phtml

Fügen Sie einfach window.__clerk_ignore_requirejs = true;

am Anfang des Tracking-Skripts ein:

Nach Verwendung dieses Ansatzes wird Require.js nun 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.