View source for Manage extension updates by locale

{{extdev}}
'''The content of this article is a partial workaround to the Firefox [https://bugzilla.mozilla.org/show_bug.cgi?id=285848 bug 285848]'''

The purpose of this is to be able to provide updates only for selected locales users (e.g. only for the users of the fr-FR or so), useful if you don't want to delay the release of a new version because of the l10n time or if the translator want to correct an error in the translation. It's also a way to get usage statistics by locale. The result is the possibility to get one update.rdf file per locale.

You need to use a special preference key to override the update check url specified in your [[install.rdf]] file. The name of this preference key is "<code>extensions.''{GUID}''.update.url</code>", where "<code>{GUID}</code>" is the [[Install.rdf#Items.27_IDs|ID of your extension]].

Below are instructions on how to modify this preference key. These instructions require knowledge of how to use the [[Dev_:_Using_preferences#Default_preferences|default preferences]] file in your extension package.

==Instructions==
#[[Dev_:_Using_preferences#How_to_install_extension.27s_defaults_files|Create]] your default preferences file, if you don't already have one yet.
#Add the preference key "<code>extensions.''{GUID}''.update.url</code>" to it, where <code>{GUID}</code> is the GUID of your extension.
#Set the value of the preference key to be the URI of a localized [http://www.xulplanet.com/tutorials/xultu/locprops.html properties file] (e.g., "<tt>chrome://my_ext/locale/names.properties</tt>")
#Create or edit the corresponding localized properties file.
#Add a new name-value pair to the properties file with the name also set to "<code>extensions.''{GUID}''.update.url</code>" and the value set to the address of your rdf update file (See [http://roachfiend.com/archives/2005/03/09/enabling-extension-updates/ this] for more info).

==Example==
If all goes well, your preferences file (<tt>defaults\preferences\prefs.js</tt>) may look like this:
 pref("extensions.{abcdef01-1234-abcd-1234-012345abcdef}.update.url", "chrome://my_ext/locale/names.properties");
And your localized properties file (<tt>chrome://my_ext/locale/names.properties</tt>) may look like this:
 extensions.{abcdef01-1234-abcd-1234-012345abcdef}.update.url = http://www.mysite.com/updates/my_ext-locale.rdf
where "locale" is the locale code (e.g. en-US).
 

''Inspired by [[Localize extension descriptions]]''

[[Category:Development]]