การลบล้างการตั้งค่าเป็นวิธีที่ส่วนขยายจะลบล้างการตั้งค่า Chrome ที่เลือกไว้ API พร้อมใช้งานใน Windows ใน Chrome เวอร์ชันปัจจุบันทุกเวอร์ชัน และพร้อมใช้งานใน Mac ใน Chrome 56 ขึ้นไป
หน้าแรก ผู้ให้บริการการค้นหา และหน้าเริ่มต้นใช้งาน
ต่อไปนี้เป็นตัวอย่างวิธีแก้ไขหน้าแรก ผู้ให้บริการการค้นหา และหน้าเริ่มต้นใช้งานในไฟล์ Manifest ของส่วนขยาย เว็บไซต์ที่ใช้ใน API การตั้งค่าต้องได้รับการยืนยัน (ผ่านเครื่องมือของผู้ดูแลเว็บ) ว่ามีความเกี่ยวข้องกับรายการนั้นใน 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",
...
}
การกำหนดค่า
คุณปรับแต่งค่าในไฟล์ Manifest ได้ด้วยวิธีต่อไปนี้
- ค่าทั้งหมดของพร็อพเพอร์ตี้
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 ของไฟล์ Manifest จะแทนที่ด้วยค่า "install_parameter" หากไม่มี "install_parameter" ระบบจะนำรายการ "__PARAM__" ออก โปรดทราบว่า "__PARAM__" ไม่สามารถเป็นส่วนหนึ่งของชื่อโฮสต์ โดยจะต้องอยู่ต่อจาก "/" แรกใน URL
ข้อมูลอ้างอิง
ส่วนขยายจะลบล้างพร็อพเพอร์ตี้ต่อไปนี้อย่างน้อย 1 รายการในไฟล์ Manifest ได้
homepage
(สตริง) - ไม่บังคับค่าใหม่สำหรับหน้าแรก
search_provider
(object) - ไม่บังคับเครื่องมือค้นหา
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 สตริงของพารามิเตอร์ของโพสต์ไปยัง suggested_url
สตริง (ไม่บังคับ) image_url_post_params สตริงพารามิเตอร์ของโพสต์ไปยัง image_url
อาร์เรย์ของสตริง (ไม่บังคับ) alternate_urls รายการรูปแบบ URL ที่สามารถใช้งานได้นอกเหนือจาก |search_url|
จำนวนเต็ม (ไม่บังคับ) prefilled_id รหัสของเครื่องมือค้นหาในตัวของ Chrome
boolean is_default ระบุว่าผู้ให้บริการค้นหาควรเป็นค่าเริ่มต้นหรือไม่
startup_pages
(อาร์เรย์ของสตริง) - ไม่บังคับอาร์เรย์ความยาวหนึ่งที่มี URL ที่จะใช้เป็นหน้าเริ่มต้นใช้งาน