Woocommerce

Häufig gestellte Fragen

Manuelles Installieren von Elementen #

WooCommerce basiert auf Themes, was oft bedeutet, dass das Clerk.io Plugin unsere Embed-Codes nicht einfügen kann, weil die Hooks nicht dort platziert sind, wo sie sein sollten.

Dieser Leitfaden erklärt, wie man Codes manuell einfügt, falls dies der Fall ist.

1. Die richtige Datei finden #

1. Beginnen Sie damit, Ihr Suchformular zu lokalisieren. Sie können dies tun, indem Sie Ihren Quellcode überprüfen und einen einzigartigen Text für das Feld finden.

2. Nachdem Sie dies identifiziert haben, benötigen Sie eine gute Möglichkeit, um in Ihren Dateien danach zu suchen. Wir empfehlen die Verwendung von Sublime Text.

3. Öffnen Sie die FTP-Dateien Ihres Webshops und lokalisieren Sie public_html -> wp-content -> themes

4. Ziehen Sie die Themes auf Ihren Desktop, um sie auf Ihren Computer zu kopieren. Dies ermöglicht Ihnen, in den Dateien zu suchen:

5. Gehen Sie in Sublime zu Projekt -> Ordner zum Projekt hinzufügen

6. Wählen Sie den Themes-Ordner aus, den Sie auf Ihrem Computer gespeichert haben.

7. Jetzt können Sie in den Dateien suchen, indem Sie zu Suchen -> In Dateien suchen gehen. Sie können sogar wählen, nur in .php-Dateien zu suchen, was normalerweise der Dateityp für Theme-Dateien in WooCommerce ist:

Wenn Sie bereits der Anleitung zum Einrichten der Suche gefolgt sind und eine Seite in WooCommerce für die Suchergebnisse erstellt haben, aber Ihr Suchfeld nicht korrekt verlinkt ist, müssen Sie Folgendes tun.

1. Beginnen Sie damit, den Webshop in Ihrem Browser anzusehen. Wir empfehlen die Verwendung von Chrome.

2. Lokalisieren Sie jeden HTML-Code, der anscheinend einzigartig für das Suchfeld ist. Zum Beispiel das Suchformular:

3. Suchen Sie dies in Sublime, um eine Liste von Dateien zu finden, in denen es enthalten ist:

4. Finden Sie die passende Datei auf FTP.

5. Jetzt können Sie die erforderlichen Einstellungen ändern, um Clerk.io mit der richtigen Seite zu verlinken. Die 3 Dinge, die Sie ändern müssen, sind:

  • Die URL, mit der der Kunde verlinkt ist, die oft im

    -Element zu finden ist, muss geändert werden, um mit dem Namen der Seite übereinzustimmen, die Sie in WooCommerce erstellt haben. Dies wird oft “soegeresultater” oder “search-results” sein.

  • Das “name”-Attribut des Eingabefelds, das “searchterm” sein muss.

  • Das versteckte Eingabefeld mit name=“post_type” muss auskommentiert werden.

6. Ein Suchformular könnte vor der Änderung so aussehen:

7. Und sollte nach der Änderung so aussehen:

8. Jetzt sollten Sie beim Suchen mit der Suchseite verlinkt sein: www.mywebshop.com/soegeresultater?searchterm=test

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

wp-content->plugins->clerkio->includes->class-clerk-visitor-tracking.php

Ein Beispiel ist unten zu sehen. Bitte beachten Sie, dass dies 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 diese in Ihren Designs mit dieser Syntax verwenden:

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

Dies ermöglicht es Ihnen effektiv, 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 einfügen, in der Datensynchronisierung bei my.clerk.io:

https//USER:PASS@www.ewoksRus.com

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 dem Clerk.io WooCommerce-Plugin 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 Ihre 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@woocommerce.clerk.io

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 whitelisten, um ihm Zugriff zu gewähren.

