Subscriber Profiles
- Dada Mail Profiles
- Logging into your Dada Mail Profile
- List Administration and New Options with Dada Mail Profiles
- Configurating and Customizing Profiles
Dada Mail Profiles
Dada Mail Profiles allows your Dada Mail users to see an overview and work with all their various mailing list subscriptions.
Profiles allow your users to:
Keep their Subscriber Profile Fields fresh
Update their Profile, as well as all their Mailing List Subscriptions
Access Subscriber-Only Mailing List Archives
Bypass Mailing List subscription confirmations
Access Password Protect Directories
Password Protect Directories can be set up using the following plugin:
http://dadamailproject.com/d/password_protect_directories.cgi.html
Logging into your Dada Mail Profile
Your users can log into their Profile, by clicking the, [Profile Register/Log In] link, on the top right of most screens of Dada Mail.
From the Profile login screen, your users may log into their existing Profile, register a new Profile, or have their Profile password reset.
Profiles are created automatically, when a user subscribes themselves to any Dada Mail mailing list and their new Profile login information will be sent to them in the, "Subscribed" email message that's sent to them, after a successful subscription.
Once logged in, your users can:
Update their Subscriber Profile Fields
View their Your Mailing List Subscriptions
This section also always your users to interact with the mailing list: view archives, unsubscribe from the list, post to the list (if it is a discussion list). Any Password Protect Directories (set up with the Password Protect plugin) will also be available here.
Update their Profile email address
Updating this address will also update all the subscriptions they currently have, for each mailing list they're subscribed to.
Change their Profile password
Delete their Profile
Deleting a Profile will not terminate the user from any of their current mailing list subscriptions.
Once logged in, your users can also navigate through Dada Mail and view their logged in status at the upper right hand side of the screen.
All subscription forms in Dada Mail will be pre-filled out with the user's email address and the Subscriber Profile form fields will be hidden (so as not to have the user have to re-type the same information twice)
List Administration and New Options with Dada Mail Profiles
Since users can now log into Dada Mail, several options are now available for the List Owner.
Subscriber-only Archiving Access
List Owners can opt to have access to archived messages only available to logged in subscribers to their mailing list.
Skip List Subscription Confirmation
List owners can also opt to have the first step of the closed-loop opt-in system skipped for logged in users, as their email address has already been verified.
Configurating and Customizing Profiles
Dada Mail Profile options can be globally configured in your .dada_config
file. If you used the Dada Mail Installer to install Dada Mail, the necessary lines in your .dada_config
should already be present. They should look similar to this:
$PROFILE_OPTIONS = {
enabled => 1,
profile_email => '',
enable_captcha => 1,
enable_magic_subscription_forms => 1,
update_email_options =>
{
send_notification_to_profile_email => 0,
subscription_check_skip => 'auto',
},
gravatar_options =>
{
enable_gravators => 1,
default_gravatar_url => undef,
},
features =>
{
help => 1,
login => 1,
register => 1,
password_reset => 1,
profile_fields => 1,
mailing_list_subscriptions => 1,
protected_directories => 1,
update_email_address => 1,
change_password => 1,
delete_profile => 1,
},
cookie_params =>
{
-name => 'dada_profile',
-path => '/',
-expires => '+1y',
},
};
(if these lines are not present, you may paste them into your .dada_config file)
$PROFILE_OPTIONS
The following describes the various parameters and options available to you, for configurating Profiles. Nothing needs to be done for Profiles to work - they're enabled by default - just make sure that you are running Dada Mail with one of the SQL Backends.
enabled
Sets whether profiles are enabled, or not. Set to, 1
to enable, set to 0
to disable.
profile_email
When a registration email or reset password email goes out, it'll go out on behalf of this email address. We highly encourage you to fill out this variable, or these email messages may not be sent out correctly. Example:
profile_email => 'me@mydomain.com',
a little more fancy:
profile_email => '"My First and Last Name!" <me@mydomain.com>',
You may set two email addresses:
profile_email => '"My First and Last Name!" <me@mydomain.com>, "Another User" <someone.else@example.com>',
Although the From:
header that goes out will only hold one email address.
If Profiles are enabled and this variable is left blank, the list owner email address of one of your mailing lists will be used, instead.
enable_captcha
Registration for Dada Mail Profiles can be verified along with a CAPTCHA. We recommend this feature, if it's available. Set this variable to, 1
to enable CAPTCHA in the registration form.
enable_magic_subscription_forms
Magic subscription forms are pre-filled out with the subscriber's email address, if they're logged into Dada Mail. To enable this feature, set this variable to, 1
update_email_options
These options come into play if users use the option to update their Dada Mail Profile email address. This will also update the email address used for their mailing list subscriptions.
send_notification_to_profile_email
If set to, 1
, a notification email address about the Profile email address change will be set to whomever is set in the, profile_email
variable. If more than one address is set in this variable, it will be addressed to all the email addresses.
subscription_check_skip
This variable requires a little explanation:
When a user attempts to change their Dada Mail Profile email address, this new email address will first be validated by Dada Mail to make sure that it's not already on your mailing list, isn't black listed, things like that. To make customization easier, you may skip certain checks. By default, the following checks are skipped:
closed_list
The mailing list is closed to new subscribers
over_subscription_quota
The mailing list is over any subscription quota sent
already_sent_sub_confirmation
The mailing list had already sent a subscription confirmation email to the new address.
no_list
The list doesn't actually exist!
A complete listing of what checks are done (and what may be skipped) may be found at:
http://dadamailproject.com/d/MailingList_Subscribers.pm.html#subscription_check
To set your own list of checks to skip, you may change the, subscription_check_skip
setting to an array ref holding the checks to skip. For example:
subscription_check_skip => [qw(
closed_list
over_subscription_quota
already_sent_sub_confirmation
no_list
invite_only_list
)],
In this example, we added the, invite_only_list
test to the default tests to also be skipped. We do that so that if we have a Invitation Only list, we can still allow our subscription to change their email address.
By default, this setting is set simply to, auto
, which will tell Dada Mail to use the default set of tests to skip. auto
is a special setting and no other string setting will work - you'll need to use the arrayref style as shown above.
features
feature
holds parameters representing most of the major user-facing features of Profiles. Setting the parameter to, 1
will enable the features, 0
to disable the feature.
help
help
allows you to show/hide the, What are Dada Mail Profiles? link and screen.1
to enable,0
to disable.login
login
allows your users to log into their Profile. Disabling this feature will basically disable much of Profiles, so be careful when disabling.register
register
controls whether a new user may register to a new Dada Mail Profile. If disabled, a user may still register by subscribing to a new mailing list, or by a List Owner editing their Profile, or change their Profile password in the List Control Panel, if logged in with the Dada Mail Root Password.password_reset
password_reset
controls whether the, Forgot Your Profile Password? form is shown, or not. If it's not shown, a user's Profile password may still be reset by a List Owner, if logged in with the Dada Mail Root Password.profile_fields
profile_fields
controls whether the user may edit their own Subscriber Profile Fields in their own Profile (once logged in). If disabled, a user's Subscriber Profile Fields can still be edited by a List Owner, if logged in with the Dada Mail Root Password.mailing_list_subscriptions
mailing_list_subscriptions
controls whether the, Your Mailing List Subscriptions section is visible to your user in their Profile (once logged in).protected_directories
protected_directories
controls whether The, Password Protect Directories section is visible to your user in their Profile (once logged in). If disabled, Protected Directories will still be available if any are set up, just not listed in the user's Profile.update_email_address
update_email_address
controls whether the, Update Your Profile Email Address section is visible to your user in their Profile (once logged in). If disabled, a user's Profile password can still be edited by a List Owner, if logged in with the Dada Mail Root Password.delete_profile
delete_profile
control whether the, Delete This Profile section is visible to your user in their Profile (once logged in).
gravatar_options
Gravatars can also be enabled for Dada Mail Profiles. More information:
cookie_params
This variable holds a few options to change the behavior of the session management cookie for Dada Mail Profiles.