NOTES


2.10.13

Removed NDBM_File and ODBM_File from the @AnyDBM_File Config.pm array

Both the NDBM_File and ODBM_File type stinks for what Dada Mail uses it for - it's won't work at all for archiving and is starting to fail pretty regularly with list settings, so it's now recommended that if this is your only option, to set up Dada Mail using the SQL backend(s), especially for list settings/archives, if not for everything currently available.

If you must use NDBM_File or ODBM_File (for example, you were using it before and are upgrading, just find this line in the Config.pm file:

 BEGIN { @AnyDBM_File::ISA = qw(DB_File GDBM_File NDBM_File ODBM_File) }

And change it to:

 BEGIN { @AnyDBM_File::ISA = qw(DB_File GDBM_File NDBM_File ODBM_File NDBM_File ODBM_File SDBM_File) }


2.10.11b

2.10.11b was released to solve a few niggling bugs in the 2.10.11 release. If you're using either:

It's advised to upgrade to this version. See the changes log:

changes.pod.html#2_10_11b

For more information.

Related to the latter issue:

If you find that you're having trouble with logging into/out of your mailing list and/or saving and list setting dealing with a password, make sure to reset your cipher keys, by visiting a URL like this:

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

where, ``http://example.com/cgi-bin/dada/mail.cgi'' is the URL to your Dada Mail.

If this does not clear this issue, you may have to manually remove the cipher keys via SQL. The following SQL statement should do the trick:

 delete from dada_settings where setting = 'cipher_key';

Again, this should only be an issue if you're currently using Dada Mail, 2.10.11.

If you do not want to install the entire 2.10.11b program over the 2.10.11 version, you can simple replace the following files:

but great care should be made in doing so.


2.10.11

Change in Required Perl Version: 5.6

This release is the first stable release to require at least version 5.6 (sometimes written as 5.00600) of Perl. It's been at least 5 years since ver. 5.6 of Perl was released, so this shouldn't cause too much trouble.

Note on version numbering:

This is version 2.10.11 of the program - NOT 2.11 -

Most of the new features slated for 2.11 are still in 2.10.11, but are labeled, ``Experimental''. One exception to this is the Auto Pickup of Dropped Mailings feature, which has been christened, Stable. Do look at the NOTES for version 2.11, as all changes made in the 2.11 alphas are still around for Dada Mail, 2.10.11.

Removed SDBM_File from the @AnyDBM_File Config.pm array

The SDBM_File type sucks for what Dada Mail uses it for - it's won't work at all for archiving and is starting to fail pretty regularly with list settings, so it's now recommended that if this is your only option, to set up Dada Mail using the SQL backend(s), especially for list settings/archives, if not for everything currently available.

If you must use SDBM_File (for example, you were using it before and are upgrading, just find this line in the Config.pm file:

 BEGIN { @AnyDBM_File::ISA = qw(DB_File GDBM_File NDBM_File ODBM_File) }

And change it to:

 BEGIN { @AnyDBM_File::ISA = qw(DB_File GDBM_File NDBM_File ODBM_File SDBM_File) }

Mystery Girl

The dada_bounce_handler.pl script has been moved from dada/extensions to dada/plugins, since the script acts more like a plugin, than an extension.

Dada-ized FormMail

The Dada-ized FormMail has been updated to use the latest NMS FormMail.pl script available. See the docs - as the form fields needed have changed considerably.

The Dada-ized FormMail has also been moved in the distribution from:

dada/extras/scripts/FormMail

to:

dada/extensions/FormMail

It's documentation has also moved to:

Dada-ized_FormMail_README.pod.html

boilerplate_plugin.cgi

The boilerplate_plugin.cgi script has been moved from:

dada/extras/scripts/boilerplate_plugin.cgi

to:

dada/plugins/boilerplate_plugin.cgi

Dada-ized TFmail

TFmail is similar to FormMail, but is quite a bit more configurable and could be more secure to use. If you have a choice, use TFmail - but realize it's a bit more daunting to configure.

You can view its documentation at:

Dada-ized_TFMail_README.pod.html

New Plugin: change_root_password.cgi

There's a new plugin called, change_root_password.cgi which allows you to change the Dada Mail Root Password via the list control panel. You'll need to setup Dada Mail using the advanced installation instructions, with an outside config file (.dada_config). See its documnetation at:

change_root_password.cgi.html

for more information.

dada_bridge.pl moderation system - Many Changes!

The moderation system in Dada Mail, pre 2.10.11 really wasn't a moderation system at all, but simply a list of email addresses that can send to an announce-only mailing list, other than the list owner.

The entire system has basically been scrapped for the time being, and a different system has been put in its place.

The system in 2.10.11 works by allowing you to enabled/disable moderation and if moderation is enabled, any messages not sent to a discussion mailing list that are from a subscriber of the list will first have to be accepted by the list owner.


2.11 alpha 3

Config.pm variable changes

Removed the following Config.pm variables:

Added the variable:


2.11 alpha 2

Program Changes


2.11 alpha 1

2.11 alpha 1 is currently based on the 2.10.10 Release Candidate 1 version. Any problems found and solved in the 2.10 series after that version will not be reflected in this release.

Below will attempt to outline any peculiarities of the new features in 2.11:

Do see:

    http://dadamailproject.com/features/2_11_dev/index.html

for more information of these features.

Auto-Pickup of Mail Sendings

This is most likey the roughest and buggiest newest feature, but it's likely to bring about the most interest as its usefullness cannot be discounted. It needs much testing, feedback, etc. We WANT to hear any problems you've had with the feature.

This feature is to attempt to solve a shortcoming in the design of Dada Mail, most particularily this (taken from the Roadmap docs):

2.11's main feature will be an overhaul of the mass emailing routines. The problem with the current sending routines is that there is no meta information saved about the sending process, thus, if/when a problem does occur during the process, there's no way to automatically pick up the mailout. This is further made delicate, because in Dada Mail, it's a one shot thing - a mailout starts, and if it doesn't finish, it doesn't finish. This is a really bad spot to be.

More information:

road_map.pod.html#release_of_2_11

Note! That not all the features talked about on the roadmap are currently made.

To activate this feature, log into your list and go to Manage List - Sending Options and check the option, ``Auto-Pickup Dropped List Message Mailings''

There's a related option entitled, ``Restart Mailings After Each Batch''. Only use this option if you notice that your batches have failed any time the program sleeps for any amount of time.

We seriously, incredibly recommend enabling batching as well.

When you send a list message from the list control panel, do so as you normally would, but once the screen refreshes, click the button labeled, Monitor Your Mailing!

You'll be taken to a screen with a table with the following information:

The, Monitor Your Mailing screen should refresh itself via a simple Javascript hook. If it does not, we'd like to hear from you - let us know your setup, including the browser you are using.

It is OK to refresh this screen manually, as many times as you'd like. It shouldn't harm your mailing in any way. The refresh will be basically the time between your batches that you've set, if the time is more than 10 seconds. If the time is less than 10 seconds, the screen will refresh every ten seconds.

If you navigate away from this screen, mailing will still go on - the screen itself does not control a mailout, it simply reports the status of a mailout and will restart a mailout, if needed. If a mailout stops and you are not on this screen, there won't be anything to restart the mailout.

You can navigate back to this screen by logging back into your list, and going to, Send a List Message - Monitor Your Mailings and selecting the appropriate mailing. As long as you're on the indvidual, Monitor Your Mailing screen, the auto-pickup feature will be in action.

NOTES:

Domain-Specific Sending Tunings

This feature should be fairly stable. Let us know if you do not see the changes for a specific domain as you've set them.

The option is located under Manage List - Sending Options - Advanced

Check, <Bune Mail Sending For Specific Domains>, save your changes and then click on, Configure Domain-Specific Sending Tunings... to actually create your tunings.

Better Spam Protection for Discussion Lists

This feature is a part of dada_bridge.pl. Under the header, Mailing List Security check the option: Ignore messages labeled as, ``SPAM'' by SpamAssassin filters. Note! If you do have access to SpamAssassin, this feature isn't going to work for you.

There's currently two ways to look at the message for the SpamAssassin score. The first one: Looking for the embedded SpamAssassin Headers, is the one you want us, if it's available. It'll look for headers in incoming messages that look like this:

 X-Spam-Checker-Version: SpamAssassin 3.1.3 (2006-06-01) on 
        example.com
 X-Spam-Level: 
 X-Spam-Status: No, score=-1.8 required=5.5 tests=BAYES_00,FORGED_RCVD_HELO,
        HTML_MESSAGE,MIME_HTML_ONLY,WHY_WAIT autolearn=no version=3.1.3

It'll read this information and if the score is over what you've set, the program will outright reject the message. Because there's no real warning (it will be logged in the error log), do keep the score somewhat conservatily high.

The other way you can use this feature is by reading the message itself and manually giving it to the SpamAssassin filters, (Use the SpamAssassin Modules directly). If you can help it, try not to use this feature, as it is slow and uses a lot of memory.

There's a third option that we haven't implemented yet, and that's to call the spamd daemon directly. We'd like to get this feature implemented, so if you have a server where this is available, let us know;

Social Bookmarking + Link Sharking badges in Message Archives

Currently, there's no way to turn off/on the badges - or specify which badges get shown or not, but you can tweak these to your heart's delight in the:

    dada/DADA/Template/templates/archive_screen.tmpl

Currently, the only badges shown are ones for:

But, the following can be easily uncommented and utilized:

The badge images are in the dada/DADA/Template/template directory under the names:

If you'd like to play around with those...

CAPTCHA Enhanced email subscription confirmation

More information on CAPTCHA:

http://en.wikipedia.org/wiki/CAPTCHA

You can set this option in Manage List - Mailing List Options

You will need the GD CPAN perl modules installed and GD as well for this feature to be available.

To tweak the CAPTCH image, do see the Config.pm variable, $GD_SECURITYIMAGE_PARAMS.

The CAPTCHA image will be shown when someone attempts to confirm a subscription to a Dada Mail list. They'll be asked to enter the string of letters/numbers they see in the CAPTCHA image. They won't be able to subscribe until the successfully do this (there's no limit on how many attempts they can have, although the image will change in every attempt)


2.10.10

Batching enabled by default for new lists.

We've decided to enabled sending in batches by default. The default setting is *very* conservative, at 1 message/every 1 second. That'll give you a sending speed of no faster than 3600 emails/hour. Adjust as needed.

List Subscription Errors - When Are The Catched?

Not to confuse you too much, but Dada Mail has the option to use Double-Opt-In confirmation. We strongly suggest you use it. There's an option to not, but you'll be shooting yourself in the foot if you don't.

Saying all that, When you don't set the double-opt-in and a subscriber tries to subscribe, Dada Mail will basically fake the confirmation of subscription part, except, that it'll still make sure the email is valid, not already subscribed, not blacklisted, etc, at the, subscription step - which is basically the step we're telling it to skip.

This doesn't really sound like that bad of a deal - two sets of error checking, but, if you're trying to do something specific at the error checking, like redirecting to a URL upon an error, you'll find that this, just doesn't work. And thus, the bug.

This bug has been fixed in Dada Mail, but will cause a slightly different behavior in the program - so:

If you turn off double-opt-in (which you shouldn't), and want to redirect on a subscription error, it will work as advertised. If you're using a version below 2.10.10, the error will be trapped and your preferences will be triggered as if you're on the, subscription confirmation step - which should had been skipped. I know. Confusing.

List and Dada Mail Root Passwords

There's a slight change on how Dada Mail handles new passwords are accepted and how passwords are handled when you log into a list.

In the past, if the List Password was the same as the Dada Mail Root Password, the user would be granted login as if they were using the Dada Mail Root Password. This causes a problem, since, perhaps it was purely coincidential the List and Dada Mail Root Password were the same - giving the person who only has the list password right that only someone who logs into using the Dada Mail Root Password usually has. By default, one of these privileges is the deletion of a list in entirely.

To counteract this bug, you can no longer set a List Password that same as the Dada Mail Root Password on list creation.

If the List Password is changed to be the Dada Mail Root Password, upon log in of the list again, the password will only work as a regular List Password. If this comes as a surprise to you, simply reset the List Password as something other than the Dada Mail Root Password.

SQL backend for sessions

We've updated the SQL tables for both MySQL and Postgres - if you're using either of these backends, please drop your current sessions (usually called, dada_sessions) table and create the appropriate new table. Should clear up a lot of problems.

Slight $ADMIN_MENU changes

The Config.pm variable, $ADMIN_MENU holds the information needed to create the left hand menu in the list control panel.

If you're setting this variable in an outside config file (.dada_config), do note that it has changed slightly. The, Sign Into a Different List menu item has changed. It used to look like this:

        {-Title      => 'Sign In to Another List',
         -Title_URL  => "$S_PROGRAM_URL?flavor=sign_in",
         -Function   => 'sign_in',
         -Activated  => 1,
        },

It now looks like this:

        {-Title      => 'Log Into Another List',
         -Title_URL  => "$S_PROGRAM_URL?flavor=log_into_another_list",
         -Function   => 'log_into_another_list',
         -Activated  => 1,
        },

If you do use this variable in an outside config file, you may want to change the entire variable, or just this little part.


2.10.9

%SQL_PARAMS

The %SQL_PARAMS Config.pm variable has a new key/value, it looks like this:

 session_table    => 'dada_sessions',

If you have an outside config file, you may want to add it, although the key/value pair will only be used if you're using the new sessions system that uses either the PostgreSQL of MySQL as it's backend.


2.10.7

The Config.pm variable, $DB_TYPE has been renamed, $SUBSCRIBER_DB_TYPE

The Config.pm variable, $ARCHIVE_EDITOR_URL has been completely removed.


2.10.5

HTMLArea support has been replaced with FCKeditor support. More information on FCKeditor:

http://www.fckeditor.net/

More information on how to use FCKeditor with Dada Mail:

Config.pm.html#fckeditor_integration___fckeditor_url


2.10.4

RSS feeds are now 2.0, up from .91; Atom feeds are now 1.0, up from .03.

Atom feeds may not be supported by all feed readers, but .03 has been officially deprecated.

Best to upgrade the program if you find these features important.


2.10.2

Archive Editing has been reimplemented in a plugin, more information:

archive_editor.cgi.html


2.10.1

Subscription SQL tables changed!

Refer to:

 dada/extras/SQL/dada_subscribers.mysql

for MySQL, and:

 dada/extras/SQL/dada_subscribers.sql

for Postgres users. If you are running 2.9 and above, you may want to make your archive tables look like this.


2.10

Discussion List Suggestion - Important:

Since discussion list archives send/receiving/archive HTML messages, it's really incredibly suggested (bolded, underline) to check:

Disable Embedded JavaScript in Archived Messages

in Manage Archives - Archive Options - Advanced


 =head2 CSS file changes!

 The default_css.css file has been basically rewritten. If you are currently relying heavily on changes to this file, please review the new version before upgrading.

%STYLE Config.pm button styles removed!

As documented, the (deprecated) %STYLE variables have been removed.

Many new features SQL-centric!

The following features require the Subscriber Postgres/MySQL backend:

The following features require the Archive Postgres/MySQL backend:

It's also suggested that if you use the dada_bridge.pl plugin, to use the SQL backend.


2.9

MySQL/Postgres Archive Table Changes!

The table schema for the archive table in Dada Mail has changed!

Consult:

 dada/extras/SQL/dada_archives.sql

for the new schema and update your tables accordingly.

If you're using the Default DB_File backend for archving, you don't have to do anything special;

dada_send.pl has been removed from the distribution

There is NO version of dada_send.pl for Dada Mail 2.9. For an alternative, try the dada_bridge.pl plugin, which provides almost complete overlap of features.

Program Usage Log - set by default!

The Program Usage Log, set under, $PROGRAM_USAGE_LOG, has been set to:

 $PROGRAM_USAGE_LOG ||= $LOGS . '/dada_usage.txt';

by default.

setup_list subroutine removed!

If you have outside programs that use this subroutine, you will need to change your program from using this subroutine (example)

 use DADA::App::Guts
 setup_list({list => $list, 
             foo  => 'bar', 
             });

to:

 use DADA::MailingList::Settings; 
 my $ls = DADA::MailingList::Settings->new(-list => $list); 
 $ls->save({foo => 'bar'});

to the following method - this is an example from

DADA::App::Guts::open_database subroutine removed!

Here's the old style:

 my %list_info =  open_database(-List => $list);

Here's the new way of doing things:

 use DADA::MailingList::Settings
 my $ls = DADA::MailingList::Settings->new(-List => $list); 
 my $li = $ls->get; 
 my %list_info = %$li;

check_list_security subroutine changed!

Old Way:

 my $root_login = check_list_security(-Admin_List      => $admin_list, 
                                      -Admin_Password  => $admin_password, 
                                      -IP_Address      => $ENV{REMOTE_ADDR},
                                      -Function        => 'send_email');

New Way:

 my ($admin_list, $root_login) = check_list_security(-cgi_obj  => $q,  
                                                     -Function => 'send_email');

%STYLE Config.pm button styles deprecated!

Consult the default_css.css file in dada/DADA/Template/templates for ALL style information.

As a guide, here's how the old inline styles relate to the new style classes:

$STYLE{default_submit} -> input.plain

$STYLE{green_submit} -> input.processing

$STYLE{red_submit} -> input.cautionary

$STYLE{yellow_submit} -> input.alertive

List Templates default to... Default List Template

There is a new option in the ``Manage Appearance - Edit Template'' admin screen. The option allows you to `` Use the default list template.'' This may be set as your default for lists that are already created. If you have a list that seems to have suddenly lost its customized template, make sure this option is changed to something like, `` Use This Information For The Template: ''.

Redirect Links - Path Info'd

Like many of the links that are exposed to email messages, redirect links are now in a path info form, instead of in a query string. Redirect links seemed to be partly broken - most likely because of server upgrade/changes, and 2.9 should help in fixing. this.

MIME-Tools - bundled with Dada Mail!

MIME-Tools, the collection of Perl Modules needed by dada_bounce_handler.pl and the Dada Bridge Plugin are now included with Dada Mail and DO NOT need to be installed separately.

MIME::Base64 MIME::QuotedPrint - not in distro - may need to install manually

Removed: Plaintext version is created from HTML

Removed the ``HTML_and_text'' - Plaintext version is created from HTML in the ``Send a List Message'' basic screen. This is done automatically for you.

Removed: Resend Archived Message

Removed: Edit Archived Message

If you need to do any editing, do so *before* upgrading to this beta. Edit is going to be hard to implement, because a MIME editor is non trivial - like, how exactly do you edit a MIME message created by the ``Send a Webpage'' screen? Answer: You don't. :)

Removed ``attached images are part of the HTML message''

Did this ever work correctly?

Many default email templates changed!

If you're upgrading Dada Mail from an older version, and If you haven't made many changes to the default email templates - the text that you can edit in Manage Copy - Email Messages, it's best to reload the email templates.

This is done by navigating to: Manage Copy - Email Messages, select all the text from each of the textboxes and deleting the content. When you're finished, you can click, ``Save all changes''. The messages should respawn themselves.

If you've made many changes to these email messages, consult the Config.pm file to view the default email templates and apply the changes that you like manually.

Here's one issue that you'll want to MAKE SURE to change:

In the email subscription/unsubscription messages, you'll use a tag like this:

 [list_subscription_link]

and

 [list_unsubscription_link]

In this context:

 To confirm this subscription, please follow the below URL:
 
 <[list_unsubscribe_link]>
 
 (Click the URL above or, copy and paste the URL into your browser)

And:

 To confirm this unsubscription, please follow the below URL:
 
 <[list_unsubscribe_link]> 
 
 (Click the URL above or, copy and paste the URL into your browser)

You will NEED to change these links to:

 [list_confirm_subscribe_link]

And:

 [list_confirm_unsubscribe_link]

Respectively, or your subscription process will not work.

As stated above, if you're comfortable to start with the default email messages, the easiest thing to do is to delete all the content in the Manage Copy -> Email Messages screen and click, ``Save all changes''.

Magicbook Changes

Plugins/Extensions that come with Dada Mail have been updated to work with Dada Mail, 2.9, with the exception of the dada_digest.pl script, which currently doesn't work with 2.9. It will return once it has been properly updated.

Note also the text, while still relevant, hasn't been updated specifically for 2.9 either.


* 2.8.10

The program name has (obviously) changed. See the separate, ``Upgrading Dada Mail from Mojo Mail 2.8.9 and below'' doc.

The Dada Usage Log format has changed!

All logged lines will have the Remote IP Address of the client provoking the script (if there is one). The format is:

time[tab]remote ip address[tab]list[tab]action[tab]details

The $DEFAULT_LIST variable has been removed from Dada Mail. If you want to send a default template, use the $USER_TEMPLATE variable.


* 2.8.9

The Config variable, $PLAIN_TEXT_ENCODING has been removed. The same functionality is now done on a list-per-list basis. You can use the %LIST_SETUP_DEFAULTS key, plaintext_encoding to do the same thing, as well as use html_encoding for HTML messages. These can be tweaked in the Sending Options - Advanced control panel screen.


* 2.8.2

mojo_send.pl has been put back into the distro, for better or worse.

I've included CGI.pm, version 2.91 into the distro, since different versions of CGI.pm seem to all have their own unique ways of breaking things, and I'd like to know exactly which funky errors to expect.


* 2.8

The mojo_send.pl script has been taken out of the distribution because of manjor bugs and security problems. as such, group lists will not be supported in this version.

It's still uncertain whether group mailing lists will be supported in the future.


* 2.7.1

CipherSaber encryption has been put onto both POP3 passwords stored in Dada Mail's List settings files and for cookie information. You may recieve an error about dividing by zero in the Cipher key. If this happens, go to:

http://changetoyoursite.com/cgi-bin/mojo/mojo.cgi?reset_cipher_keys

and follow the directions. You also will have to reset your pop3 password manually.

The Mojofied FormMail has slightly different instructions, best to read the documentation!


* 2.7

The MySQL and PostgreSQL implementations have been changed! Please take note as previous SQL tables will NOT work until you alter them.


* 2.6.4

The outside config file scheme has been changed!

Please refer to the Config.pm docs to see how to use the outside configuration file