Listen

Project Description

Project resources

• Releases
• Issue tracker
• Contact address
• Project page
• Issue tracker
• Support
• Code repository

Key features include:

- Easily create mailing lists through the Plone interface.

- Lists may be moderated or unmoderated, open to all or restricted to
subscribers only.

- Optional archiving of mail with or without attachments.

- Fully threaded archive display, including a forum-like view.

- Portal members and visitors can easily subscribe/unsubscribe themselves
through the Plone interface.

- Each list maintains its own catalog featuring a full text index of messages.

- Members can make resposes with quotation to archived messages through the
Plone interface.

- Automatic masking of member email addresses with links to author pages.

- Provides a registry of lists on a zope instance allowing lists to be added
without any additional SMTP server configuration.

- Performs well due to use of simple Zope types and z3/Five techniques.
Capable of higher mail volume than MailBoxer itself, and much greater
volume than AT-based mailing list systems.

This product makes heavy use of zope3 features within Plone via Five, it uses
views, adapters, zope3 schemas (add and edit views), local utilities,
factories, and events. It is not an ideally componentized application because
of its dependence on MailBoxer, which is used as the base class for the
primary content type, and provides more logic/functionality than an
ideal content class would. Hopefully, those parts which make heavy use of
Five technologies can serve as a helpful example for those intending to use
Five in their own products.

Requirements

------------

Plone 2.1+ (and all that entails)
Zope 2.8.4+
Five 1.2 (currently in beta)
MailBoxer (svn version from
https://svn.plone.org/svn/collective/MailBoxerTempDev/trunk)
ManagableIndex 1.1
(also OFolder http://www.dieter.handshake.de/pyprojects/zope/index.html#ManagableIndex)
Note that plone_schemas is no longer required if you are using listen from svn trunk

Highly Recommended

-------------------

MaildropHost 1.13+ (http://www.dataflake.org/software/maildrophost/)
Any site that expects a reasonable amount of mail traffic (incoming and
especially outgoing) needs to use this. It well not send duplicate mails
when a conflict error forces a retry, and it increases potential incoming
mail volume tremendously by not blocking on sending mail.

Installation and setup

-----------------------

Place this product folder in your Zope instance's Products folder and restart
zope. Go to the portal_quickinstaller in the ZMI and install the product. Now
you may create mailing lists by using the add menu in any container in Plone,
or (preferably) using the add view for the Mailing List class which can be
accessed with a url of the following form:

http://mysite.example.com/my_portal/path/+/listen.add_mailinglist

Hopefully, Five add forms will be integrated into the Plone ui in the near
future so that the more correct way is also the easy way to add a list.

Your smtp server must be configured to route mail to the mailing list(s). For
a simple single list instance the easiest way to do this is the standard
MailBoxer way:

1) Copy the smtp2zope.py script from your MailBoxer folder to the relevant
SMTP server (if you are using sendmail with smrsh, then you need to place/link
it in a folder accessible to smrsh).

2) Add an alias for the mailing list of the form:

my_list@lists.mydomain.com "|/etc/smrsh/smtp2zope.py http://my_site.example.com/path/to/list/manage_mailboxer 200000"

Where the number at the end restricts the maximum size of a message intended
for the lest, this is optional, but highly recommended.

If you would like to be able to setup arbitrary lists on your server and have
them automatically handled by your SMTP server the setup is slightly more
involved and dependent on the particulars of your SMTP server. The end result
is that you need to map a catch-all domain to a similar command which uses a
tool in your zope instace to decide where to route the mail. In sendmail the
process is as follows:

1) same as step 1 above.

2) Add an entry to your virtusertable to create the catchall domain:

@lists.my_domain.com my_zope_lists

3) Add an alias pointing to the script with the url for the global list lookup
utility:

my_zope_lists "|/etc/smrsh/smtp2zope.py http://my_site.example.com/send_listen_mail 200000"

That should be about it. Site members and anonymous users can subscribe
themselves to the list, the list creator and/or site manager can choose

whether the list is moderated or closed and how it is archived.