application-search-engines.rst (1456B)
1 Application Search Engines 2 ========================== 3 4 Firefox defines various application search engines that are shipped to users. 5 6 The extensions for the definitions of these engines live in 7 :searchfox:`browser/components/search/extensions <browser/components/search/extensions>` 8 9 Icons 10 ----- 11 12 Icon Requirements 13 ~~~~~~~~~~~~~~~~~ 14 15 It is preferred that each engine is shipped with a ``.ico`` file with two sizes 16 of image contained within the file: 17 18 * 16 x 16 pixels 19 * 32 x 32 pixels 20 21 Some engines also have icons in 22 :searchfox:`browser/components/topsites/content/tippytop <browser/components/topsites/content/tippytop>`. 23 For these engines, there are two sizes depending on the subdirectory: 24 25 * ``favicons/``: 32 x 32 pixels 26 * ``images/``: preferred minimum of 192 x 192 pixels 27 28 Updating Icons 29 ~~~~~~~~~~~~~~ 30 31 To update icons for application search engines: 32 33 * Place the new icon file in the :searchfox:`folder associated with the search engine <browser/components/search/extensions>`. 34 * Increase the version number in the associated manifest file. This ensures 35 that the add-on manager properly updates the engine. 36 * Be aware that the :searchfox:`allowed-dupes.mn file <browser/installer/allowed-dupes.mn>` 37 lists some icons that are intended as duplicates. 38 39 To update icons for tippytop: 40 41 * Place the new icon file in :searchfox:`both the sub-folders within the tippytop directory <browser/components/topsites/content/tippytop>`.