= News =

 * 15/02/2010 - As of about 2-3 days ago, I've merged the Squirrelmail-Postfixadmin plugin code into [http://postfixadmin.sf.net  Postfixadmin] itself - in the ADDITIONS directory. This should make it more accessible to others.... my intention is to continue development on the Sourceforge version, and this site will eventually become irrelevant/outdated. 


= Squirrelmail - PostfixAdmin plugin =

This site  contains the code, and hopefully associated documentation, for a [http://www.squirrelmail.org Squirrelmail] plugin for [http://www.postfixadmin.org Postfixadmin]. In English, this means that if you are using Postfixadmin to administer domains/users for email, then your users can change their :

 * Vacation
 * Password
 * Forwarding 

settings within Squirrelmail.

= Danger ( ? ) Will Robinson! =

As of 26th August 2009, the plugin has been rewritten to use the XMLRPC API exposed via Postfixadmin. This is good because :

 * Squirrelmail no longer needs to have access to the database
 * There's less chance of the Squirrelmail code getting out of sync with Postfixadmin (E.g. DB Schema etc)
 * There's no need to synchronise e.g. password encryption mechanisms or configuration options
 * There's a lot less code to maintain from the plugin side

There are a couple of draw backs :

 * We now depend upon the Zend Framework (preferably v1.9.x at the time of writing) (Download from http://framework.zend.com/download/latest - the minimal one should be sufficient)
 * Traffic to the XmlRpc interface needs encrypting (e.g. https) - this is something _you_ need to do
 * When trying to use the plugin, the user will be prompted to enter their mailbox password - this is necessary to authenticate with the remote XmlRpc interface

= License =

See source:trunk/LICENSE.txt

= Installation =

See source:trunk/INSTALL 

= Readme / Credits =

See source:trunk/README


= Download / Installation =

 1. Download from Subversion to '''svn co http://squirrelmail-postfixadmin.palepurple.co.uk/svn'''
 
If you wish to download the 'stable' version (i.e. before the XmlRpc related changes), please checkout revision 35 (i.e. svn co -r 35 ..... )

Note - the project is relatively mature, simple, and stable, and so far - the only changes that have been applied are bug fixes and security related. Therefore, following 'subversion' should be acceptable for live sites.



= Bugs + Feedback etc =

Although this is obviously running Trac, in an effort to avoid getting 'spammed' to death, I've disabled 'POST' access for normal (anonymous) users. 

However, few things would make me happier than finding out others are using this, and are able to provide feedback, bug fixes or bug reports.

If you'd like to get in touch, try david @ without-this.palepurple.co.uk (removing my crude spam defense). 

= Foot note =

This project is supported by [http://www.palepurple.co.uk Pale Purple Ltd] who provide Mail servers based around Postfixadmin and Postfix.

You may find [http://codepoets.co.uk/postfixadmin_squirrelmail_plugin this page] useful (this is where the pre-trac/svn stuff was)