Addressbook plug-ins

Address book plug-ins look up user information:

• email address

• mobile number

• first name

• account type

• user’s language preference (if you use multilingual notifications)

They allow client applications to tell tattler “Notify user #123 about event XYZ”, and tattler takes care of loading the necessary contacts depending on what vectors the event should be sent to.

You may provide multiple address book plug-ins. They are processed in sequence until one is able to return contacts for the user inquired.

Writing an address book plug-in

Address book plug-ins are python files that

• are placed in the plug-in directory,

• implement the AddressbookPlugin interface of class tattler.server.pluginloader.AddressbookPlugin .

Plug-in filenames must end with _tattler_plugin.py; other filenames are ignored.

To create an addressbook plug-in:

1. Familiarize yourself using the quickstart example.

2. Start coding your own starting with the sample plug-ins in Tattler’s repository.

See Deploying plug-ins for tips on deployment.

More details

• Requirements on tattler plug-ins in general.

• Provisioning multiple plug-ins.

• AddressbookPlugin class reference.