Profile Fields

Profile Fields

Profile Fields are additional data that's associated with the email address of a Subscriber. These fields can generally hold anything you'd like, and can be used to search through a subscription list, to create dynamic email messages (mail merging), and to be utilized when you only want to send to just part of a mailing list (partial sending).

Profile Fields can be edited individually or enmass in the list control panel, or by the addressee themselves, when logged into their own Profile.

Profile Fields are Shared Between Mailing Lists.

One important general concept to understand is that Profile Field data is shared between mailing lists.

If you create a new field called, first_name all your mailing lists will have this field, and any data associated with an address will show up for any mailing list that this address is a member of.

Likewise, if you edit the Profile Field data, this new information will be reflected in all mailing lists.

Adding a New Profile Field

Log into the list control panel with the Dada Mail Root Password (very important) to any currently created mailing list. On the admin menu, under, Profiles, click, Profile Fields

This screen will allow you to add/remove Profile Fields. This screen will also let you set a fallback value. The fallback value is used in mail merging and is used as the value fo the field tag when no value is present. You may also set if the Profile Field is required or optional.

Remember that profile fields are shared: removing any Profile Fields will permanently delete all data in all mailing lists.

Mail Merging

Mail Merging in Dada Mail in mailing list messages using Profile Fields is done using template tags.

For example, say you have a field named, first_name. To use the value of the saved field in an email message, you'd write the field as a tag, like this:

    <!-- tmpl_var subscriber.first_name -->
    

Here's how you'd use it, when placing this tag in part of a message:

 Hello, <!-- tmpl_var subscriber.first_name -->
 
      It's really nice to talk to you!
      
  -- Me.

More Information:

For more information, see the docs on The Dada Mail Email Template Syntax: https://dadamailproject.com/d/features-email_template_syntax.pod.html

Partial List Sending

You can search you Subscribers and send a mass mailing to part of this mailing list. For example, if you have a field named, city, you can tell Dada Mail, "only send to people whose city value is set to, Denver.

This can be done in the, Send a Message and, Send a Webpage screens. Click the, Partial Mailing List Sending tab. This tab is located below where you author your mailing list message.

You'll be presented with a form that allows you to make simple queries and give you the option to preview who's going to receive the message. This form also allows you to search for subscribers between two subscription dates.

Unlike profile data, this information is tied to individual subscriptions to each mailing list.

Subscriptions

Dada Mail's mailing list subscription form allows visitors to your site to enter their email address, as well as Profile Fields.

All Profile Fields will be shown, except (by default), Profile Fields that are prefixed with an underscore ("_"). For example, the field,

 first_name

Will be shown! The field,

 _secret_field

Will not. Consult the Config.pm file for how to set the special prefix.

Profile Fields can be marked as, Required.

You may acquire the HTML code needed to embed the subscription form in a webpage in the usual location: Under Appearance , click on, Subscription Form HTML.

Importing Subscribers

You may mass-import Subscribers to your mailing lists in the list control panel, under: Membership - Add/Invite/Subscribe. Make sure you've enabled mass-import in Mailing List - Options, under:

Advanced Options - Subscriptions Check, Allow Subscriptions in the List Control Panel, Without Confirmation and optionally, Only Allow when logged in with the Pro Dada Root Password

Dada Mail accepts importing subscribers via a .csv file - something a spreadsheet app should be able to export for you, easily. The column order will be shown to you, at the top of this screen.

Editing Individual Address's Profile Data

You can edit an individual's address data in the list control. Under, Your Subscribers, click on, View.

You'll be presented with a table of your subscribers Clicking on the email address of the subscriber will bring you to a screen for this particular subscriber. Click the, Profile tab to view/edit Profile data.

See Also

Technical Documentation

Subscriber Backend

DADA::MailingList::Subscribers

https://dadamailproject.com/support/documentation-11_22_0/MailingList_Subscribers.pm.html

Profiles

Dada::Profile

https://dadamailproject.com/support/documentation-11_22_0/Profile.pm.html

DADA::Profile::Fields

https://dadamailproject.com/support/documentation-11_22_0/Profile_Fields.pm.html

DADA::Profile::Session

https://dadamailproject.com/support/documentation-11_22_0/Profile_Session.pm.html

DADA::ProfileFieldsManager

https://dadamailproject.com/support/documentation-11_22_0/ProfileFieldsManager.pm.html

Templating System

The HTML Screen and Email Template parts of Dada Mail all use the same system. See:

https://dadamailproject.com/support/documentation-11_22_0/Template_Widgets.pm.html#screen

And also:

https://dadamailproject.com/support/documentation-11_22_0/App_FormatMessages.pm.html#email_template


Dada Mail Project

Download

Installation

Support