Souper Mail Utility Integration
Overview;
You want a program to
· upload files of any size via a web page, to your email sytem something like
http://yousendit.com but where the forms are to whatever email address you permanently set as per sample at
http://dc.communityprinters.com/smeserver/soupermail/formupload.htm (purposely disabled, needs your host inserted to work)
You can also save form data to a database
create pdf files from data entered in a form
Mention is also made of using PGP PrettyGoodPrivace
I have used Soupermail for file uploads on E-smith (SME-Server) versions 4.2, 5.5 & 5.6 and 6.0.1 in Primary ibay only. I did not create Soupermail but it works for me. However this time around I finally made some notes to write it up.
If you want to run Soupermail from elsewhere please do it from primary ibay first so you know it in fact works. If you figure out how to have it work from an ibay please write it up.
The Perl included with e-smith/sme works fine. I am also using CLAM, and FetchMail and the program for blocking exe’s and they seem to be getting checked as of April 2006 antivirus, in fact you will need to increase the limit on the antivirus program in the associated template if you want to send larger files without them getting caught in the problem files.
See
http://forums.contribs.org/index.php?topic=31616.0Download and install MimeLite & its instructions
MIME::Lite is a Perl module that Soupermail uses to generate properly
formatted emails. It is available from:
http://www.cpan.org/modules/by-module/MIME For people wanting to install for UNIX: (works with SME server)
Download and extract the files onto your webserver, and follow the
instructions in the README file.
I used
http://www.cpan.org/modules/by-module/MIME/MIME-Lite-3.01.tar.gz The above file can be extracted with Winrar available for trial at
http://www.rarlab.com/I simply extracted to a ibay on the server and then logged on directly on the server as root.
Typed MC to use the graphical Midnight Commander and used the navigation features to change to
the Ibay where the extracted files were. Then quit Midnight Commander with a F10
Then typed the following remembering Linux is case sensitive
perl Makefile.PL
make test
make install
Some installation and test will happen and you should get all tests successful.
You are finished with setting up MimeLite
___________________________________
Download and install Soupermail & its instructions which includes a lesson on creation for
of upload forms and how to prevent Java scripts being ran in your forms, compromising your server.
Soupermail is available at
http://soupermail.sourceforge.net/Download Soupermail from here
http://soupermail.sourceforge.net/download.htmlRun the simple method of install using souperfinder.html placed in your primary/html directory and souperinstall.pl and soupermail.pl in your primary cgi-bin directory and chmod 755 them. Then type the souperfinder.html location into your web browser from another computer. Use the paranoid setting, it runs correctly if in the primary/html directory and if you remember to chmod 755 it and will generate a file you then save by copying and pasting into a file with the name soupermail.pl
and place this file in your primary cgi-bin directory.
You will notice a few problems with the text file created.
It points to a directory that doesn't exist. Create that directory.
You must chmod 755 soupermail.pl or you will get a error immediately on trying to do a upload.
Also adjust the max file size and time out to suit your needs.
Create a sample
formupload.htm
and
formupload.txt
file using the tutorial or use mine provided at
http://e-smith.communityprinters.com/soupermail and modify to suit your tastes. Make sure the text file has the mimeon setting to prevent Java scripts being ran from within your forms. And you also need the soupermail.allow file within the same directory. I have all files needed by me for Soupermail to work with e-smith at
http://dc.communityprinters.com/smeserver/soupermail/Hope you find this useful. I expect some will use the features such as setting up forms and pgp (pretty good privacy) and I look forward to learning from you.
I will also try to include this in the Contribs (how to area under Email file management
Modified email July 1st to correct new location of my sample upload forms.
Modified May 2006 to include mention of increasing Clam Antivirus file size.
Ken Graham