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