Die neueste IP-Adresse kann hier gefunden werden.

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

Was, 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. In diesem Fall empfehlen wir Ihnen, diese Teile zu überprüfen:

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

  • Die Rate-Limitierung 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 das Plugin entweder:

  • Überhaupt nicht installiert ist

  • Aufgrund eines Updates deaktiviert wurde

  • Ein Cache den Link daran hindert, initialisiert zu werden

  • WooCommerce-Permalinks auf Postname anstelle von Monat und Name eingestellt sind

Stellen Sie zunächst sicher, dass Sie das Plugin korrekt installiert haben und dass es aktiviert ist.

Wenn Sie das Plugin kürzlich automatisch aktualisiert haben, deaktiviert WooCommerce manchmal das Plugin. Wenn dies geschehen ist, gehen Sie einfach zu Plugins > Clerk und klicken Sie auf Aktivieren, um es wiederherzustellen.

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

Wenn es immer noch nicht richtig synchronisiert, gehen Sie zu Einstellungen => Permalinks und ändern Sie die Allgemeinen Einstellungen in Monat und Name und drücken Sie Speichern:

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 einstellen, 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” zu whitelisten.

500 Interner Serverfehler #

Dieser Fehler bedeutet, dass Ihr Server auf einen internen Fehler gestoßen ist und nicht angeben konnte, 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.

Ein Beispiel für einen solchen Fehler könnte auftreten, wenn Sie sowohl WooCommerce als auch Klarna aktualisieren. In diesem Fall wird das Problem durch das Plugin ‘woocommerce-gateway-klarna’ verursacht, das nicht aktualisiert wird.

Wenn Ihnen dies passiert, gehen Sie zu woocommerce-gateway-klarna ->includes->variables-checkout.php .

Suchen Sie nach:

