Sympa Help

Welcome
Sympa Terminology
Web Interface Overview
1. Main Menu Items
2. User Menus
Frequently Asked Questions
Other Sites and Links

Welcome

The Sympa mailing list manager has a web interface called WWSympa, providing you access to the mailing lists and your subscriptions.

Using WWSympa, you can search for and view various mailing lists, manage the lists you're subscribed to, manage lists you own or are a moderator of, and a small host of other functions.

These help documents are intended to provide you with general instructions and direction in finding your way through the complex and powerful capabilities that the WWSympa web interface offers you. If you have any questions or concerns, including any comments (both constructive and critical) about the help files or web interface, please submit a request to the owner of the mailing list manager via an email to sympa-owner@lists.barrett.com.au.

Sympa Terminology

Here are some commonly used terms in Sympa, WWSympa, and mailing lists in general along with their definitions.

Sympa

Sympa is a piece of software called a mailing list manager. It provides a mailing list service on a host, allowing groups of people to communicate with one another via email without having to know who all the members of the group are and all their individual addresses.

WWSympa

Sympa's web interface is referred to as WWSympa, though sometimes the term "Sympa" can refer to both the web interface and the rest of the Sympa software running behind the scenes together. WWSympa provides you with a clean, easy to use interface with which you can manage your lists and subscriptions.

Mailing List

A mailing list, often referred to with the shorthand "list," is a means of sending electronic mail to many different addresses at once. The sender does not need to know the addresses of everyone on the list in order to ensure that the mail gets to all of them.

Of course, regular electronic mail may be sent to multiple addresses. However, a mailing list is superior to this approach in several ways. In the multiple-address approach, each person who wants to send to the entire list must know all of the addresses on the list. Since there is a need for the list of addresses to be kept in many places, it may be difficult to keep all of the lists the same. For example, suppose that Alex, Betty, Charlie, and Darlene write mail to each other regularly. Later, if they wish to include Earnest in their group, then each of the first four must know that Earnest has been added and they must all know his email address.

When you send mail to a mailing list, you address the mail to the mailing list's name. When the mailing list server receives the message, it expands the name of the mailing list into each of the individual addresses currently on the list and it redirects your message to each of those people, called subscribers. Then, should the membership of the list change, there is only one file containing the addresses of the subscribers which must be updated.

Mailing lists can alternately be referred to by their name or their address; a list's name is everything before the @ sign in its address.

Listmaster

The listmasters are the system administrators and help desk personnel who actually manage and maintain the Sympa system. A listmaster is the one who installed the Sympa software running on this host and is the one responsible for its functionality, as well as any site-specific modifications that have been made to better suit the needs of this site's users.

If you need to reach the listmasters, please submit a request via an email to sympa-owner@lists.barrett.com.au.

List Owner and Privileged Owner

Often referred to as simply an "owner," a list Owner is a person who has nearly full control over a list. They are the list's stewards, bouncers, mothers or fathers, and benevolent dictators. They handle all subscription and unsubscription requests, along with managing the list's settings and permisssions. They do not have absolute control over the list, however, as that privilege is reserved for Privileged Owners. For most purposes the two are the same, however a Privileged Owner has some additional privileges beyond regular Owners, including:

The ability to add and delete other, non-Privileged list Owners
The ability to add and delete list Moderators/Editors
The rights to change settings related to the shared document library
The rights to change who can view the list's subscribers
The rights to change who can send email to the list
View some information about the list's creation or status

Note: A list owner, privileged or otherwise, does not necessarily need to be subscribed to a list. ownership and subscription are separate things, and if you are a list's owner you may wish to subscribe yourself to it or you will not see any of the messages which get sent to the list.

To reach a list's owners, send an email to LISTNAME-request@lists.barrett.com.au, replacing LISTNAME with the list's actual name (e.g. to reach the owners of the themark newsletter mailing list, send an email to themark-owner@lists.barrett.com.au).

Moderator

