Personal tools
fr.gif, 1 kB    en.gif, 1 kB

Multi-LDAP Technical Documentation

This page was last modified 07:21, 19 August 2008.

From Milimail

Jump to: navigation, search

> User Manual > Add-on: Multi-LDAP > Technical Documentation

Contents

Add-on: Multi-LDAP - Technical Documentation

Architecture

Synthetic presentation of the architecture of the extension

This feature is developed in the form of a Thunderbird extension.

  • Users autocompletion with multi-directory LDAP

Architecture

This feature is based on the standard autocompletion from Thunderbird. It overload functions setupLdapAutocompleteSession(), AddDirectorySettingsObserver() and RemoveDirectorySettingsObserver() of the MsgComposeCommands.js file.

GUI files

  • Global preferences:

Servers list in the global preferences

  • User account preferences:

Servers list in the user account preferences

Global configuration

  • preferencesOverlay.xul file overload preferences.xul file. It includes the file composeLDAPOverlay.xul. It use the composeLDAPOverlay.js library
  • composeLDAPOverlay.js : retrieve the LDAP server list configured. It builds dynamically all XML items to create the GUI servers list. This list is accessible from the global preferences, in the composition tab.
  • The autocompletion is activated by setting the standard property Thunderbird, boolean type: ldap_2.autoComplete.useDirectory
  • The property defining the LDAP server list, string type, to read is standard a Thunderbird property: ldap_2.autoComplete.ldapServers.

GUI Architecture

User account preferences

  • Architecture is the same as above with a level less of inclusion (No file preferencesOverlay.xul). The file am-addressingOverlay.xul overloads am-addressingOverlay.xul. It uses the library file am-addressingOverlay.js
  • To overload the global preference of the autocompletion LDAP, you must set the standard property Thunderbird, boolean type:: ldap_2.identity.%IDENTITYKEY%.multi_ldap_use_custom_preferences
  • The property defining the LDAP serever list, string type, to read is standard a Thunderbird property: ldap_2.identity.%IDENTITYKEY%.autoComplete.ldapServers.

XPCOM files

This extension doesn't provided any new XPCOM. Mainly, it uses the built-in XPCOM nsIAutoCompleteSession and nsILDAPAutoCompFormatter that allows to manage the standard autocompletion on LDAP server.


Reference: English – Translations:  Français  • 


Files

Third Party Projects