الخلفية
لون واحد بصيغة #RRGGBB. يقود الزرّ وإطار أداة الالتقاط والأزرار الأساسية ولون التعليق
الافتراضي. والافتراضي #17133A، حبر uMarker.
كل مشروع يحمل إعدادات ودجت خاصّة فيه: اللون، ونصّ الزرّ وموضعه، والشعار، والأدوات اللي تعرضها واجهة الالتقاط. تعدّلها مرّة باللوحة، والودجت الشغّال يقرأها من جديد بأول تحميل جاي. يعني التغيير يصير مباشراً لكل زائر بدون ما تلمس السنيبت.
افتح مشروعك ← الودجت ← الإعداد. الشاشة لوحان: التحكّم بجهة، ومعاينة حيّة بالجهة الثانية تُعاد رسمها وأنت تكتب، فتشوف الزرّ بالضبط زي ما بيشوفه زوّارك. والإعدادات تُفحَص عند الحفظ؛ والمُدخَل غير الصالح يُرفض برسالة واضحة، وتبقى إعداداتك الصالحة السابقة شغّالة، فالودجت الشغّال ما ينكسر أبداً.
الخلفية
لون واحد بصيغة #RRGGBB. يقود الزرّ وإطار أداة الالتقاط والأزرار الأساسية ولون التعليق
الافتراضي. والافتراضي #17133A، حبر uMarker.
النصّ
لون الحبر فوق تلك الخلفية. خلّه على تلقائي فيحسبه uMarker من إضاءة WCAG النسبية (قريب من الأسود على علامة فاتحة، وأبيض على علامة داكنة)، أو اختر لونك بنفسك.
الشعار
علامتك، تظهر في زرّ الملاحظات على السطحين. PNG أو JPG أو WebP أو GIF أو SVG، حتى 512 كيلوبايت. والنوع يُحدَّد من بايتات الملفّ لا من اسمه، وملفّ SVG يُعقَّم قبل ما يُخزَّن.
لون العلامة يُفحَص بـ^#[0-9a-fA-F]{6}$؛ وأي قيمة مشوّهة تُرفض عند الحفظ. وأي إعداد تتركه فاضياً
يرجع للافتراضي فوق، فالودجت دايماً قابل للرسم ويطلع مرتّباً من أول مرّة.
التسمية اللي على زرّ الملاحظات. هي على موقعك وأمام زوّارك، فهي إعداد الودجت الوحيد اللي ياخذ لغة: تقدر تكتبها بالعربي وبالإنجليزي، وكل زائر يجيه اللي يطابق لغة الصفحة اللي هو واقف عليها.
حتى 40 محرفاً. ولو تركتها فاضية يستخدم الودجت كلمته المدمجة بلغة الزائر، وهذا مو نفس إنك تسمّي زرّك «ملاحظات»، واللوحة تفرّق بين الحالتين.
ستّة مواضع، مو أربعة:
| القيمة | كيف تنرسم |
|---|---|
bottom-right · bottom-left · top-right · top-left |
زرّ بيضاوي في تلك الزاوية، مزاح شوي عن الحافّة. |
center-right · center-left |
تبويب عمودي ملاصق لمنتصف ذلك الجانب، مدوّر من الحافّة الداخلية. |
والمُنتقي بصري، فيه ستّ نقاط ارتكاز: أربع نقاط للزوايا وقضيبان للمنتصف. وينزل العلامة مكان ما تنقر. والموضع يسري على الزرّ في السطحين — السنيبت والإضافة يرسمونه بنفس الشكل — وفوق كذا مختبِرو الإضافة يقدرون يفتحون الأداة من شريط المتصفّح كمان، مو من الزرّ وحده.
شريط أدوات المُبلِّغ. والمشروع يقرّر أي أدوات تظهر وبأي ترتيب، والأولى هي الافتراضية، يعني الأداة المختارة أصلاً لمّا تفتح واجهة الالتقاط.
| الأداة | وش يسوّي فيها المُبلِّغ |
|---|---|
| فحص عنصر | يمرّر على الصفحة، فيضيء أعمق عنصر تحت المؤشّر مع نموذج الصندوق: المحتوى والحشو والهوامش. ينقر عشان يثبّت دبوساً على ذلك العنصر. و↑ ↓ تطلع وتنزل بالشجرة، وأشرطة الهوامش البرتقالية نفسها قابلة للنقر، فيقدر يعلّق على المسافة بدل الصندوق. |
| تعليق | ينزل دبوساً مرقّماً بأي مكان ويفتح ملاحظته. |
| تظليل | يؤطّر منطقة. |
| رسم | خطّ حرّ. |
| تصفّح | وضع تصفّح: ينقر بالصفحة عادي لين يوصل للحالة اللي يبغى يبلّغ عنها، بدون ما يطلع من الأداة. |
فحص عنصر وتصفّح متاحتان دايماً حتى لو ما كانتا بقائمتك المحفوظة، لأنّ وحدة هي اللي توصّل المُبلِّغ للشاشة الصحيحة، والثانية هي اللي تخلّي التقرير دقيقاً. وكل علامة تحمل ملاحظتها، وكل ملاحظة تصير خيط تعليقات على الدبوس يقدر فريقك يردّ عليه ويحلّه لحاله في صفحة التقرير.
اللوحة اللي يختار منها المُبلِّغ. لون علامتك دايماً أول وحدة ودايماً الافتراضي؛ وتقدر تضيف حتى خمسة غيره. ولو تركت القائمة فاضية، يجي بعد لون علامتك خمسة ألوان قياسية من مجموعة ثابتة من ستّة — أحمر وكهرماني وأخضر وأزرق وبنفسجي وأسود — بعد استبعاد المكرّر مع لون علامتك، وبحدّ أقصى ستّ عيّنات. وما فيه شي في هالقائمة الاحتياطية يُحسب من لون علامتك.
بطاقة «ما الذي تلتقطه الملاحظة» في الودجت ← الإعداد هي اللي تحدّد كم تحمل الملاحظة. تنطبق على السنيبت والإضافة سواء، والملاحظة تحتفظ بالوضع اللي انرسلت فيه.
| الوضع | لمين | وش تحمل الملاحظة |
|---|---|---|
| عادي | لعملائك. الملاحظة تحمل بس اللي يورّونك إياه. | اللقطة، والعلامات والملاحظات، ورابط الصفحة (قيم الاستعلام اللي شكلها أسرار تُفرَّغ)، والجهاز: نوعه، والمتصفّح ونسخته، ونظام التشغيل، واللغة، ومقاس الشاشة والنافذة. وفي الإضافة: هوية المختبِر. |
| تقني | لفريقك والمختبِرين. يضيف اللي يحتاجه المطوّر عشان يعيد إنتاج العلّة. | كل اللي في العادي، وفوقه كل طلب سوّته الصفحة (الفاشل والبطيء موسوم)، ورسائل الكونسول، وأخطاء JavaScript مع الـstack، وأرقام الأداء، ومسار النقرات والتنقّل الأخير، وتفاصيل الاتصال والبيئة. |
المشاريع الجديدة تبدأ على العادي. والمشاريع اللي كانت موجودة قبل أوضاع الالتقاط انضبطت على التقني، عشان ما يضيع شي كانت تلتقطه. الوضعان متاحان في كل الباقات، وأي أحد مسموح له يدير الودجت يقدر يبدّل. والتغيير يطبَّق من تحميل الصفحة التالي عند الزائر، والملاحظات المرسلة قبله تحتفظ باللي فيها.
العادي مُنفَّذ مو مجرّد طلب: الصفحة ما تركّب أي مسجِّل، والخادم يرمي أي بيانات تقنية توصل لمشروع على العادي (نسخة إضافة قديمة، أو ودجت مخزَّن، أو طلب مكتوب باليد).
رابط اختياري يظهر جنب زرّ الإرسال وعلى شاشة التأكيد، قبل ما يغادر أي شي الصفحة. وجّهه لإشعار
الخصوصية عندك. ويُفحَص على الخادم إنه http(s). أمّا بقيّة ضوابط الخصوصية (تمويه القيم المكتوبة،
ومُحدِّداتك الحسّاسة دايماً) فهي بنفس الشاشة ومشروحة في
السياق التقني وإخفاء البيانات.
ما تعيد نشر السنيبت أبداً لمّا تغيّر إعداداً. مع كل تحميل صفحة، الودجت يجيب إعداداته ويطبّقها قبل ما يُركَّب:
الودجت ينادي GET /api/public/widget/{key}/config على أصل الـAPI.
الردّ يحمل active، واسم المشروع، وهل يظهر سطر «Powered by uMarker»، وكائن settings فيه كل اللي
يحتاجه للرسم:
{ "active": true, "project": { "id": 1, "name": "Acme Web" }, "branding": true, "settings": { "brand_color": "#17133A", "text_color": "#ffffff", "button_position": "bottom-right", "launcher_text": "ملاحظاتك", "annotation_colors": [], "enabled_tools": ["inspect", "comment", "highlight", "pen", "pointer"], "enabled_fields": [], "logo": "data:image/png;base64,…", "privacy_url": null, "targeting": { "url_rules": [], "devices": ["desktop","tablet","mobile"], "audience": "everyone", "frequency": { "mode": "always", "n": 1 } }, "capture_mode": "normal", "enrichment": { "pinpoint": false, "redaction": false, "breadcrumb_count": 20, "sensitive_selectors": [] } }}الودجت يقيّم الاستهداف على الصفحة الحالية، وبعدها فقط يُركَّب بإعداداتك.
الشعار يُضمَّن كرابط data:، فما فيه طلب ثانٍ له. وcapture_mode قيمته "normal" أو "technical"،
والودجت يقرأه قبل ما يركّب أي مسجِّل، فمشروع على العادي ما يجمع شي تقني في الصفحة إطلاقاً. وlauncher_text يحلّه الخادم للغة الزائر قبل ما
يرسله. وenabled_fields دايماً فاضية: هي بقيّة خاملة من حقول النموذج المتقاعدة، مُبقاة عشان القيم
القديمة المخزّنة تنحلّ إلى لا شي.