Profile Fields
- 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 left hand 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: http://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 and Templates , 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 Your 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
http://dadamailproject.com/support/documentation-8_4_0/MailingList_Subscribers.pm.html
Profiles
Dada::Profile
http://dadamailproject.com/support/documentation-8_4_0/Profile.pm.html
DADA::Profile::Fields
http://dadamailproject.com/support/documentation-8_4_0/Profile_Fields.pm.html
DADA::Profile::Session
http://dadamailproject.com/support/documentation-8_4_0/Profile_Session.pm.html
DADA::ProfileFieldsManager
http://dadamailproject.com/support/documentation-8_4_0/ProfileFieldsManager.pm.html
Templating System
The HTML Screen and Email Template parts of Dada Mail all use the same system. See:
http://dadamailproject.com/support/documentation-8_4_0/Template_Widgets.pm.html#screen
And also:
http://dadamailproject.com/support/documentation-8_4_0/App_FormatMessages.pm.html#email_template