LISTSERV has a completely revamped Web Administration Interface, making LISTSERV administration significantly easier. It is now possible to change many LISTSERV site configuration settings "on the fly", although some changes may still require a restart of the server before they are recognized.
Most sites will be able to upgrade to LISTSERV without losing local web customizations, although this is not optimal and will not generally expose new features to your users. To assist you in customizing the LISTSERV web interface, L-Soft has produced a Customization Guide, which is available in PDF format at the following location:
Since the comprehensive guide takes you through the whole gamut of interface customization, this section will concentrate solely upon a basic understanding of the new features of the interface.
The LISTSERV Web Interface requires JavaScript to be enabled by default. However, those who prefer not to use JavaScript can set their Navigation Style user preference to "Non-Script Navigation" in the Preferences menu.
•
On unix: http://yourhost.domain/cgi-bin/wa•
On VMS: http://yourhost.domain/htbin/wa•
On Windows: http://yourhost.domain/scripts/wa.exe or
http://yourhost.domain/cgi-bin/wa.exeOf course this is not standardized; the location of the 'wa' script is determined by the value of WWW_ARCHIVE_CGI in LISTSERV's site configuration file. In any case, invoking 'wa' without any parameters returns the default home page.
You can log into the list administration interface from any list's main web archive index page (assuming that this link has not been removed by the list owner; it exists in the WWW_INDEX mail template by default). The interface may also be reached by a link from the default LISTSERV home page mentioned in Section 11.1
The Default LISTSERV Home Page.
Note: The userid you use here must be associated with the personal password you have from LISTSERV. If you have registered a password as joe@unix.host.com and try to log in here as joe@host.com with that password, LISTSERV will reject your login.
Logging in will cause LISTSERV to issue you a cookie that allows you to bypass this login screen (and incidentally to stay logged into the interface for longer than 15 minutes without having to log in again when your session expires). If your workstation is not physically secure, you will want to log out after each management session.
If you do not already have a personal LISTSERV password (set with the PW ADD command or via the web interface) or cannot remember your password, you need to define one now. If you choose to do this via the web interface, simply click the hyperlink and you will get the following screen:
When you hit the [Register password] button, you will be told that a confirmation has been emailed to you. You will have to activate your password by responding to the email (or clicking the link it contains).
The interface tells you who you are logged in as, and what functions your logged-in address is entitled to perform. It also tells you what mode you're set to (the Basic Mode by default; there are two other modes, "Expert" and "Tutorial"). If you are entitled to edit the page, you can go straight to the page editing wizard by clicking
Edit Page.
Clicking the LISTSERV logo icon at the left takes you to L-Soft's home page. Clicking "
LISTSERV 15.5" takes you to your default start page.
Help pages are accessed by clicking the Help icon at the right hand side of the toolbar.
The Server Administration menu gives you access to the Server Dashboard, site configuration functions, mailing list creation and deletion, server reports, server customization (mail and web templates), and the ad-hoc LISTSERV command entry page.
The List Management menu gives list owners access to the List Dashboard, list configuration, customization, and subscriber management.
List Moderation centralizes the moderation function, and it will show all messages needing moderation from the userid@host under which you are logged in.
Email Lists takes you back to the main list archives page.
The first thing you may want to do is click Preferences. One of the things you can set is the default start page. Site administrators will probably want to start at the server administration dashboard, while list owners will probably want to start at the list owner dashboard. Or they may be perfectly happy to start at the list archives page. In any case, clicking on
Preferences brings up the following page:
Important: The LISTSERV 15 Web Interface cannot be used to manage lists that are coded
Validate= Yes,Confirm,NoPW or
Validate= All,Confirm,NoPW because passwords are not accepted for validation in those cases.
The Subscriber Management screen lets list owners examine, delete, and add subscribers to a specific list. To access this screen, select
Subscriber Management from the
List Management menu. From this screen, select the list you want to work with, and then select either the Single Subscriber or Bulk Operations tab. The Single Subscriber tab lets the list owner examine or delete a subscription and add a new subscriber to the list. To add or delete many subscriptions at a time, use the Bulk Operations tab.
Note: To examine, modify, or delete multiple subscriptions at once, you can also use the Subscriber Reports screen.
If there is no match for your entry, then you will get back the same page but with a Scan: No match message at the top. If, on the other hand, your search is successful, one of two things will happen.
Next, simply choose the user you want to examine or delete and click on the appropriate button. If you did not find what you were looking for, you can press the
[New Search] button to get a new search screen.
If there was only a single match to your query, then the preceding screen will be bypassed and you will go directly to the next screen, which is the Subscriber Management screen for the subscription. It displays the values of all the settings for that subscription, including the subscription date and name. From the account management screen, you can delete the subscription or change the name, the email address, or the subscription options associated with the subscription. A sample of the screen is shown below.
To add a new subscriber, select the list you want to add the subscriber to. Then, in the Add New Subscriber section, enter the email address and name of the new subscriber, select whether or not to send an email notification to this subscriber, and click the
[Add to List] button.
Note: The full name of the subscriber is optional. If omitted, then the user will be added anonymously to the list.
The Bulk Operations tab allows a list owner to upload an input file containing email addresses and (optionally) names, one address per line, and either add all the email addresses in the file to the list (optionally replacing the current subscribers) or remove them from the list.
•
If the Add the imported address to “List”; do not remove any subscribers option is selected:
•
If the Remove all subscribers from “List”, and add the imported address option is selected:
•
If the Remove the imported addresses from “List”; do not add any subscribers option is selected:
•
If the Remove the imported addresses from all lists option is selected:
Notes: Bulk operations are not enabled by default. The site manager must enable this functionality explicitly. If you get an error 2 when you click on the
[Import] button, this means that the "upload" directory has not been created. If you get an error 13 when you click on the
[Import] button, this means that the "upload" directory has been created but the CGI program user does not have write permission in that directory. In addition, the input file must be a plain text file (not a word processor document or spreadsheet) and must contain one address per line, optionally followed with a space (or TAB) and the subscriber's name. In addition, the subscribers being added or deleted will not be notified.
To open the List Configuration Wizard, click on the List Management menu, select
List Configuration, and then select
List Configuration Wizard.
To configure a list manually, click on the List Management menu, select
List Configuration, and then select
Manual List Configuration.
For those of you who want to configure the list manually, you can edit the list header in its "raw" state. This is only recommended for people who are very comfortable with LISTSERV list header formats and know the keywords and their parameters very well.
The list header appears in a multi-line text box that can be scrolled up and down. You simply type in the changes or added lines just as if you were using a regular text editor. When you are finished, click the
[Submit] button to submit the changes. If you want to start over, you can click the
[Reload] button to reload the header information from the server.
When you submit your changes with the [Submit] button, you will get the same kind of feedback from LISTSERV as you would if you sent a PUT operation by mail. The next screen will either say that the header of the list has been successfully updated, or it will indicate that it has found errors and that the header has not been stored. The feedback page also has a text box containing the header information you've just stored (or tried to store) so if you need to make further corrections to the header, you don't have to back up and start over.
The list header keywords and their parameters are documented in the List Keyword Reference document, in the online help, or (when using the configuration wizard) by clicking the
Help icon for each keyword.
The template editor allows the site administrator and list owner to customize the majority of the Web Interface Pages and Administrative Messages sent out by LISTSERV. There are two types of templates you can customize – Web and Mail.
Web Templates (also referred to as Dynamic Web Templates) control the pages produced by the Web interface. These pages are produced dynamically when they are accessed. What gets displayed by the browser depends on the circumstances and may change depending on who is accessing the interface, which list they are accessing, the settings of that list, and so on.
Mail Templates control text produced by LISTSERV itself. Although generally categorized as mail templates, they actually fall into three different types:
•
Message Templates supply text that will ultimately be shown to the user. These messages may be included in a mail template; or they may be included in an email sent by LISTSERV in response to LISTSERV commands sent by email to the LISTSERV command address; or they may be returned to the Web interface in response to commands sent through the Web interface. Limited formatting is available.
•
Message Fragments templates are the lowest level of mail templates. Fragments are pieces of text produced by LISTSERV as parts of other messages or emails. For example, list digests must follow a certain format dictated by the Internet RFCs. Therefore, it is not possible to provide a complete mail template for digests. However, some of the text within the digest is not mandated by the RFCs, and so LISTSERV provides some fragment templates to control these parts, for example MSG_DIGEST_FRAGMENT_DATERANGE1 to control the date range and MSG_DIGEST_FRAGMENT_PREAMBLE1 to control the text preceding the table of contents. Formatting commands are generally not available in fragments.
To access the template editor, click on the List Management menu, select
Customization, and then select either
Web Templates or
Mail Templates.
The LISTSERV Command Interface is used for submitting LISTSERV commands that are not otherwise facilitated by the Web interface. See Appendix A:
Command Reference Card for a listing of all commands.
For some commands, the response is automatically displayed by the Web interface. For others, a special command parameter must be used in order to display the response in the browser, otherwise the response is sent by email. In addition, other commands are only able to respond by email.
To access the LISTSERV Command Interface, click on the List Management menu, and then select
LISTSERV Command.
The Command Interface can only be used for single line commands. In particular, the PUT command will not work through the Web interface. Multi-line commands must be sent by email.
Advanced mail-merge features are available and can be accessed either by sending specially-formatted DISTRIBUTE jobs to LISTSERV or by using the web administration interface. The web interface is not a "wizard" but simply an interface that allows you to "cut and paste" a mail merge message and select different standardized groups of list subscribers to whom the message is to be sent.
Important: When creating lists via the web interface under unix and VMS (with PMDF), it is still necessary to make the mail aliases required in 7.2.2 (for unix) or 7.2.3 (for VMS), above. The web interface will not make these aliases for you.
The main entry page for the administration interface is the Administration Dashboard. This Dashboard concentrates important information about the server, the current version you are running vs. the latest available version, license information, anti-virus information, and technical support information.
The bottom section shows monthly statistics for the server. The default set of statistics can be changed to show only those statistics you really want to see on a regular basis. To change the stat set, click the
Edit Table link at the top left of that section. Columns are removed by clicking the
[X] under the caption, and columns are added by choosing a statistic from the
Columns drop-down text box and clicking the
[Add Column] button at the right. When done editing, click the
Stop Editing link at the top left.
