Magento 2

Häufig gestellte Fragen

Ändern der Bildgrößen #

Standardmäßig verwendet die Erweiterung die in Magento 2 festgelegten Originalbildgrößen, diese können jedoch bei Bedarf geändert werden.

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

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 Funktionalitäten 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 (die neueste Version) ist:

    Clerk('config', {
      key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
      formatters: {
             log_price: function(price) {
             console.log(price);
          }
      });

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

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 ungebetene Besucher zu vermeiden.

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

Sie können den Importer leicht überprüfen, indem Sie die Authentifizierungsinformationen in die Import-URL wie unten eingefügt 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 verantwortlich für das Senden der Produkt-, Kategorie- und Verkaufsdaten an Clerk.io.

In einigen Fällen könnte jedoch die Serverkonfiguration den Import 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: 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 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 whitelisten, um ihm Zugriff zu gewähren. Die neueste IP-Adresse kann hier gefunden werden.
Sie haben möglicherweise 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 wie folgt enthalten: mywebshop.com?___store=b2b

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

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

Es gibt einige Fälle, in denen Sie die IP-Adresse des Importers whitelisted haben, und der Fehler weiterhin besteht, dann empfehlen wir, sich diese anzusehen.

Der Authentifizierungsteil des Körpers könnte von der Anfrage des Servers des Shops entfernt worden sein.
Rate-Limit 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 passiert dies, weil die Erweiterung entweder:

Überhaupt nicht installiert ist
Ein Cache den Link daran hindert, initialisiert zu werden

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 den Importer aufgrund zu vieler eingehender Anfragen den Zugriff 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" zu whitelisten.

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 einer Funktion, die im Webshop falsch aufgerufen wird.

503 Serverfehler: Dienst nicht verfügbar #

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

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

Ü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 offensichtlich 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 mehr Informationen über Produkte 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 sie überschrieben werden.

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

Es erfolgt durch die folgenden Schritte:

2.1. Melden Sie sich über 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/magento2 php bin/magento setup:upgrade php 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 verhindert Require.js, dass Clerk.js geladen wird, was bedeutet, dass keine Slider oder Suchergebnisse angezeigt werden.

Wenn dies passiert, 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; oben im Tracking-Skript ein:

Nach der Verwendung dieses Ansatzes 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.