FAQ

Haben Sie Probleme mit Ihrer SmartWeb Classic-Integration? Diese FAQ behandelt die häufigsten Probleme und deren Lösungen, von Formatters bis hin zum Upgrade auf Clerk.js 2.

Verwendung von Formatters #

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

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

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

• Als Konfiguration für Clerk.js, im Tracking-Script, das auf allen Seiten eingefügt wird, wobei mehrere Formatters gleichzeitig hinzugefügt werden können.

Beispiel-Formatter #

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

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

Mehrere Formatters #

Sie können beliebig viele Formatters 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 #

Nach dem Erstellen Ihrer Formatters können Sie diese in Ihren Designs mit folgender Syntax verwenden:

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

So können Sie jede gewünschte Funktionalität in Ihren Designs umsetzen.

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 Sync-Log an.

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

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

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

Upgrade auf Clerk.js 2 #

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

Das Installieren von Clerk auf jedem Webshop wird so einfacher.

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

Die zwei wichtigsten Unterschiede in Clerk.js 2 sind:

• Die Designs in my.clerk.io verwenden die Liquid Template-Sprache, können aber auch leicht mit dem Design Editor erstellt werden.

• Das Script muss unmittelbar vor dem </head>-Tag im Template Ihres Webshops eingefügt werden.

Designs erstellen #

Da Clerk.js 2 ein anderes Konzept für Designs nutzt, müssen Sie neue Designs 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 geht.

Design Editor Option #

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

2. Geben Sie auf dem folgenden Bildschirm Ihrem Design einen Namen (wir empfehlen, “V2” hinzuzufügen, damit ersichtlich ist, dass Sie Clerk.js 2 verwenden).

3. Wählen Sie den Design-Typ und folgen Sie dem Einrichtungsassistenten.

4. Wenn Sie fertig sind, klicken Sie auf Create Design.

5. Im Design Editor klicken Sie auf eines der vorhandenen Elemente wie Name, Bild, Button usw., um es zu bearbeiten, oder fügen Sie dem Design neue Elemente hinzu, um mehr Informationen über Produkte einzubinden.

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

7. Gehen Sie zu Recommendations/Search > Elements und ändern Sie Ihr Clerk Element, um Ihr neues Design zu verwenden.

8. Klicken Sie auf Update Element. Dies führt vorübergehend dazu, dass sie nicht auf Ihrem Webshop erscheinen, bis Sie mit Schritt 2 fertig sind. Wählen Sie das neue Design für alle Elemente, die aktualisiert werden sollen.

Sie sind jetzt bereit, auf Clerk.js 2 umzusteigen.

Script ersetzen #

1. Finden Sie die Template-Datei, die für die Anzeige aller Seiten des Webshops verwendet wird und in der sich das ursprüngliche Clerk.js-Script meist nahe am unteren Rand befindet.

2. Entfernen Sie das alte Script aus der Datei:

3. Gehen Sie zu my.clerk.io > Developers > Clerk.js. Diese Seite enthält nun Ihren Clerk.js 2-Tracking-Code.

4. Kopieren Sie diesen Code und fügen Sie ihn unmittelbar vor dem </head>-Tag in das Template ein:

5. Speichern Sie Ihr Template.

Herzlichen Glückwunsch! Sie nutzen jetzt das stark verbesserte Clerk.js 2 Setup!

Die vollständige Dokumentation zu Clerk.js 2 finden Sie hier: https://docs.clerk.io/docs/clerkjs-quick-start