send_dada_mail.pl - Send Mailing List Messages from the command line easily
- REQUIRED ARGUMENTS
- CONFIGURATION AND ENVIRONMENT
- BUGS AND LIMITATIONS
- LICENCE AND COPYRIGHT
send_dada_mail.pl - a small extension that allows you to send a mailing list message out from the command line.
Refer to the version of Dada Mail you're using - NEVER use a version of this proggy with an earlier or later version of Dada Mail.
Saying that, this extension is a work in progress, and probably breaks all over the place.
This program is supposed to be used similar to how the sendmail utility is to be used - although it's not (in no way, shape or form) a sendmail command replacement. No.
Anyways, you can use it via the command line by calling it up:
prompt:] /home/account/cgi-bin/dada/extensions/send_dada_mail.pl --list mylist
And type out your message:
Subject: This is my subject! This is my message! -- Justin ^D
The, message part of this should be a full on email message, headers and all. As the above example shows, you can just place in the headers you'd like to have and any missing fields will be filled in intelligently for you. One header I'd make sure to put in is the Subject: header.
Skip two new lines and start entering your actual message.
Like the sendmail command, it's real use is when you call it in another script. In Perl, that would look like this:
#!/usr/bin/perl open( DADA, "|/home/youraccount/cgi-bin/dada/extensions/send_dada_mail.pl --list mylist") or die $!; print DADA "Subject: This is my subject!\n\n"; print DADA "This is my message!\n\n"; print DADA "-- Justin"; close DADA or die $!;
As you'll notice from these examples, the, --list flag is being passed, and the parameter is set to a valid list short name
If this parameter is missing, or the list short name is not valid the script will exit with an
exit status of,
1 and you won't be sending anything.
Currently, the only flag that's accepted is the --list flag.
CONFIGURATION AND ENVIRONMENT
You probably want to set the explict paths to your Dada Mail libraries.
For example, if your Dada Mail installation is at:
Your Dada Mail libraries would be at:
The following lines on top of this script would be changed from:
use lib qw( ../ ../DADA ../DADA/perllib );
use lib qw( ../ ../DADA ../DADA/perllib /home/account/cgi-bin/dada /home/account/cgi-bin/dada/DADA/perllib );
Dada Mail 3.x/4.x support
I haven't tested this with Dada Mail 3.x yet (or 4.x). Does it work well?
Currently, there's not much security in this script - only the check for a valid list short name. Normally, you'd have to either log into the List Control Panel to send a message out, which requires a password, or, use the Bridge Plugin, which has it's own slew of checks.
Because of that, I'd only use this script where you're mighty sure that abuse will not happen (ha.). Abuse of this extension is quite possible and very easy, as you're giving the option of any program to send to any Dada Mail-administrated list as much as it would like. You see where I'm going here with this. OK? Ok.
Future versions will most likely have some semblance of security and feedback (general) about this extension is more than welcome.
BUGS AND LIMITATIONS
Please, let me know if you find any bugs.
LICENCE AND COPYRIGHT
Copyright (c) 1999 - 2014 Justin Simoni All rights reserved.
This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.