Module : Multi-LDAP - Documentation technique

Architecture

Présentation synthétique de l'architecture de l'extension

Cette fonctionnalité est développée sous la forme d'une extension Thunderbird.

Auto-complétion des utilisateurs avec plusieurs serveurs LDAP

Cette fonctionnalité repose sur l'auto complétion standard de Thunderbird.

Elle surcharge les fonctions setupLdapAutocompleteSession(), AddDirectorySettingsObserver() et RemoveDirectorySettingsObserver() du fichier MsgComposeCommands.js.

Les fichiers d'IHM

Options globales

Préférences de comptes

Configuration globale

Le fichier preferencesOverlay.xul surcharge preferences.xul. Il inclut le fichier composeLDAPOverlay.xul. Il utilise la librairie composeLDAPOverlay.js
composeLDAPOverlay.js : récupère la liste des serveurs LDAP configurés. Il construit dynamiquement tous les items XML pour créer la liste des serveurs pour l'IHM. Cette liste est accessible dans les préférences globales, dans l’onglet composition.
Propriété définissant l'activation de l'auto-complétion LDAP (booléen) : ldap_2.autoComplete.useDirectory
Propriété définissant la liste des serveurs LDAP (chaîne de caractères) : ldap_2.autoComplete.directoryServers

Préférences de compte

L'architecture est la même que ci-dessus avec un niveau d'inclusion en moins (Pas de fichier preferencesOverlay.xul). Le fichier am-addressingOverlay.xul surcharge am-addressingOverlay.xul. Il utilise la librairie am-addressingOverlay.js
Propriété définissant la surcharge de l'activation de l'auto-complétion LDAP (booléen) : mail.identity.%IDENTITYKEY%.overrideGlobal_Pref.multi-ldap
Propriété définissant la surcharge de la liste des serveurs LDAP (chaîne de caractères) : mail.identity.%IDENTITYKEY%.directoryServers

XPCOM

Cette extension s'appuie principalement sur des XPCOMs standards nsIAutoCompleteSession et nsILDAPAutoCompFormatter qui permettent de gérer l'auto-complétion depuis un serveur LDAP.