src/chrome/common/extensions/docs/templates/articles/settings_override.html

   1 <h1>Settings Overrides</h1>
   2
   3 <p>
   4 Settings overrides are a way for extensions to override selected Chrome settings
   5 and user interface properties.
   6 </p>
   7
   8 <p>
   9 An extension can override one or more of the following properties:
  10 </p>
  11
  12 <p>
  13 <b>Bookmarks User Interface:</b>
  14 <ul>
  15   <li>
  16     Bookmark button: the "star" button that is used to bookmark
  17     pages. Extensions may remove this button using the settings overrides, and
  18     optionally replace it with a browser action or page action.
  19   </li>
  20
  21   <li>
  22     Bookmark shortcut: the shortcut key that is used to bookmark a page (Ctrl-D
  23     on Windows). Extensions may remove this shortcut via the settings overrides,
  24     and optionally bind their own command to it using the <code>commands</code>
  25     section of the manifest.
  26   </li>
  27 </ul>
  28 </p>
  29
  30 <p class="note">
  31 <b>Note:</b> Settings overrides are only enabled in the Chrome Dev release, and
  32 Chrome must be started with the <code>--enable-override-bookmarks-ui=1</code>
  33 command line flag to enable bookmarks user interface overrides.</p>
  34
  35 <h2 id="manifest">Manifest</h2>
  36
  37 <p>
  38 Register settings overrides in the
  39 <a href="manifest.html">extension manifest</a> like this:
  40 </p>
  41
  42 <pre>{
  43   "name": "My extension",
  44   ...
  45 <b>
  46   "chrome_settings_overrides" : {
  47     "bookmarks_ui": {
  48       "remove_button": "true",
  49       "remove_bookmark_shortcut": "true"
  50     }
  51   }</b>,
  52   ...
  53 }</pre>