Skip to main content
هنا غادي تشوف كيفاش تطبق مكتبة Mellowtel في مشروع إضافة Chrome/Edge ديالك. الوقت المقدر للإكمال: 5-7 دقايق.

الامتثال لسياسات المتصفح

Mellowtel متوافق مع سياسات المتصفح إذا كان التكامل كيحترم اختيارات وإعدادات المستخدمين. الإضافات الرسمية ديال Mellowtel متوفرة على Chrome و Edge. قريبا غادي نقدموهم حتى للمتصفحات الرئيسية الأخرى. Chrome: https://chromewebstore.google.com/detail/support-with-mellowtel/jngbedjpioeongcicaomeideeompcbcc Edge: https://microsoftedge.microsoft.com/addons/detail/support-with-mellowtel/chpomjnojnimgcaomhmcmfgjinfoekhi على Chrome، بعض المطورين قد يواجهوا مشاكل أثناء المراجعة مع سياسة الغرض الواحد، اللي كتقول أن الإضافة يمكنها فقط يكون عندها وظيفة واحدة واضحة (لكن غالبا ما كتفسر بشكل غير متسق عبر الإضافات متعددة الوظائف). في هاد الحالات، كنوصيو المطورين يشاركو الرابط الشخصي ديالهم ويطلبو من المستخدمين تثبيت الإضافة الرسمية ديال Mellowtel اللي عندها الغرض الواحد اللي هو السماح للمطورين يربحو بفضل المستخدمين اللي بغاو يدعموهم بمشاركة الموارد الخاملة ديالهم. المطورين يقدرو ينشئو الرابط ديالهم من لوحة التحكم ديال Mellowtel ويوجهو المستخدمين للإضافة الرسمية ديال Mellowtel على Chrome. إذا كان عندك إضافة على Chrome كتعمل في مجال مشاركة عرض النطاق الترددي للذكاء الاصطناعي وهاد هو الغرض الوحيد من الإضافة، تقدر تدمج Mellowtel مباشرة في الإضافة ديالك. بالمقابل، Edge، Firefox، أو Safari ما عندهمش هاد السياسة، لذلك المطورين يقدرو يدمجو المكتبة مباشرة في المنتجات ديالهم ويتأكدو أنهم يسألو المستخدمين واش بغاو يدعموهم أو لا ويخليوهم دائما طريقة سهلة لتغيير الإعدادات ديالهم في أي وقت من الإضافة نفسها.

المتصفحات الموصى بها

حاليا، كنوصيو بدمج Mellowtel في إضافات Edge حيث ما زلنا نعمل على تحسين نسخ Firefox و Safari من المكتبة.

المتطلبات

قبل ما تبدا، تأكد من:
  1. الإضافة ديالك كتستخدم Manifest V3.
  2. الكود ديالك منظم بطريقة مجمعة، باستخدام Webpack، Rollup، أو مجمعات أخرى. إذا ما عندكش مجمع مضبوط، أولا تابع الدليل هنا

تثبيت حزمة npm

باش تثبت حزمة npm، تقدر تشغل الأمر التالي في الطرفية ديالك:
إذا كنت كتستخدم yarn كمدير حزم، تقدر تشغل الأمر التالي:

قرر التنفيذ

كاين جوج طرق تقدر تنفذ بها المكتبة في الإضافة ديالك. إذا كنت غادي تطلق الإضافة لأول مرة في متجر الويب تابع الخيار 1. إذا كان عندك الإضافة منشورة بالفعل في متجر الويب قرا “كيفاش تقرر؟“

كيفاش تقرر؟

منين كتثبت الإضافة ديالك من متجر الويب، واش كتظهر نافذة تنبيه كتطلب الإذن بـ “قراءة وتغيير جميع البيانات ديالك على جميع المواقع”؟ كتبان بحال هادي:
إذا كانت كتظهر، تقدر تابع الخيار 1. إذا ما كانتش كتظهر، خاصك تابع الخيار 2.

الخيار 1

إذا كنت غادي تطلق الإضافة لأول مرة في متجر الويب أو كنت كتحمل المكتبة في إضافة كتطلب الإذن بالعمل على جميع المواقع، تقدر تابع الخيار 1.

ضبط الملف التعريفي ديالك

