Skip to content
Account Hooks for Thunderbird (provides features like ISP hooks for Thunderbird 5 and later)
JavaScript Other
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
content/achook
defaults/preferences
gmail-config-imap
gmail-config-pop
locale
makexpi @ 4c4c7fa
modules
.gitmodules
Makefile
README.ja.textile
README.textile
achook.sh
chrome.manifest
example.com.xml
example.com.xml.jxon
example.com.xml.jxon.verbose2
install.rdf
make.sh
xmlToJXON.js

README.textile

Abstract

Autoconfiguration, which is introduced in Thunderbird 3.1, allows system administrators to arrange already configured mail accounts where user have to input only few things such as username. However, the number of configurable account information in autoconfiguration is limited, and thus it cannot be used in some cases. To address this problem, achook provides features that allow system administrators to configure most account information.

Pre-configured account creation

A system administrator arranges preset values of account information as a setting file (in XML format), and place it to the certain place such as a server in his company’s network. After that, in Thunderbird with achook, pre-configured account creation menu item appears, and when an user clicks the item, pre-configured account creation wizard starts.

The remainder of this document shows the steps to use achook in real-systems.

Arranging a setting file

First, we need a setting file that contains pre-configured setting values. Setting files can be placed in local place or remote place from user environments.

Setting files are written in XML, and example.com.xml packed in achook is a good example for writing setting files. You may find useful information in a documentation of autoconfiguration.

https://wiki.mozilla.org/Thunderbird:Autoconfiguration:ConfigFileFormat

An extra placeholder %USERNAME% is available in the configuration file. If the secret preference extensions.achook.staticConfig.(configname).separatedUsername is true and the input field for the account ID has any value, then the placeholder will be replaced to the value of the field. Otherwise, it will be replaced to the value same to %EMAILLOCALPART% .

You can customize the pretty name of the created account by .
There are some template variables for the field:

Variable name Expanded into
real_username Full name of the user
username User name part of the e-mail address
hostname Host name part of the e-mail address
port Port number of the mail receive server (e.g., “12345”)
not_default_port_expression Port number of the mail receive server with a colon (e.g., “:12345”)

If you don’t specify , the result becomes “username%@%hostname%not_default_port_expression%”.

Specifying the location of the setting file

Second, install achook into user Thunderbird, and specify the location of the setting file via extensions.achook.staticConfig.(configname).source as an URI string (ex. File URL).

The part (configname) should be replaced with a name for a config.
For example: extensions.achook.staticConfig.mydomain.source.
You can define multiple configs with different names.

Specifying to use separated account ID or don’t

By default, Thunderbird creates a mail account with an account ID same to the local part of the mail address. If you have to use an account ID different from the local part of the address, then set the preference extensions.achook.staticConfig.(configname).separatedUsername to true (boolean).

Specifying the domain name

Optionally, system administrator can specify the domain name of pre-configured accounts via extensions.achook.staticConfig.(configname).domain. This value is used as a label of a menu item.

Disable default account creation wizard

System administrators can limit mail-accounts used in users Thunderbird to inter-company accounts, by setting extensions.achook.disableGenericWizard to true. This customization disables default account creation wizard, and force users to use pre-configured mail accounts.

Something went wrong with that request. Please try again.