Used interchangably with the term "editor," a list moderator is someone whose job it is to approve or decline messages sent to moderated lists.

Often a list will be set to only allow specific people to post and require everyone else to be moderated, or it will simply require everyone's posts to be moderated. This means when a user sends a message to the list it doesn't go out to the list's subscribers straight away. Instead, it enters a holding queue and a moderator is notified. They then view the message, determine if its content is appropriate to the list, and either approve it or deny it based on that decision. On high-volume lists, several moderators may be in place to help lighten each one's individual load.

Note: Like ownership, being a moderator does not necessarily mean you're a subscriber. If you are a list moderator and you wish to see postings to the list then you must explicitly subscribe yourself to the list, or have a list owner do it for you.

To contact a list's moderators, send an email to LISTNAME-editor@lists.barrett.com.au, replacing LISTNAME with the actual list's name (e.g. to reach the moderators of the themmark newsletter mailing list, send an email to themark-editor@)lists.barrett.com.au.

Subscriber

A list's subscribers are all the people who are on the list and likely should receive a message that gets sent to the list; in practice this is not always the case as some users' addresses are invalid, or the list may be moderated and thus the message won't go straight to the list, or they may have their preferences set to not receive mail from a given list. Subscribers make up the bulk of users of a system, and as each list has many subscribers each subscriber can be on many lists. Some lists are set up such that anyone who's interested can look at the list's homepage and click a link to become a subscriber, whereas others require the owner's approval before being allowed on the list, and still others have different ways for getting their bundle of subscribers.

Some lists will also let anyone post, and some are set to only allow subscribers to post, regardless of whether the list is moderated or not.

To contact the subscribers for a list, assuming you are allowed to do so, simply send a message to LISTNAME@lists.barrett.com.au, replacing LISTNAME with the actual name of the list (e.g. to send mail to the bluedevils list, address a message to bluedevils@lists.barrett.com.au).

Digest

Normally a mailing list will send all messages to its subscribers as it receives them, and users will then receive the individual messages at various times throughout the day. For some users, or in some cases, this is less than desirable — it can interrupt your workflow, can cause you to get far more email than you'd like, and can just generally be annoying. Some people prefer to get their messages in what's called a digest, where the mailing list gathers up all the messages over a span of time (usually one day) and then sends them out as a single bundle to subscribers who've elected to only receive digests. This allows them to read through the mail (or ignore it entirely) at a more leisurely pace.

Sympa supports two types of digests: multi-part MIME digests and regular plain-text digests. For most people the former will work, where Sympa sends you a digest made of multiple messages in a specialized mail format called MIME, but older email clients may not support that and for those users we recommend the plain-text digest, where Sympa just compiles all the messages in the digest into one text message and sends that out.

List Info File

Each list has an "info file," which contains basic information about the list. This file is sent to people on request, as well as in the welcome message sent out to new subscribers. The list owner controls its content.

Generally a list owner will want to include such information in the info file as what the list is for and what it's about, appropriate posting guidelines and restrictions, information on who the owners are, etc. Basically anything that you'd want a new subscriber to know.

List owners can change the list's info file via the following menu choices in the List Operations menu: List Administration → Edit Message Templates → choose "list description" in the drop-down menu and click the Edit File button.

List Subject

Not to be confused with the subject of a message sent to the list, the list's subject is a brief, one-line description about the list. Basically, it should describe the list as best it can in one sentence.

List owners can change the list's subject by choosing the following menu items in the List Operations menu: List Administration → Edit List Configuration → List Definition.

Shared Document Library