في ملف manifest.json ديالك عدل الأقسام permissions و host_permissions بحال هكا:

ضبط عامل الخدمة (سكريبت الخلفية) ديالك

في ملف عامل الخدمة ديالك، خاصك تستورد حزمة mellowtel. ملاحظة: عامل الخدمة كيعرف أيضا بـ سكريبت الخلفية. تقدر تنسخ وتلصق الكود التالي في ملف عامل الخدمة ديالك بتغيير configuration_key بالمفتاح ديالك.
استورد حزمة mellowtel
تقدر من بعد تستخدم Mellowtel(configuration_key, options?) لإنشاء نسخة جديدة من كائن Mellowtel. كائن Mellowtel هو نقطة الدخول ديالك لباقي SDK ديال Mellowtel. configuration_key ديالك مطلوب عند استدعاء هاد الوظيفة، حيث كيعرف الإضافة ديالك لـ Mellowtel. تقدر تلقى configuration_key ديالك في لوحة التحكم
بدا Mellowtel باستدعاء طريقة initBackground. هاد الطريقة غادي تبدا كائن Mellowtel وتضبط المستمعين الضروريين.

ضبط سكريبت المحتوى ديالك

خاصك تستورد حزمة mellowtel في سكريبتات المحتوى أيضا. هاد سكريبت المحتوى خاصو يتشغل في all_frames و <all_urls> عند document_start. كنقترحو إنشاء سكريبت محتوى جديد (مثلا content_start_mellowtel.js) فين تقدر تنسخ وتلصق الكود التالي. غير configuration_key بالمفتاح ديالك.
من بعد تذكر تضيف هاد سكريبت المحتوى في ملف manifest.json ديالك في قسم content_scripts بجانب أي سكريبت محتوى آخر عندك. تقدر تنسخ وتلصق الكود التالي بتغيير name_of_your_content_script.js بالاسم اللي اخترتي.

ضبط منطق الاشتراك/إلغاء الاشتراك

باش تفعل Mellowtel، المستخدمين خاصهم يختارو بشكل صريح الاشتراك في الخدمة. تقدر تنفذ منطق الاشتراك/إلغاء الاشتراك بجوج طرق:
  1. باستخدام التنفيذ الموصى به مع الصفحة الجاهزة المقدمة من Mellowtel.
  2. إنشاء عناصر الاشتراك/إلغاء الاشتراك الخاصة بك واستخدام الطرق الموضحة هنا
إذا اخترت إنشاء عناصر الاشتراك/إلغاء الاشتراك الخاصة بك، فكر في استخدام عناصر Mellowtel - مكونات واجهة مستخدم جاهزة كتعالج موافقة المستخدم والإعدادات بجهد تكامل بسيط.
إذا استخدمت التنفيذ الموصى به، افتح ملف عامل الخدمة ديالك (المعروف أيضا بسكريبت الخلفية) وأضف الكود التالي:

توليد رابط الإعدادات

باش تخلي المستخدمين ديالك عندهم تحكم كامل في عرض النطاق الترددي ديالهم، مطلوب أنك تخلي طريقة سهلة للوصول لتغيير الإعدادات ديالهم في أي لحظة. تقدر تولد رابط باستخدام الطريقة generateSettingsLink(). هاد الطريقة غادي ترجع رابط غادي يفتح صفحة إعدادات Mellowtel فين المستخدمين يقدرو يقررو في أي وقت واش بغاو يشتركو أو يلغيو الاشتراك. هاد الرابط خاصو يكون داخل النافذة المنبثقة، صفحة الخيارات أو أي مكان آخر فين المستخدمين يقدرو يوصلولو بسهولة. مثلا تقدر تحطو في وظيفة openSettings() بحال هكا. تقدر تستدعي openSettings() عند الضغط على زر أو أي حدث آخر مناسب:
مزيان! دابا راك جاهز تبعث الإضافة ديالك لمتجر الويب. تابع الدليل هنا باش تشوف كيفاش تقدم الإضافة ديالك

الخيار 2

الخيار 2 ممكن يعطل الإضافة ديالك إذا ما تنفذش بشكل صحيح. لهذا السبب ما متاحش لجميع المستخدمين
إذا ما قدرتش تنفذ الخيار 1، من فضلك تواصل معنا على Discord