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

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

and..
mojo (folder/directory) -> dada (folder/directory)

This means instead of a url like this:

 http://heythatsyoursite.com/cgi-bin/mojo/mojo.cgi

you'll now see:

 http://heythatsyoursite.com/cgi-bin/dada/mail.cgi

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".
$FILES

No change.
$MAILPROG

No change.
$MOJO_URL -> $PROGRAM_URL

Easy enough.

Other Variables

$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;

etc, etc.

List Settings

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.

Template tags

[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