Eigenen Button verwenden

Installation feedbackWidget: false + Blipit.openReport()

Das Browser-SDK setzt in jede Seite einen Button „Fehler melden“ in die Ecke. Hat Ihre App bereits ein Hilfemenü oder einen Button in der Kopfzeile, schalten Sie den schwebenden Button ab und öffnen denselben Reporter von dort: Screenshot, Anmerkungen, Elementauswahl, Aufnahme und Kontext funktionieren genauso.

1Schwebenden Button abschalten

Übergeben Sie feedbackWidget: false an init. Nur der Button verschwindet; der Reporter lädt beim Öffnen weiterhin die Widget-Einstellungen Ihres Projekts.

html
<script src="https://blipit.io/sdk/0.3.2/blipit.js"></script>
<script>
  Blipit.init({ key: "<public key>", feedbackWidget: false });
</script>

2Reporter von einem beliebigen Element öffnen

attachReport(element) öffnet den Reporter, wenn auf das Element geklickt wird. openReport() öffnet ihn aus Ihrem eigenen Code, etwa aus einem Menüeintrag oder per Tastenkürzel.

html
<button id="report-bug">Report a bug</button>
<script>
  Blipit.attachReport(document.getElementById("report-bug"));
</script>
Aus Ihrem eigenen Code
menu.on("report", () => Blipit.openReport());

3React und Next.js

@blipit/nextjs und @blipit/browser exportieren openReport und attachReport. Übergeben Sie feedbackWidget={false} an die Blipit-Komponente und rufen Sie openReport() aus einer beliebigen Client-Komponente auf.

tsx
"use client";
import { Blipit, openReport } from "@blipit/nextjs";

export function Monitoring() {
  return <Blipit publicKey={process.env.NEXT_PUBLIC_BLIPIT_KEY!} feedbackWidget={false} />;
}

export function ReportBug() {
  return <button onClick={() => openReport()}>Report a bug</button>;
}

4Oder den schwebenden Button behalten, nur als Symbol

Wenn Sie den schwebenden Button behalten, ihn aber kleiner möchten, wählen Sie im Dashboard in den Einstellungen des Fehlermelde-Widgets des Projekts unter Button-Stil „Nur Symbol“ oder setzen Sie style im Code. Der Button wird zu einem runden Symbol in derselben Farbe; sein Text bleibt als Tooltip und Screenreader-Beschriftung erhalten. Optionen im Code haben Vorrang vor dem Dashboard.

js
Blipit.init({ key: "<public key>", feedbackWidget: { style: "icon" } });

Gut zu wissen

  • Der Reporter selbst (blipit-report.js) wird beim ersten Öffnen aus demselben Ordner wie blipit.js geladen. Fügen Sie daher https://blipit.io zu script-src hinzu, wenn Ihre Website eine Content Security Policy hat.
  • Wird der Button im Dashboard ausgeblendet, verschwindet er auf jeder Website mit diesem Schlüssel; openReport() und attachReport() funktionieren dort trotzdem.

Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und den genauen DSN jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.