if ( ! is_admin() && ! empty( $klarna_country )) {

und ändern Sie es in:

if ( ! is_admin() && ! empty( $klarna_country ) && WC()->session ) {

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 nahe an der maximalen Kapazität ist.

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

520 Webserver gab einen unbekannten Fehler zurück #

Dieser Fehler wird normalerweise von CloudFlare zurückgegeben und tritt häufig aufgrund eines Engpasses in WooCommerce auf, der Probleme mit höheren Seitenzahlen verursacht. Um dies zu beheben, stellen Sie einfach Ihre Seitenanzahl auf 50 ein und führen Sie eine neue Synchronisierung durch:

522 Serverfehler: Verbindung zeitüberschreitung #

Dieser Fehler tritt normalerweise auf, wenn der Server zu beschäftigt ist, um zu antworten, oder wenn unser Importer keinen Zugriff auf den Server hat.

Warten Sie zunächst ein paar Minuten und versuchen Sie erneut zu synchronisieren, um zu sehen, ob der Server beschäftigt war.

Wenn es immer noch nicht funktioniert, stellen Sie sicher, dass Sie die IP des Importers in Ihrer Serverkonfiguration whitelisted haben. Die neueste IP-Adresse kann hier gefunden werden.

Ungültige Antwort von der WooCommerce API zurückgegeben #

Dieser Fehler tritt normalerweise auf, wenn WooCommerce’s Debugging aktiviert wurde. Dies ist niemals eine gute Idee, auf einem Live-Setup aktiviert zu haben, da es Seiten verlangsamt und potenziell Fehlermeldungen im Frontend anzeigt.

Das Synchronisierungsproblem tritt auf, wenn WooCommerce auf einen Fehler stößt, während es die Produktdaten für den Import generiert.

Dies kann gelöst werden, indem Debugging in wp-config.php deaktiviert wird, indem Sie define(WP_DEBUG’, false) setzen.

Dieser Leitfaden erklärt es detaillierter:

https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/

Und dieser Leitfaden erklärt eine alternative Lösung:

https://aristath.github.io/blog/wp-hide-php-errors

Fehler werden weiterhin protokolliert, auch wenn sie sich nicht im Debug-Modus befinden, aber sie werden stattdessen in einer Datei protokolliert.

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 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.1 Beginnen Sie, indem Sie zu my.clerk.io -> Empfehlungen / Suche -> Designs gehen und auf Neues Design: klicken.

1.2. Wählen Sie den Design Typ und folgen Sie dem Design-Setup-Assistenten.

1.3. Klicken Sie im Design-Editor auf ein beliebiges vorhandenes Element, 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.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.7. Da! Sie sind jetzt bereit, auf Clerk.js 2 umzuschalten.

Schritt 2: Upgrade Ihres Plugins #

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

Das Upgrade des Plugins kann direkt über das WooCommerce-Admin erfolgen.

Beginnen Sie, indem Sie zu Plugin->Neu hinzufügen gehen.

Suchen Sie dann im Suchfeld auf der rechten Seite nach Clerk und klicken Sie auf Jetzt aktualisieren.

Das war’s! Jetzt verwenden Sie die neueste Version von Clerk.io für WooCommerce und Clerk.js 2 läuft auf Ihrem Webshop!

Wenn Sie bereits die neueste Version haben, wird dieser Button einfach Aktiv sagen.

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

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

Immer wieder vermasseln Wordpress / Woocommerce-Plugins die Rewrite-Regel von Wordpress.

Die Rewrite-Regel ist die Konfiguration, die sicherstellt, dass Links wie dieser

domain.com/?p=123

schöne und SEO-optimierte Links wie

domain.com/product/my-beautiful-product/

werden und tatsächlich von Ihnen und Ihren Kunden erreicht werden können.

Wenn Ihre Links nicht richtig funktionieren, tun Sie Folgendes:

1. Melden Sie sich in Ihrem Wordpress-Backend an

2. Gehen Sie dann zu: Dashboard –> Einstellungen –> Permalink

3. Scrollen Sie nach unten und klicken Sie auf die Schaltfläche “Änderungen speichern” am Ende der Seite, ohne etwas zu ändern. Dadurch wird die Rewrite-Regel von Wordpress überschrieben.

4. Sobald die Seite aktualisiert wurde, leeren Sie den Cache Ihres Wordpress (falls vorhanden) und warten Sie ein paar Minuten. Sie sollten in der Lage sein, alle Ihre Webseiten wieder zu sehen.

Wenn Sie nach all dem immer noch nicht auf Ihre Webseiten zugreifen können, kontaktieren Sie uns unter support@clerk.io, wir sind hier, um zu helfen!

Warnungen, die im Backend und Frontend angezeigt werden #

Dieser Fehler tritt normalerweise auf, wenn WooCommerce’s Debugging aktiviert wurde. Dies ist niemals eine gute Idee, auf einem Live-Setup aktiviert zu haben, da es Seiten verlangsamt und potenziell Fehlermeldungen im Frontend anzeigt.

Das Synchronisierungsproblem tritt auf, wenn WooCommerce auf einen Fehler stößt, während es die Produktdaten für den Import generiert.

Dies kann gelöst werden, indem der Debug-Modus entweder über das Plugin oder direkt in den WooCommerce-Dateien deaktiviert wird.

Umgang mit require.js #

Dieser Leitfaden gilt nur für die Verwendung bis zur v.1.7.1 der WooCommerce 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:

wp-content -> plugins -> clerkio -> includes -> class-clerk-visitor-tracking.php

“clerk” in Require.js einfügen

Der beste Ansatz ist, 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:

Verwendung des Plugins

Wenn Sie Clerk.io’s v2.2.4 oder später verwenden, kann das Debugging direkt von der Plugin-Seite in Ihrem WooCommerce-Backend deaktiviert werden.

Gehen Sie zu Clerk -> Clerk-Einstellungen -> Debug-Anleitung und klicken Sie auf Debug-Modus deaktivieren:

Oder direkt in den Dateien

Der Debug-Modus kann auch über FTP in wp-config.php deaktiviert werden, indem Sie define(WP_DEBUG’, false) setzen.

Dieser Leitfaden erklärt es detaillierter:

https://docs.woocommerce.com/document/woocommerce-product-search/api/debugging/

Und dieser Leitfaden erklärt eine alternative Lösung:

https://aristath.github.io/blog/wp-hide-php-errors

Fehler werden weiterhin protokolliert, auch wenn sie sich nicht im Debug-Modus befinden, aber sie werden stattdessen in einer Datei protokolliert.

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:

Nachdem Sie einen dieser Ansätze verwendet haben, wird Require.js jetzt mit Clerk.io kompatibel sein.

Mehrsprachigkeit #

Wenn Sie WPML in WooCommerce verwenden, sollten Sie in der Lage sein, Ihre Sprachen über die URL zu differenzieren, wie folgt:

Wenn Sie einzigartige URLs wie diese haben, können Sie das WooCommerce-Plugin erweitern, um WPML zu unterstützen.

Es ist auch in Ordnung, die Sprache über den lang-Parameter zu definieren. Z.B.

Store kopieren #

Der einfachste Weg, Clerk.io in mehreren Domains in Standard-Setups zu implementieren, besteht darin, für jede Domain einen separaten Store in my.clerk.io. zu erstellen. Auf diese Weise können Sie Produkte, Verkäufe, Währungen usw. trennen, um jeden Domain im Auge zu behalten.

Nachdem Sie mit dem ersten Setup fertig sind, klicken Sie auf die obere linke Ecke des Seitenmenüs und klicken Sie dann auf "+ Neuen Store hinzufügen", die letzte Option in der Dropdown-Liste (normalerweise unter den bestehenden Store(s) und Ihrem Firmennamen).

Auf der Seite Neuen Store hinzufügen füllen Sie die Details Ihres Webshops aus und wählen Sie Ihren Hauptstore aus dem Dropdown Inhalt von bestehendem Store kopieren, und klicken Sie dann auf Store hinzufügen:

Dies wird den Inhalt und die Designs von Ihrem Hauptstore übernehmen. Denken Sie daran, die Überschriften in die richtige Sprache zu übersetzen.

Installieren und Konfigurieren #

Offizielle Unterstützung für WPML wurde zur Clerk.io WooCommerce-Erweiterung hinzugefügt, was bedeutet, dass solange Sie diese Version oder eine neuere verwenden, WPML unterstützt werden sollte.

Im Einstellungsbereich für WooCommerce sehen Sie die Einstellungen wie gewohnt. Wenn WPML aktiv und auf Ihrer WordPress-Seite konfiguriert ist, sehen Sie Mehrsprachiger Umfang mit der aktuellen Sprache oben auf der Einstellungsseite.

Um die Sprache zu wechseln, verwenden Sie einfach den Selector im oberen Bereich. Sie sollten die Sprache auswählen, für die Sie Clerk konfigurieren möchten, und Ihre gewünschten Einstellungen bereitstellen. Wiederholen Sie dies für jede Sprache.

Bitte beachten Sie, dass die Auswahl von Alle Sprachen aus diesem Dropdown nicht empfohlen wird, wenn Sie Ihre Konfiguration speichern, da dies Ihre Einstellungen nur als Fallback speichert.

Synchronisieren Sie Ihre Domains #

Sobald Sie das Plugin erweitert haben, können Sie jetzt jeden Ihrer Stores mit ihrer Sprachdomain synchronisieren.

Da Sie die Erweiterung bereits installiert haben, können Sie den ersten Schritt überspringen und direkt mit der Konfiguration und Datensynchronisierung beginnen.

Wenn die Synchronisierung abgeschlossen ist, ist Ihre Domain bereit und verwendet dasselbe Setup wie Ihr Hauptstore.

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