การลบล้างการตั้งค่า 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 คือ ตั้งค่า

    สตริง (ไม่บังคับ)recommended_url

    หากละไว้ หมายความว่าเครื่องมือนี้ไม่รองรับคำแนะนำ

    สตริง (ไม่บังคับ) image_url

    หากละไว้ เครื่องมือค้นหานี้จะไม่รองรับการค้นหารูปภาพ

    สตริง (ไม่บังคับ) search_url_post_params

    สตริงของพารามิเตอร์โพสต์ไปยัง search_url

    สตริง (ไม่บังคับ)suggested_url_post_params

    สตริงของพารามิเตอร์โพสต์ที่จะแนะนำ url

    สตริง (ไม่บังคับ) image_url_post_params

    สตริงของพารามิเตอร์โพสต์ไปยัง image_url

    อาร์เรย์ของสตริง (ไม่บังคับ)ทางเลือก_urls

    รายการรูปแบบ URL ที่ใช้ได้นอกเหนือจาก |search_url|

    จำนวนเต็ม (ไม่บังคับ) ที่มีการป้อนข้อมูลล่วงหน้า _id

    รหัสของเครื่องมือค้นหาในตัวใน Chrome

    boolean is_default

    ระบุว่าผู้ให้บริการค้นหาควรเป็นค่าเริ่มต้นหรือไม่

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

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