استخدم زرك الخاص

1أوقف الزر العائم

مرّر feedbackWidget: false إلى init. يختفي الزر فقط؛ وتظل أداة الإبلاغ تحمّل إعدادات أداة مشروعك عند فتحها.

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

2افتح أداة الإبلاغ من أي عنصر

تفتح attachReport(element) أداة الإبلاغ عند النقر على العنصر. وتفتحها openReport() من شيفرتك، مثلًا من عنصر قائمة أو اختصار لوحة مفاتيح.

<button id="report-bug">Report a bug</button>
<script>
  Blipit.attachReport(document.getElementById("report-bug"));
</script>

menu.on("report", () => Blipit.openReport());

3React وNext.js

تصدّر الحزمتان ‎@blipit/nextjs و‎@blipit/browser الدالتين openReport وattachReport. مرّر feedbackWidget={false} إلى مكوّن Blipit، ثم استدعِ openReport() من أي مكوّن عميل.

"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>;
}

4أو أبقِ الزر العائم بأيقونة فقط

إذا أبقيت الزر العائم وأردته أصغر، فاختر «أيقونة فقط» ضمن «شكل الزر» في إعدادات أداة الإبلاغ عن الأخطاء للمشروع في لوحة التحكم، أو اضبط style في الشيفرة. يصبح الزر أيقونة دائرية باللون نفسه، ويبقى نصه تلميحًا وتسمية لقارئ الشاشة. الخيارات في الشيفرة تتقدّم على لوحة التحكم.

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

من المفيد معرفته

• تُحمَّل أداة الإبلاغ نفسها (blipit-report.js) عند أول فتح من المجلد نفسه الذي فيه blipit.js، لذا أضف https://blipit.io إلى script-src إذا كان لموقعك سياسة أمان محتوى (CSP).
• إخفاء الزر في لوحة التحكم يخفيه في كل موقع يستخدم المفتاح؛ وتظل openReport() وattachReport() تعملان هناك أيضًا.