mailinglist.rb/doc/manage_mailinglists.md

1.4 KiB

Mailinglist management

What are strategies?

There are 2 types of strategies: registration and moderation. Registration defines how new user can access the list. Moderation defines how user can write on the list.

Registration

  • autoregister: writing any email to the mailinglist will add the email of the user to the mailinglist
  • free: any email can register to the list by sending a "subscribe" email to the list
  • validated: like free but moderators needs to confirm the email with a "set-permissions" email. the user details are distributed to moderators first.
  • closed: nobody can register via email

Moderation

  • freewrite: anyone registered can distribute emails to the list
  • restrictedwrite: email needs approval by moderator before distribution. the email details are only distributed to moderators first.

How to interact with the list by email ?

You need to send an email to the list with the subject being an action. Some action can take parameters in the subject or the body.

Actions are:

  • set-permissions
  • validate
  • refuse
  • subscribe
  • unsubscribe
  • help
  • list-users
  • owner

Parameters are key=value, which are separated with "," in the subject or "new line" in the body.

permissions parameters

permissions: a permission mask (0=reader, 1=writer, 2=operator, 4=moderator) user-email: the email of the user

validate parameters

uid: uid of the email