Contribs

You may become a contributor :how to contribute to Sympa

Do you want to win a Sympa tee shirt ? Add your CSS, customized templates or colors proposition in the customize section.

B. Roucaries wrote this script that makes using postfix with Sympa easy.

Install this file as /var/lib/sympa/bin/postfix-to-sympa.pl.

It will replace any configuration.

On the sympa side we should ask to not generate alias (by setting the alias_manager parameter value to /bin/true) and it will automagically configure.

To configure a virtual domain (lists.example.com) to connect to sympa, edit Postfix thusly:

/etc/postfix/main.cf

      relay_domains = ... lists.example.com
      transport_maps = hash:/etc/postfix/transport
      sympa_destination_recipient_limit = 1

/etc/postfix/master.cf

    sympa unix  -       n       n       -       -       pipe
      flags=FR user=sympa
      argv=/var/lib/sympa/bin/postfix-to-sympa.pl ${nexthop} ${mailbox}

/etc/postfix/transport

   lists.example.com   sympa:

Note that (root|postmaster|abuse|mailer-daemon|sympa-request|sympa-owner|listowner)@lists.exemple.com are redirected to listmaster@exemple.com.

We received a lot of contribs related to migration and:or archives. Please browse the section of the contribs repository dedicated to migration and archives.

(Marco Gaiarin)

Marco has provided a script that wraps around Sympa's mhonarc call to do a mail→news gateway.

* Download

(Jean-Hugues Belpois)

This document describe how to make/update lists automatically from an LDAP directory. This is use for making/updating students lists in a university environnement, but can easily be adpated to others. Two files are availables :

• Odf document (in French, ask for english version) describing the way to proceed : :contribs:students_lists_instanciation.odt

• Shell script use to forge the XML file of Sympa instanciation : :contribs:create_xml.sh.txt

LemonLDAP is a Single Sign-On system.

The authentication module for Sympa :

• http://sourceforge.net/projects/pluglemonsympa/

By using this small shell script you can (re)set to zero the trafic statistics (i.e : the number of emails send to the list) of all the lists of a sympa server. To do that, you must :

1. Be 'root' or 'sympa' user
2. Run the script in the home directory of sympa (near the list_data directory)

• Download script : :contribs:reset-trafic.sh.txt

• Discuss about it : Jean-Hugues Belpois

(Patrick von der Hagen)

This plugin for Munin, collects statistics about the spools of Sympa :

• Download the plugin
• Sample output

(Jose-Marcio Martins da Cruz)

This milter checks each (enveloppe) recipient to see if it's one of the lists managed by Sympa, and if it finds any, it adds a header X-Sympa-RCPT to the message. This header allows Sympa to retrieve full original recipient information including “plussed” addresses, before any rewriting done by sendmail.

• sympa-milter homepage

(Ludovic Marcotte)

This contrib replace it for ldap based alias management. It is now distributed with Sympa, starting with Sympa 5.2. Read comment from Ludovic

This plugin allows to extends these mecanism to 1) authenticate users via on Shibboleth authentication server (also named Identity Provider) and 2) use list membership notions in dokuwiki's authorization engine. This plugin has been written by Dominique Launay, Olivier Salaün and Yohann Lecuyer .

• http://www.cru.fr/documentation/federation/dokuwiki_shibbolethauth

(David Pépin did it during a traine period. Now a product maintened by CRU staff)

This plugin allows to use Sympa password and check list membership in order to control authentication and authorization in Dokuwiki.

• The plugin homepage
• Sympa and Dokuwiki farm integration for Virtual Organizations

The goal is to control access to some resources using subscribers definition for a particular list.

• Documentation of the module

(esup-portail consortium)

A soap client to be included in u-portal product (need sympasoap.pl). It use SSO authentication based on CAS proxy credential.

• http://www.esup-portail.org/consortium/espace/download/CSympa/

(Michelle Murrain)

The script extracts data from sympa, and either prints a list of email addresses to STDOUT, outputs a comma-delimited file with the fields you want, or maps the data to a database of your choice (postgres or mysql), and INSERTS lines. (no update yet)

• sympa_extract.pl

(Sébastien Santoro)

This script, based on the SOAP extension of PHP 5, allows using the Sympa SOAP interface.

• the class itself

• a use case of the class

a ruby Sympa soap interface from Daniel Berger

(Chris Hastie)

I put together to enable an existing PHP application to set Sympa's session cookie. Obviously all the authentication logic is handled by the PHP app. Once that is satisfied that the user should be authenticated to sympa it can use this class to make the appropriate updates to sympa's session_table, then set a cookie:

include ('SympaSession.php');
$ss = new SympaSession($email);
$sympa_session_id = $ss->getid();
setcookie("sympa_session", $sympa_session_id, 0, '/',
$sympa_session_domain, FALSE);

It suits my purposes, but is not hugely flexible. See it as an example to be modified, not a fully tested and guaranteed working class.

download SympaSession.php.tar.gz

Starting with Sympa 6, mhonarc can be replaced by some other archiver engine. Here is one based on MySQL, it may use as an example for any other. The program is plugued in Sympa by editing wwsympa.conf to add the custom_archiver parameter with the path of this program asx parameter.

custom_archiver.pl

XIMF is a way to extend SMTP services. For more information see trustedbird projet

A private page for contribution related to XIMF

Script to assist with list family modifications and to automate some features:

• Create a new list
• Add a new list to an existing family
• Instantiate a new family, or update changed settings on a family
• Remove a list, keeping an archive
• Remove a list completely
• Automate customization of footer

http://www.sympa.org/contribs/listscreatemodifytool