What is it?
index.cgi is a CGI frontend to your Mail::Toaster. It consists of two files, the index.cgi and an index.tmpl file. The index.tmpl is (almost) pure HTML so you can customize it to suit your needs. You can insert your logo and alter which options are available to your users by editing toaster.conf.
Can I edit it?
You can control what elements are shown by editing toaster.conf. There is also an index.tmpl file that comes with it. It's a (almost) pure HTML page that you can edit to please your tastes. If you do a good job of editing it, post a notice to the mailing list.
Can I use it without the rest of your toaster?
Yes, you will need still need to install Mail::Toaster and HTML::Parser but once that's done, Mail::Toaster::CGI will work for you.
What needs to be done to Apache?
If you allow Mail::Toaster to install Apache for you, then nothing. Otherwise, you might need to make some alterations to your httpd.conf file. You need to enable the .cgi handler, add index.cgi to the DirectoryIndex, and enable ExecCGI on the directory index.cgi is installed in. See the contrib directory of the Mail::Toaster distribution for a diff (for perusal) and a patch file (to be applied against an Apache2 httpd.conf). Here is the diff:
Reload Apache and you're all set.
Last modified on 4/28/05.