لغو تنظیمات راهی برای برنامههای افزودنی برای لغو تنظیمات انتخابی Chrome است. API در ویندوز و مک در تمام نسخههای کنونی Chrome در دسترس است.
صفحه اصلی، ارائه دهنده جستجو و صفحات راه اندازی
در اینجا نمونهای از نحوه تغییر صفحه اصلی ، ارائهدهنده جستجو و صفحات راهاندازی در مانیفست پسوند آورده شده است. هر دامنه ای که در تنظیمات API استفاده می شود باید (از طریق کنسول جستجوی Google) توسط همان حساب توسعه دهنده ای که برنامه افزودنی را منتشر می کند تأیید شود. توجه داشته باشید که اگر مالکیت یک دامنه (مثلاً https://example.com) را تأیید کنید، میتوانید از هر زیردامنه یا صفحه (مثلاً https://app.example.com یا https://example.com/) استفاده کنید. page.html) در پسوند شما.
استفاده از مجوز لغو تنظیمات در حالی که درخواست هر گونه قابلیت یا مجوز اضافی با خط مشی یک هدف ما مطابقت ندارد. وقتی Chrome تشخیص دهد که یک مورد به طور بالقوه خط مشی تک هدف ما را نقض می کند، یک گفتگوی تأیید به کاربر نشان داده می شود. برنامههای افزودنی که خود را محدود به تغییر تنها یک تنظیم بدون جستجوی قابلیتها یا مجوزهای اضافی میکنند، گفتگوی تأیید دریافت نمیکنند.
این برای Chrome 107 و نسخههای جدیدتر اعمال میشود.
{
"name": "My extension",
...
"chrome_settings_overrides": {
"homepage": "https://www.homepage.com",
"search_provider": {
"name": "name.__MSG_url_domain__",
"keyword": "keyword.__MSG_url_domain__",
"search_url": "https://www.foo.__MSG_url_domain__/s?q={searchTerms}",
"favicon_url": "https://www.foo.__MSG_url_domain__/favicon.ico",
"suggest_url": "https://www.foo.__MSG_url_domain__/suggest?q={searchTerms}",
"instant_url": "https://www.foo.__MSG_url_domain__/instant?q={searchTerms}",
"image_url": "https://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": [
"https://www.moo.__MSG_url_domain__/s?q={searchTerms}",
"https://www.noo.__MSG_url_domain__/s?q={searchTerms}"
],
"encoding": "UTF-8",
"is_default": true
},
"startup_pages": ["https://www.startup.com"]
},
"default_locale": "de",
...
}
سفارشی کردن ارزش ها
مقادیر موجود در مانیفست را می توان به روش های زیر سفارشی کرد:
- همه مقادیر
search_provider
,homepage
وstartup_pages
را می توان با استفاده ازchrome.i18n
API بومی سازی کرد. برای برنامه های افزودنی خارجی ، مقادیر 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 رخ دهد.
مرجع
یک برنامه افزودنی می تواند یک یا چند ویژگی زیر را در مانیفست لغو کند:
-
alternate_urls
(آرایه از رشته ها، اختیاری) - لیستی از الگوهای URL که می توانند علاوه بر
search_url.
-
encoding
(رشته، اختیاری) - رمزگذاری مورد استفاده برای عبارات جستجو اگر
prepopulated_id
را تنظیم نکنید، این مورد ضروری است. -
favicon_url
(رشته، اختیاری) - نشانی اینترنتی نماد برای موتور جستجو. اگر
prepopulated_id
را تنظیم نکنید، این مورد ضروری است. -
homepage
(رشته، اختیاری) - مقدار جدید برای صفحه اصلی.
-
image_url
(رشته، اختیاری) - URL که موتور جستجو برای جستجوی تصویر استفاده می کند. اگر از این استفاده نمی شود، موتور از جستجوی تصویر پشتیبانی نمی کند.
-
image_url_post_params
(رشته، اختیاری) - پارامترهای پست برای
image_url
. -
is_default
(بولی، مورد نیاز) - مشخص می کند که آیا ارائه دهنده جستجو باید پیش فرض باشد یا خیر.
-
keyword
(رشته، اختیاری) - یک کلمه کلیدی omnibox برای موتور جستجو. اگر
prepopulated_id
را تنظیم نکنید، این مورد ضروری است. -
name
(رشته، اختیاری) - نام موتور جستجو به کاربر نمایش داده می شود. اگر
prepopulated_id
را تنظیم نکنید، این مورد ضروری است. -
prepopulated_id
(عدد صحیح، اختیاری) - شناسه موتور جستجوی داخلی کروم.
-
search_provider
(شیء، اختیاری) - یک موتور جستجو
-
search_url
(رشته، مورد نیاز) - URL جستجویی که موتور جستجو استفاده می کند.
-
search_url_post_params
(رشته، اختیاری) - پارامترهای پست برای
search_url
. -
startup_pages
(آرایه از رشته ها، اختیاری) - آرایه ای به طول یک که حاوی یک URL برای استفاده به عنوان صفحه راه اندازی است.
-
suggest_url
(رشته، اختیاری) - URL که موتور جستجو برای پیشنهادات استفاده می کند. اگر از این استفاده نمی شود، موتور از پیشنهادات پشتیبانی نمی کند.
-
suggest_url_post_params
(رشته، اختیاری) - پارامترهای پست برای
suggest_url
.