Gecko.handlerService.schemes.(protocol).*.uriTemplate

From MozillaZine Knowledge Base

The title given to this article is incorrect due to technical limitations. The correct title is gecko.handlerService.schemes.(protocol).*.uriTemplate.

This article describes the preference gecko.handlerService.schemes.(protocol).*.uriTemplate. To add, delete, or modify this preference, you will need to edit your configuration — do not edit this article.

1 Background
2 Possible values and their effects
3 First checked in
4 Has an effect in
5 Related bugs
6 Related preferences
7 See also
8 External links

[edit]

Background

Firefox 3 allows web pages to register themselves as protocol handlers. This allows, for example, all links starting with mailto: to be sent to a webmail provider, or all links starting with webcal: to be sent to an online calendar site. The information on these registrations is kept in mimeTypes.rdf

A set of preferences exists to “seed” the list of registered content handlers. Information from these preferences is copied into mimeTypes.rdf every time the browser sees a new version of content handlers. This preference is an enumerated preference: all preferences whose names start with gecko.handlerService.schemes. are read to generate the list of handlers. (For example: gecko.handlerService.schemes.webcal.0.name and gecko.handlerService.schemes.webcal.0.uriTemplate describe one handler for the webcal: protocol.)

This preference determines the URI template for a content handler for a given protocol. Similar to bookmark keywords, the value can contain the string %s that is replaced with the rest of the link. If the value were http://example.com/?process=%s and the link were to protocol:sample-value, then the browser would be directed to http://example.com/?process=sample-value.

[edit]

Possible values and their effects

A string used to generate the URI for a web-based protocol handler. If the string %s is present in the value, it is replaced with the rest of the link.

By default, the following preference and value exist: