Voir la source de Multi-LDAP Technical Documentation

{{lang|Multi-LDAP Technical Documentation|Multi-LDAP Technical Documentation/fr}}
> [[Documentation]] > [[Multi-LDAP|Add-on: Multi-LDAP]] > [[Multi-LDAP Technical Documentation|Technical Documentation]]


== Architecture ==

* Users autocompletion with multi-directory LDAP
[[Image:multi_ldap_architecture_compose_autocomplete.jpg|Architecture]]

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

== GUI files ==

* Global preferences

[[Image:multi_ldap_architecture_preferences_IHM_pg-en.jpg|Servers list in the global preferences]]

* User account preferences

[[Image:multi_ldap_architecture_preferences_IHM_pu-en.jpg|Servers list in the user account preferences]]

=== Global configuration ===

* ''preferencesOverlay.xul'' file overloads ''preferences.xul'' file. It includes the file ''composeLDAPOverlay.xul.'' It uses ''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.
* Property to activate LDAP autocompletion (boolean): '''ldap_2.autoComplete.useDirectory'''
* Property to define LDAP server list (string): '''ldap_2.autoComplete.directoryServers'''
[[Image:multi_ldap_architecture_preferences.jpg|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''
* Property to overload the activation of LDAP autocompletion (boolean): '''mail.identity.%IDENTITYKEY%.overrideGlobal_Pref.multi-ldap'''
* Property to overload the definition of LDAP server list (string): '''mail.identity.%IDENTITYKEY%.directoryServers'''

== XPCOM ==

This add-on is built around Mozilla components [http://www.xulplanet.com/references/xpcomref/ifaces/nsIAutoCompleteSession.html nsIAutoCompleteSession] and [http://www.xulplanet.com/references/xpcomref/ifaces/nsILDAPAutoCompFormatter.html nsILDAPAutoCompFormatter] that allows to manage standard autocompletion from LDAP server.