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 Funktionalitäten hinzufügen.

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

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

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

Beispiel-Formatter #

Ein Beispiel finden Sie unten. 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, 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;
  }
}

Verwendung in Designs #

Nachdem Sie Ihre Formatters erstellt haben, können Sie diese in Ihren Designs mit folgender Syntax verwenden:

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

Damit 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 fernzuhalten.

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

Sie können dies beheben, indem Sie die Anmeldedaten 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.

Damit wird die Installation von Clerk in jedem Webshop einfacher.

Da sich die beiden Versionen jedoch leicht unterschiedlich verhalten, müssen Sie folgende Schritte befolgen, um erfolgreich zu upgraden.

Die zwei Hauptunterschiede 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 im Template Ihres Webshops eingefügt werden.

Designs erstellen #

Da Clerk.js 2 einen anderen Ansatz für Designs verwendet, müssen Sie neue erstellen.

Sie können Ihre Clerk.js 2 Designs auf zwei Arten erstellen:

• Nutzen 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.

Option Design Editor #

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

2. Vergeben Sie auf dem folgenden Bildschirm einen Namen für Ihr Design (wir empfehlen, “V2” hinzuzufügen, damit klar ist, dass Sie Clerk.js 2 verwenden).

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

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

5. Im Design Editor können Sie bestehende Elemente wie Name, Bild, Button etc. anklicken, um sie zu bearbeiten, oder neue Elemente hinzufügen, um weitere Produktinformationen einzubinden.

6. Klicken Sie auf Publish, wenn Sie fertig sind, und gehen Sie im Leitfaden zu Schritt 2.

7. Navigieren Sie zu Recommendations/Search > Elements und ändern Sie Ihr Clerk Element, damit es Ihr neues Design verwendet.

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

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

Skript austauschen #

1. Suchen Sie die Template-Datei, die für die Anzeige aller Seiten im Webshop verwendet wird und in der das ursprüngliche Clerk.js-Skript am unteren Rand zu finden ist.

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 ins Template ein:

5. Speichern Sie Ihr Template.

Herzlichen Glückwunsch! Sie verwenden jetzt die deutlich verbesserte Clerk.js 2-Installation!

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