Some lists have a shared document library, where list members or owners (depending on the list's configuration) can post files for other list members. This is far better than simply sending out an attachment to the list for many reasons, including that it doesn't use exponentially more space on the mail server for each copy of the attachment, it doesn't trigger any message size limits on mail servers, and users can access it any time they want, even if they weren't on the list when it was originally sent out.

Web Interface Overview

WWSympa uses a common look across all its pages, so familiarizing yourself with the general layout of the system will allow you to more easily use all of its functions.

Main Menu Items

Along the top of the page, just beneath the main title, is the main WWSympa menu. It contains the following links:

Home

This link will take you to the main page.

On the main page, you'll see a welcome and overview message, along with a list of the categories of mailing lists available on the system. Each list is organized into one or more categories, and you can browse for lists which might interest you through these links.

You may also search for a list by name.

Request a List

Send a request to sympa-owner@lists.barrett.com.au.

Index of Lists

This link will take you to a listing of all the publicly viewable lists that are hosted at this site. Note that if a list of yours is not displayed and you'd like it to be, odds are that it's set to be a hidden or concealed list. Check the list options help for more information.

Help

This link takes you to the page you're currently reading, with help information that applies to the entire WWSympa site and the Sympa mailing list manager in general.

User Menus

Along the left side of the page are the user menus, the precise contents of which change based on what you're currently looking at or doing in WWSympa.

Login/User Information

Starting at the top is the login or user menu; if you're not logged in you'll see a place to input your user name and password, along with links to either send yourself a reminder of your password or create a new account so you can login and manage your subscriptions.

If you are logged in, you'll see the email address of the account with which you're logged in, which is where mail will be sent when you subscribe to a list, a link allowing you to manage your Preferences and a link letting you logout. You may also see, when looking at a list, your role listed just below your email address — this describes your current role with regard to the list you're looking at and thus what privileges and access levels you'll have.

Your Lists

Beneath the user or login menu is the "Your Lists" menu. Here are all the lists to which you're subscribed or of which you are an owner.

For each list which you either subscribe to or own an entry will be shown here with a link to take you to the list's homepage; if you are a list owner then you'll also have a link called "Owner" that will take you to the list's administration page. Note: because of the separation between being a list owner and being a subscriber, if you're an owner you'll see the list here regardless of whether or not you're subscribed to it. Check the list's subscribers to see if you're on it to find out if you're subscribed, if you're unsure.

List Overview

If you're looking at a list's page, include its homepage, then the Your Lists menu will be replaced with one giving you an overview of the list's basic information, including:

List Name

This is the list's name, which also happens to be the left-hand side (everything before the @) of its address.

List Address

The list's address. Sending an email to this address will, depending on the list's configuration, send it to everyone on the list.

List Subject

The brief, one-line description of what the list is about. The list's purpose summarized into one or two sentences.

Subscribers

How many subscribers are on the list. If you're one of the list's owners then you'll also see how many of those addresses are bouncing or refusing mail.

If the list is configured to allow you to see who all the subscribers are then the word "Subscribers" in this menu item will be a link to the page where you can browse or search for subscribers of the list.

Owners

This shows you who the owner or owners of the list are. The "Owners" menu entry itself is also a link you can click to send an email to the list owners using your default mail client.

Moderators

This shows you who the list's moderators are.

List Operations

If you're looking at one of a list's pages, including its homepage, then you will see the List Operations menu. Its options allow you to view the list's homepage, subscribe to or unsubscribe from the list, change your subscription options if you are a subscriber, access the list's archives or shared documents, and a few other choices. More information about these menu options follows:

List Home

Takes you to the list's homepage.

List Administration

Shown only to list owners, this link will take you to the list administration section where you can change various parameters of the list's configuration, alter and update different list templates, manage subscribers, and perform other functions related to managing the list.

List Moderation

Shown only to list moderators and owners, beneath it are three sub-items allowing a list moderator or owner to access currently pending message, document, or subscription requests.

Subscribe

If you're not already subscribed to the list, this link will either add you as a subscriber (if the list is set to allow anyone to subscribe) or dispatch a request to the list owners asking them to either approve or decline your subscription.

If there is no Subscribe link shown in the List Operations menu then it means subscription to this list is closed and you can only be added by the owner manually adding you.

Subscription Options

If you are a subscriber then the Subscribe link will be replaced with Subscription Options where you can change some aspects of your subscription to the list.

Unsubscribe

If you're subscribed to a list you'll have this link in your List Operations menu. You may use it to unsubscribe from the list.

Contact Owners

This link will open a new email to the list owners in your default mail client.

Post to List

If you are allowed to post messages to the list then this link will take you to a page where you can compose an email to be sent to the list.

List Archives

If the list has archives of messages that have been sent to it and you have the appropriate privileges to view the archives then this link will take you to a page where you can browse through or search the list's archives.

Shared Documents

If the list has a shared document library and you have access to it you'll see a link here which will take you to the file browser.

Frequently Asked Questions

Here are various frequently asked questions or commonly seen problems that people have about or with Sympa and WWSympa. If you have any questions not covered here, please let the Sympa Listmasters know.

General Questions

How do I create a new mailing list?

Send a request to sympa-owner@lists.barrett.com.au.

How do I search a list's archives?

When you're viewing a page for a list, and assuming the list has archives and the owner has it set to allow you to access them, you'll see a link in the "List Operations" section along the left hand side to access the "List Archives."

On the list's archive page, you'll see a simple search box in the upper right corner of the page. Input the text you want to search for and click the "Search" button.

For more advanced searches, click the "Advanced Search" button beneath the search text input field.

What commands are available for the email interface?

You can run some commands and operations with Sympa through the “email interface.” By sending a message to sympa@lists.barrett.com.au with nothing in the body but the word HELP you'll be sent a help guide that covers how to run commands via email.

Please make sure you're either sending out plain-text messages, or are including minimal formatting (no special fonts or colors and no images) in any rich-text messages. If you have trouble sending out plain-text messages with your email client send an email to sympa-owner@lists.barrett.com.au detailing your problems.

Why can't I post to a subscribers-only list to which I'm subscribed?

If your postings are being rejected by the list and returned to you, it's highly likely that you're posting using an address that's not on the list. Mail clients like Notes, Outlook, Thunderbird, or Mac OS X's Mail can be configureed to report a âFrom:â address — usually it's the address associated with the account, but some mail clients allow you to set up multiple or alternate âFrom:â addreses for one account. When you send mail using the client, it reports the message as being from the account's âFrom:â address. This is what Sympa checks to determine whether or not you're allowed to post to a list, for most lists configured to only allow subscribers or any other select group of people to post.

There are a handful of options for both list owners and list members to remedy these situations:

Change your âFrom:â address.
Subscribe multiple addresses to the list and set them to not receive list mail.
Have the list owner relax restrictions on who can send to the list.

Subscribing multiple addresses to the list

On most lists, you can subscribe multiple addresses to the list and tell the list to only send you mail at one of them. Note that some lists may require owner approval for you to subscribe, or may even require the owner themselves to subscribe you. For most lists, however, the following should do the trick. From the account with which you wish to be able to send messages to the list, send an email to sympa@lists.barrett.com.au with the following in the body:

SUBSCRIBE LISTNAME

Replace LISTNAME in the above with the list's name. Once you've received the list's welcome message — note, again, that it may take some time for the list's owner to approve your subscription request — then send another message to the same address with the following in the body:

SET LISTNAME NOMAIL

Again, replace LISTNAME with the name of the list. This will set this address to not receive list messages, so you won't receive multiople copies of messages sent to all the addresses with which you're subscribed.

List Owner Questions

What's the best way to add subscribers to my new list?

Once your list has been approved, you're left with the task of filling it with the right people. You simply add a bunch of email addresses to the list and hope that they were valid and correct.

How do I add or remove a list owner?

Only privileged owners may add or remove other owners to the list. To do so, from the list's home page, click âList Administrationâ in the âList Operationsâ menu section, along the left side of the page. Then click âEdit List Configuration,â and finally click âList Definition.â

You should see a section beginning with âOwner.â Here are all the owners, privileged or otherwise, belonging to the list, along with an empty set of entry fields with which you can add new ones. To add a new owner, simply fill out the empty fields before âOwners defined in an external datasourceâ section. Only the email address is required, though you may want to put their name in so that users see it instead of their address. The âprivate informationsâ field is for whatever information you'd like to put in there, such as a telephone number, and is only visible to other list owners.

How do I add or remove a moderator/editor?

Adding or removing a list moderator requires you be the owner of the list. From the list's home page, click âList Administrationâ in the âList Operationsâ menu section, along the left side of the page. Then click âEdit List Configuration,â and finally click âList Definition.â

Scrolling down, you should see a section beginning with âModerators.â Here are all the moderators of the list, along with an empty set of entry fields with which you can add new ones. To add a new moderator, simply fill out the empty fields before âModerators defined in an external datasourceâ section. Only the email address is required, though you may want to put their name in so that users see it instead of their address. The âprivate informationâ field is for whatever information you'd like to put in there, such as a telephone number, and is only visible to other list owners. Removing a moderator is simply a matter of deleting their email address, name, and private information.

Once you've made your changes, scroll down to the bottom of the page and click the âUpdate List Configurationâ button to save the new settings.

How do I add a bunch of subscribers at once?

If you've got a list of subscribers' addresses and you'd like to add them all in one go, that's a fairly simple process. Assuming you've got the appropriate privileges to add subscribers to a list and you're looking at any of the list's pages, including its homepage, simply click the "Subscribers" link in the "List Overview" menu section along the left side of the page. From the "Manage Subscribers" page, click the "Bulk Add Addresses" link.

On the "Bulk Add Addresses" page you'll see a text box with some example addresses and names in it. Replace the contents of this text box with the addresses, one per line, of the users you wish to subscribe to the list. You may follow an address with a space and the user's real name if you so choose. When you're done, you may check the "Don't send welcome message" option to prevent sending the new subscribers any notification or welcome message when they're added to the list; while users generally prefer to receive the welcome message, in some cases it may not be desirable such as if you're migrating users from an old list. Then simply click the "Add Subscribers" button and you're all set.

How do I change the list's info file?

Only a list's owner may change the info fileFrom the list's homepage (or any page for the list, really), click "List Administration" in the "List Options" section, along the left side of the page. From there, click "Edit Message Templates." From the drop-down menu select "list description" and click the "Edit File" button.

You'll be presented with the file editor, where you can make the changes to the description. When you're done click the "Save Changes" button to commit the changes you've made, or if you'd like to revert the file to the way it was when you began editing it.

What are all these options for sending, receiving, subscribing, etc?

Sympa uses âauthorization scenariosâ (or just âscenariosâ) to determine whether or not a given user can perform a given action. Some examples for when scenarios are used (and what the class of that scenario is called) are:

Sending messages to lists (send)
Subscribing to a list (subscribe)
Unsubscribing from a list (unsubscribe)
Whether or not the list is shown in the main index of lists (visibility)
Requesting a new list (create_list)
Viewing who's subscribed to a list (review)

There are different choices available for each class of scenario. Below you'll find more verbose descriptions about what some of the available choices do, as well as how to change which scenario is being used.

Sending Scenarios

To change which send scenario is being used for your list, select the list under âYour Lists,â then click âList Administrationâ in the âList Operationsâ section, then âEdit List Configuration,â and finally âSending/Receiving Setupâ — the send scenario choices are in the first section, named âWho can send messages.â Available choices include:

closed

No one may send to the list. Pretty straightforward, if not necessarily widely useful. Can be handy if you need to temporarily shut off list traffic due to a rampant virus or overly aggressive spammer.

editorkey

Anyone may send to the list, and their messages get flagged for moderation. List moderators may send straight to the list, unfettered by message approval queues.

editorkeyonly

Anyone may send to the list, and their messages get flagged for moderation. This even applies to moderators.

editorkeyonlyauth

Anyone may send to the list, and their messages get flagged for moderation. List moderators, however, are sent back a confirmation request when they send messages to the list, asking them to confirm the message before it gets sent out.

intranet

Anyone whose address ends in âbarrett.com.au may send messages to the list.

intranetorprivate

Anyone whose address ends in âbarrett.com.au or anyone who's subscribed to the list may send messages. This can be useful for when you want a more open list without opening it up too widely for spammers, since most spammers don't use âbarrett.com.au addresses.

newsletter

Only list moderators may send messages to the list. This is most useful for announcement-style lists, where you want a select group to be able to broadcast messages out to all the list members, without anyone else being able to contact the list.

newsletterkeyonly

Similar to the newsletter send scenario, this one only allows moderators to address the list, and it sends them back a confirmation message asking them to make sure they want to send that message to the list. Like newsletter with a safety net. It also prevents poeple from being able to falsify messages to the list by setting their mail client up to claim to be one of the moderators.

ownereditor

Only list owners and moderators may send messages to the list.

private

Only list owners, moderators, and subscribers may send messages to the list. This is the standard default for non-public lists as it prevents spammers and other such miscreants from getting messages out to the list. You may find that subscribers who try to send messages to the list with alterante addresses are having their messages rejected — check the Why can't I post to a subscribers-only list to which I'm subscribed? FAQ entry for more information about this.

private_smime

Only list owners, moderators, and subscribers may send to the list, and they all require valid S/MIME signatures. S/MIME signatures are specialized attachments that verify, through the use of a trusted third party, the sender's identity as being authentic and the message as being unaltered. This is the most secure setting for your list, but all the users on the list must have valid S/MIME signatures.

privateandeditorkey

Only subscribers and moderators may send messages to the list; those of the former must be moderated and those of the latter go straight through. Similar to the editorkey option, but only allowing subscribers to submit messages for approval rather than anyone.

privateandnomultipartoreditorkey

Moderators can send straight through to the list, as can subscribers, but messages with attachments will be flagged for approval by a moderator.

privatekey

Only subscribers may send to the list, and they will need to confirm every message by replying to a confirmation message Sympa sends them before the message will go through to the list.

privatekeyandeditorkeyonly

Only subscribers and moderators may send to the list. They'll both be asked to confirm their messages, and subscribers' messages will get put into the moderation queue (moderators' messages will go straight out).

privateoreditorkey

Subscribers and moderators may send messages straight out to the list. Non-subscribers' messages will be flagged for moderation. This can be useful for allowing users who are not subscribers to submit messages while still letting the moderators keep spam away from the list's population.

privateorpublickey

Subscribers may send messages to the list, as may users whose S/MIME signatures can be verified. Everyone else must confirm their messages by replying to a confirmation message Sympa sends them before the message gets resent on to the list. This is useful for reducing spam without increasing the list moderators' workload as spamming systems are usually automated and very, very rarely — if ever — are sophisticated enough or watched well enough to approve the message.

public

Anyone in the world may send to the list. This is really only suitable and recommended for contact addresses where there really is no other way to allow anyone who may need to send to the address the ability to do so.

public_nobcc

Anyone may send to the list, but messages with Bcc (blind carbon copy) recipients are rejected. This can help prevent some spam, though most spammers no longer use Bcc headers for recipients.

publickey

Anyone may send to the list, provided they approve their own message by appropriately replying to the confirmation message Sympa sends them.

publicnoattachment

Anyone may send to the list. Messages with attachments are flagged for moderation.

publicnomultipart

Anyone may send to the list. Messages with attachments are simply rejected.

Login

You can logout (deletion of the cookie) at any time using logout button.

Login issues

I am not a list subscriber
Your are therefore not registered in Sympa user database and you can't login. If you subscribe to a list, WWSympa will give you an initial password.

I am subscriber to at least one list but I have no password
To receive your password : /sympa/remindpasswd

I forgot my password
WWSympa can send you an email password reminder. /sympa/remindpasswd

To contact this service administrator : listmaster@lists.barrett.com.au