الامتثال لسياسات المتصفح
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 من المكتبة.المتطلبات
قبل ما تبدا، تأكد من:- الإضافة ديالك كتستخدم Manifest V3.
- الكود ديالك منظم بطريقة مجمعة، باستخدام Webpack، Rollup، أو مجمعات أخرى. إذا ما عندكش مجمع مضبوط، أولا تابع الدليل هنا
تثبيت حزمة npm
باش تثبت حزمة npm، تقدر تشغل الأمر التالي في الطرفية ديالك:Yarn
Yarn
إذا كنت كتستخدم yarn كمدير حزم، تقدر تشغل الأمر التالي:
قرر التنفيذ
كاين جوج طرق تقدر تنفذ بها المكتبة في الإضافة ديالك. إذا كنت غادي تطلق الإضافة لأول مرة في متجر الويب تابع الخيار 1. إذا كان عندك الإضافة منشورة بالفعل في متجر الويب قرا “كيفاش تقرر؟“كيفاش تقرر؟
منين كتثبت الإضافة ديالك من متجر الويب، واش كتظهر نافذة تنبيه كتطلب الإذن بـ “قراءة وتغيير جميع البيانات ديالك على جميع المواقع”؟ كتبان بحال هادي:
الخيار 1
إذا كنت غادي تطلق الإضافة لأول مرة في متجر الويب أو كنت كتحمل المكتبة في إضافة كتطلب الإذن بالعمل على جميع المواقع، تقدر تابع الخيار 1.ضبط الملف التعريفي ديالك
في ملف manifest.json ديالك عدل الأقسامpermissions و host_permissions بحال هكا:
ضبط عامل الخدمة (سكريبت الخلفية) ديالك
في ملف عامل الخدمة ديالك، خاصك تستورد حزمةmellowtel.
ملاحظة: عامل الخدمة كيعرف أيضا بـ سكريبت الخلفية.
تقدر تنسخ وتلصق الكود التالي في ملف عامل الخدمة ديالك بتغيير configuration_key بالمفتاح ديالك.
تفصيل كود عامل الخدمة
تفصيل كود عامل الخدمة
استورد حزمة mellowtelتقدر من بعد تستخدم بدا Mellowtel باستدعاء طريقة
Mellowtel(configuration_key, options?) لإنشاء نسخة جديدة من كائن Mellowtel. كائن Mellowtel هو نقطة الدخول ديالك لباقي SDK ديال Mellowtel. configuration_key ديالك مطلوب عند استدعاء هاد الوظيفة، حيث كيعرف الإضافة ديالك لـ Mellowtel. تقدر تلقى configuration_key ديالك في لوحة التحكم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، المستخدمين خاصهم يختارو بشكل صريح الاشتراك في الخدمة. تقدر تنفذ منطق الاشتراك/إلغاء الاشتراك بجوج طرق:- باستخدام التنفيذ الموصى به مع الصفحة الجاهزة المقدمة من Mellowtel.
- إنشاء عناصر الاشتراك/إلغاء الاشتراك الخاصة بك واستخدام الطرق الموضحة هنا
إذا اخترت إنشاء عناصر الاشتراك/إلغاء الاشتراك الخاصة بك، فكر في استخدام عناصر Mellowtel - مكونات واجهة مستخدم جاهزة كتعالج موافقة المستخدم والإعدادات بجهد تكامل بسيط.
عامل الخدمة ديالك (المعروف أيضا بسكريبت الخلفية) وأضف الكود التالي:
توليد رابط الإعدادات
باش تخلي المستخدمين ديالك عندهم تحكم كامل في عرض النطاق الترددي ديالهم، مطلوب أنك تخلي طريقة سهلة للوصول لتغيير الإعدادات ديالهم في أي لحظة. تقدر تولد رابط باستخدام الطريقةgenerateSettingsLink().
هاد الطريقة غادي ترجع رابط غادي يفتح صفحة إعدادات Mellowtel فين المستخدمين يقدرو يقررو في أي وقت واش بغاو يشتركو أو يلغيو الاشتراك.
هاد الرابط خاصو يكون داخل النافذة المنبثقة، صفحة الخيارات أو أي مكان آخر فين المستخدمين يقدرو يوصلولو بسهولة.
مثلا تقدر تحطو في وظيفة openSettings() بحال هكا. تقدر تستدعي openSettings() عند الضغط على زر أو أي حدث آخر مناسب: