การลบล้างการตั้งค่า Chrome

การลบล้างการตั้งค่าเป็นวิธีที่ส่วนขยายลบล้างการตั้งค่า 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 (ออบเจ็กต์) - ไม่บังคับ

  เครื่องมือค้นหา

  ประเภท	แอตทริบิวต์	คำอธิบาย
  สตริง	(ไม่บังคับ) ชื่อ	ชื่อเครื่องมือค้นหาที่แสดงต่อผู้ใช้ คุณละเว้นได้ก็ต่อเมื่อมีการตั้งค่า 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	สตริงพารามิเตอร์การโพสต์ไปยัง suggest_url
  สตริง	(ไม่บังคับ) image_url_post_params	สตริงพารามิเตอร์การโพสต์ไปยัง image_url
  อาร์เรย์สตริง	(ไม่บังคับ) alternate_urls	รายการรูปแบบ URL ที่ใช้ได้นอกเหนือจาก |search_url|
  จำนวนเต็ม	(ไม่บังคับ) ที่มีการป้อนข้อมูลล่วงหน้า _id	รหัสของเครื่องมือค้นหาในตัวใน Chrome
  boolean	is_default	ระบุว่าผู้ให้บริการค้นหาควรเป็นค่าเริ่มต้นหรือไม่

• startup_pages (อาร์เรย์ของสตริง) - ไม่บังคับ

  อาร์เรย์ที่มีความยาว 1 ที่มี URL ที่จะใช้เป็นหน้าเริ่มต้น