إنّ عمليات إلغاء الإعدادات هي طريقة تتيح للإضافات إلغاء إعدادات Chrome المحدّدة. تتوفر واجهة برمجة التطبيقات على نظام التشغيل Windows في جميع الإصدارات الحالية من Chrome، كما تتوفر على نظام التشغيل Mac في الإصدار Chrome 56 واللاحقًا.
الصفحة الرئيسية ومقدِّم خدمة البحث وصفحات بدء التشغيل
في ما يلي مثال على طريقة تعديل الصفحة الرئيسية ومقدِّم خدمة البحث والصفحات الناشئة في بيان الإضافة. يجب إثبات ملكية مواقع الويب المستخدمة في واجهة برمجة تطبيقات الإعدادات (من خلال "أدوات مشرفي المواقع") باعتبارها مرتبطة بذلك العنصر في "سوق Chrome الإلكتروني". تجدر الإشارة إلى أنّه في حال إثبات ملكية نطاق (مثلاً، http://example.com)، يمكنك استخدام أي نطاق فرعي أو صفحة (مثل http://app.example.com أو http://example.com/page.html) داخل الإضافة.
{
"name": "My extension",
...
"chrome_settings_overrides": {
"homepage": "http://www.homepage.com",
"search_provider": {
"name": "name.__MSG_url_domain__",
"keyword": "keyword.__MSG_url_domain__",
"search_url": "http://www.foo.__MSG_url_domain__/s?q={searchTerms}",
"favicon_url": "http://www.foo.__MSG_url_domain__/favicon.ico",
"suggest_url": "http://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
"instant_url": "http://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
"image_url": "http://www.foo.__MSG_url_domain__/image?q={searchTerms}",
"search_url_post_params": "search_lang=__MSG_url_domain__",
"suggest_url_post_params": "suggest_lang=__MSG_url_domain__",
"instant_url_post_params": "instant_lang=__MSG_url_domain__",
"image_url_post_params": "image_lang=__MSG_url_domain__",
"alternate_urls": [
"http://www.moo.__MSG_url_domain__/s?q={searchTerms}",
"http://www.noo.__MSG_url_domain__/s?q={searchTerms}"
],
"encoding": "UTF-8",
"is_default": true
},
"startup_pages": ["http://www.startup.com"]
},
"default_locale": "de",
...
}
تخصيص القيم
يمكن تخصيص القيم في البيان بالطرق التالية:
- يمكن ترجمة جميع قيم الخصائص
search_providerوhomepageوstartup_pagesباستخدام واجهة برمجة التطبيقات chrome.i18n. بالنسبة إلى الإضافات الخارجية، يمكن ضبط قيم عناوين URL
search_providerوhomepageوstartup_pagesباستخدام مفتاح قاعدة بيانات المسجّلين. ويجب إنشاء إدخال سجل جديد بجانب المفتاح "update_url" (راجع الإرشادات هنا). اسم القيمة هو "install_parameter"، وتكون بيانات القيمة سلسلة عشوائية:{ "update_url": "https://clients2.google.com/service/update2/crx", "install_parameter": "Value" }سيتم استبدال جميع مواضع ورود السلسلة الفرعية "__PARAM__" في عناوين URL في ملف البيان بالقيمة "install_parameter". في حال عدم توفّر "install_parameter"، ستتم إزالة مواضع ورود "__PARAM__". تجدر الإشارة إلى أنه لا يمكن أن يكون "__PARAM__" جزءًا من اسم المضيف. يجب أن يظهر بعد "/" الأول في عنوان URL.
مَراجع
يمكن للإضافة إلغاء سمة واحدة أو أكثر من الخصائص التالية في البيان:
homepage(سلسلة نصية) - اختياريةقيمة جديدة للصفحة الرئيسية
search_provider(كائن) - اختياريمحرك بحث
Type السمة الوصف سلسلة الاسم (اختياري) اسم محرك البحث المعروض للمستخدم. ولا يمكن حذف هذه السمة إلا في حال ضبط prepopulated_id.
سلسلة كلمة رئيسية (اختياريّة) الكلمة الرئيسية للمربّع متعدد الاستخدامات لمحرك البحث ولا يمكن حذف هذه السمة إلا في حال ضبط prepopulated_id.
سلسلة (اختياري) favicon_url عنوان URL لرمز محرك البحث. لا يمكن حذف هذه السمة إلا في حال ضبط prepopulated_id.
سلسلة search_url عنوان URL للبحث يستخدمه محرك البحث.
سلسلة الترميز (اختياري) ترميز عبارة البحث. ولا يمكن حذف هذه السمة إلا في حال ضبط prepopulated_id.
سلسلة (اختياري)suggest_url وإذا تم حذفها، لن يكون هذا المحرك متوافقًا مع الاقتراحات.
سلسلة (اختياري) image_url في حال إسقاطه، لا يتيح هذا المحرك البحث عن الصور.
سلسلة (اختياري) search_url_post_params سلسلة مَعلمات المشاركة إلى search_url
سلسلة (اختياري)suggest_url_post_params سلسلة مَعلمات النشر المراد اقتراحها_url
سلسلة (اختياري) image_url_post_params سلسلة مَعلمات المشاركة إلى image_url
صفيف من السلسلة (اختياري) alternate_urls قائمة بأنماط عناوين URL التي يمكن استخدامها، بالإضافة إلى |search_url|.
عدد صحيح (اختياري) prefilled_id (معرّف_تعبئة_التعبئة) رقم تعريف محرك البحث المضمَّن في Chrome
boolean is_default تحدِّد هذه السياسة ما إذا كان يجب أن يكون مزود البحث هو الخيار التلقائي.
startup_pages(صفيف من السلاسل) - اختياريمصفوفة طولها واحدة تحتوي على عنوان URL لاستخدامه كصفحة بدء التشغيل.