Mojo Mail 2.x to Dada Mail 2.x Guide
- Upgrading Dada Mail from Mojo Mail 2.8.9 and below
- The Really Really Good News
Upgrading Dada Mail from Mojo Mail 2.8.9 and below
The Really Really Good News
2.8.10 of Dada Mail is backwards compatible with all versions below, most of the name changes are superficial (ie, the name was changed, nothing else). This document is to get you familiar with this tweaked interface, both inside and out. It's not too too scary, but is hopefully exhausting.
Differences In Terms
So not to have to repeat myself everytime, I'll use a similar notation of
What Something Was Called -> What It's Called Now
for all the changes. If there are any notes, I'll provide them after the changed term.
Programs, Scripts and Files Renamed
mojo.cgi -> mail.cgi
mojo (folder/directory) -> dada (folder/directory)
This means instead of a url like this:
you'll now see:
Also, the MOJO directory has been renamed, DADA, but we'll get to that in much more detail.
.mojo_config -> .dada_config
This is only relevant if you use an outside config file. Just remember to rename the outside config file, .dada_config
mojo_send.pl -> dada_send.pl
mojo_bounce_handler.pl -> dada_bounce_handler.pl
The bounce handler's name is still, Mystery Girl, as I'm still in love with Karen O, the lead singer of the Yeah Yeah Yeahs and will see her on November 20th at the Gothic Theatre to put my love for her in words.
(See the Mystery Girl FAQ for more information on that)
These couple few are Magic Book scripts:
mojo_backup.pl -> dada_backup.pl
mojo_digest.pl -> dada_digest.pl
mojo_stats.pl -> dada_stats.pl
The Four Required Config.pm variables
$MOJO_ROOT_PASSWORD -> $PROGRAM_ROOT_PASSWORD
You'll notice that most everything referring to, "mojo" has been changed to either "Dada", or generically to, "program".
$MOJO_URL -> $PROGRAM_URL
$S_MOJO_URL -> $S_PROGRAM_URL
$MOJO_CONFIG_FILE_DIR -> $PROGRAM_CONFIG_FILE_DIR
$MOJO_ERROR_LOG -> $PROGRAM_ERROR_LOG
$MOJO_LOG -> $PROGRAM_USAGE_LOG
Library Directory Structure
The Dada Mail library now goes under the name of DADA instead of MOJO. I am not going to list every single library file, but here are some examples.
MOJO/Config.pm -> DADA/Config.pm
MOJO/Mail/Send.pm -> DADA/Mail/Send.pm
MOJO/MailingList/Subscribers/Postgres.pm -> DADA/MailingList/Subscribers/Postgres.pm
We're good? Good. Now (and this is the important bit) if you do have a customized program that uses these libraries files, make sure you change those as well, example:
use MOJO::Config; -> use DADA::Config;
use MOJO::Mail::Send; -> use DADA::Mail::Send;
There's only one list setting that has been renamed:
mojo_email -> list_owner_email
This is sort of a, "long time comin'" anyways, since the list owner email was always refered to as, list owner email and never mojo_email, except in code. For the time being, there will be a shin in DADA/MailingList/Settings/Db.pm to look for mojo_email is list_owner_email is not set.
[mojo] -> [dada]
Again, there will be a check for both for the time being, but when you upgrade, please update your templates with the [dada] tag, instead of the [mojo] tag.
And the rest
If I totally missed something, you can make a best guess that any other reference:
mojo -> dada
Mojo -> Dada
MOJO -> DADA