Importing Templates in ListSTAR


ListSTAR 1.1 introduces a new concept of templates. Templates are groups of services, designed to work together for common tasks. In some cases, such as Email-On-Demand and the Vacation Service, this is just one service. In others, such as the Moderated Mailing List and Announcement List, this is three services. Also associated with a template are address lists, user lists, and AppleScripts.

Most templates are accompanied by custom installers in the Scripts menu. You can identify them by the word "New" preceeding a template name, such as "New Mailing List". When using one, simply choose the item from the Scripts menu to begin the import. If a template is distributed without a custom installer (such as the Server Administration template), then you must use "Import Any Template..." menu option and select a template file.


Using a custom installer

There are three stages to using a custom installer. The first creates new address lists, user lists, and AppleScripts, renaming old ones if necessary. The second stage imports the actual services, and the third stage enters the appropriate addresses into the address lists.

Address Lists and User Lists

If the address lists and user lists being imported don't already exist, they are copied into the appropriate folder and imported into ListSTAR. If they do exist, you are given the option to "Use the existing one" or "Make a new one". Using the existing one will cause the new services to share this address list with other services already installed. Making a new one will rename the old one so that both lists can exist in the same folder, without losing track of which services point to the old address list rather than the new one. AppleScripts are compared by version number.

Services

Services being imported must be unique: a service with the same name can't already exist. Timer services require no user input to import. SMTP and POP services prompt the user for both a display name and e-mail address; POP services additionally prompt for a password. In the example RFC822 header which follows, "ListSTAR Talk" is the display name and "liststar-talk@starnine.com" is the e-mail address.

Date: Sat, 5 Oct 96 10:23:05 -0400
Subject: Message to post
From: "Joshua D. Baer", josh@starnine.com
To: "ListSTAR-Talk", liststar-talk@starnine.com

The information you enter here will be seen as the From address on all mail sent by that service.

Specific Addresses

Once all address lists, user lists, AppleScripts, and services have been imported, the custom installer prompts the user for e-mail addresses such as the listmaster address, moderator address, or forwarding address. The addresses you enter here are entered into address lists where appropriate, and used to customize files such as the RFC headers and help file.


Using "Import Any Template"

"Import Any Template" should be used whenever a custom installer is not available. The differences between using a custom installer and using "Import Any Template" are two-fold. First, you must choose the template file to import. Second, it doesn't prompt for specific address information, so this may need to be entered manually.

When prompted to locate a template file, look for a TEXT file created by ListSTAR ending in the word "Template". In most cases, this will be found in a subfolder of ListSTAR's "Templates" folder.