How can I extend ListManager with my own programs?

Aurea List Manager allows you to add your own programs into the ListManager execution stream. Extensions can be added to match phrases, auto-responders, list postings, and the listmanager@ ListManager address.

Your scripts can let the normal Aurea List Manager execution stream continue, or they can interrupt it.

For example, you can write an extension that logs each use of an auto-responder. This would allow you to keep track of when people received information, and you could use this information to follow up with them. Also you can program your auto-responder to send one document to people inside your company and another document to people outside your company. In such a case, your program would actually replace the default auto-responder behavior.

Another use of technology can be to extend the check that the Aurea List Manager does on list postings. For example, your script might count the number of greater-than symbols, (">") which indicate message quoting, and refuse messages postings where the bulk of the posting is a quote of someone else's message.

To add your own extensions to Aurea List Manager, you need to tell Aurea List Manager when you want it to run your program. In the configuration screens for Match Phrases and Auto-Responders, List Settings and Server Settings, there are two fields for extension scripts. This gives you the option to run a script before the default ListManager action takes place, and to run a script after the action has taken place.

With an auto-responder extension, your script runs any time an email message comes in to the auto-responder's email address. This is similar to adding a program to the Sendmail "aliases" file.

With a match phrase extension, your script is run whenever the match phrase is found in the context it is defined for. For example, you could trap for offensive words in a message posting to your list, and your script would be run when the match phrase saw them.

With a List extension, your script is run any time a posting is made to the mailing list. Your can prevent the list posting from being accepted by deleting it before the default action is taken.

With a listmanager@ extension (set in the server configuration page), you can add your own process to the processing of Aurea List Manager commands.

You can write your script using any programming language, though we recommend using a language that has access to the Aurea List Manager API, such as Perl or C/++. You need to pass the Message ID over the command line, by specifying $MESSAGEID on your extension command line. So, for instance, if you are on Windows, and have a Perl script named lyrext.pl that you want to run, your command line might be:

c:\perl5\bin\perl.exe c:\scripts\lyrext.pl $MESSAGEID

This runs the Perl interpreter (perl.exe) against your lyrext.pl script, and passes the Incoming Message ID on the command line.

Normally, your script uses the Message ID to load the message in question, and perform some action. By default, when your program exits, ListManager continues processing the message. However, if you want ListManager to stop processing the message after your script has run, you should delete the Message. In Perl, this is done with the command &InMailDelete($MessageID).

Learn more about programming and ListManager.