FAQ

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

Verwendung von Formatters #

Clerk.js ermöglicht es Ihnen, eigene JavaScript-Funktionen zu schreiben, die Ihrer Designs neue Funktionalitäten 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 für einen Formatter #

Ein Beispiel finden Sie unten. Beachten Sie, dass dies für Clerk V2 (neueste Version) ist:

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 der Erstellung Ihrer Formatters können Sie diese in Ihren Designs wie folgt verwenden:

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

Dies ermöglicht Ihnen, jede gewünschte Funktionalität in Ihren Designs zu erstellen.

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 einfügen.

In my.clerk.io > Data > Configuration aktualisieren Sie 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.

Die Installation von Clerk auf jedem Webshop wird dadurch einfacher.

Da die beiden Versionen jedoch leicht unterschiedlich funktionieren, müssen Sie diese Schritte ausführen, um das Upgrade erfolgreich durchzuführen.

Die zwei wichtigsten Unterschiede in Clerk.js 2 sind:

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

• Das Skript muss direkt vor dem </head>-Tag in das Template Ihres Webshops eingefügt werden.

Designs erstellen #

Da Clerk.js 2 einen anderen Ansatz für Designs verwendet, 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 es gemacht wird.

Option Design Editor #

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

2. Geben Sie Ihrem Design auf dem nächsten Bildschirm einen Name (wir empfehlen, “V2” hinzuzufügen, sodass deutlich wird, dass Sie Clerk.js 2 verwenden).

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

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 neue Elemente zum Design hinzu, um mehr Informationen zu Produkten hinzuzufügen.

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 so, dass es Ihr neues Design verwendet.

8. Klicken Sie auf Update Element. Dies führt dazu, dass sie vorübergehend nicht mehr in Ihrem Webshop angezeigt werden, bis Sie mit Schritt 2 fertig sind. Wählen Sie das neue Design für alle zu aktualisierenden Elemente aus.

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

Skript ersetzen #

1. Finden Sie die Template-Datei, die zum Anzeigen aller Seiten des Webshops verwendet wird, und in der das ursprüngliche Clerk.js-Skript sich am unteren Ende befindet.

2. Entfernen Sie das alte Skript aus der Datei:

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

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

5. Speichern Sie Ihr Template.

Herzlichen Glückwunsch! Sie nutzen jetzt die deutlich verbesserte Clerk.js 2 Einrichtung!

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