Opt In Email 5.1 User Guide Cpyright 2006-13 Data Springs Inc. All rights reserved.
Table f cntents: 1 INTRODUCTION 1.1 What s new? Enhancements in 5.1 2 INSTALLATION PROCEDURE 3 OPT IN EMAIL MODULE 3.1 Adding Opt In Email mdule t a page 3.2 Opt In Email Quick Menu 3.3 Using the Cntrl Panel 3.4 Viewing the dashbard 3.5 Managing the Subscribers 3.5.1 Viewing reprts by List 3.5.2 Adding a new subscriber 3.5.3 Editing a subscriber 3.5.4 Deleting a subscriber 3.5.5 Perfrming Glbal Actins 3.5.6 Exprting subscribers t Excel 3.6 Managing Opt In Lists 3.6.1 Creating a new Opt In List 3.6.2 Editing a Opt In List 3.6.3 Deleting a Opt In List 3.6.4 Creating a teaser 3.6.5 Activating a teaser 3.6.6 Deleting a teaser 3.7 Cnfiguring the mdule 3.7.1 Managing General Settings 3.7.2 Managing the Layut Settings 3.7.3 Managing Layut Text 3.7.3.1 Defining New subscriber website text 3.7.3.2 Defining New Subscriber Verificatin website text 3.7.3.3 Defining Verificatin email sent website text 3.7.3.4 Defining Existing Subscriber website text 3.7.3.5 Defining Existing subscriber update website text 3.7.3.6 Defining the Text in Case the Subscriber Opted Out Frm All Lists 3.7.3.7 Defining Existing subscriber verificatin website text 3.7.3.8 Defining Manage Subscriptin Cmplete website text 3.7.4 Managing System Emails 3.7.4.1 Defining New Email Verificatin Message email message 3.7.4.2 Defining Existing Email Verificatin Message email message 3.7.4.3 Defining Existing Subscriptin Updated Message email message 3.7.4.4 Existing Subscriber Opted Out Frm All Lists 3.7.4.5 Setting up Staff Ntified f New Subscriptin 3.7.5 Editing the Stylesheet 3.7.6 Managing Email Settings 3.8 Managing Extended Fields 3.8.1 Creating a new extended field 3.8.2 Editing an extended field 3.8.3 Deleting an extended field 3.9 Imprting Opt In List 3.10 Deleting Opt In Email 4 SIMPLE OPT IN MODULE 4.1 Adding Simple Opt In mdule t the page 4.2 Simple Opt In mdule main menu 4.3 Managing Simple Opt In Mdule Settings 4.4 General Simple Opt In Mdule Settings 4.5 Managing Simple Opt In mdule layut settings
4.5.1 Managing Text Layut 4.5.2 Setting up header inside the Opt In Email page 4.5.3 Setting up New Subscriber Verificatin 4.5.4 Setting up fter inside the Simple Opt In page 4.6 Managing the Simple Opt In Style Sheet 4.7 Managing System Emails 4.7.1 Setting up New Email Verificatin Message 4.7.2 Setting up Staff Ntified f New Subscriptin 4.8 Managing Email Settings 4.9 Deleting Simple Opt In mdule 5 PREVIOUS NEWSLETTERS 5.1 Adding Previus Newsletters t the page 5.2 Managing settings fr the Previus Newsletters mdule 6 ADVANCED EMAIL MODULE 6.1 Adding Advanced Email Mdule t the page 6.2 Using the Advanced Email Cntrl Panel 6.3 Viewing the Dashbard 6.4 Cnfiguring the Mdule 6.4.1 Managing General Distributin Settings 6.4.2 Managing the Alternate Cnfiguratin 6.4.3 Amazn Simple Email Service (SES) 6.4.4 Managing Newsletter Schedule Settings 6.5 Creating a new email/newsletter 6.6 Viewing the Lg Results 6.6.1 Running the Newsletter Distributin Scheduler 6.7 Viewing the Quick Stats Reprt 6.7.1 Viewing the Newsletter Statistics 6.7.2 Viewing the Read/Unread cunts Reprt 6.7.3 Viewing Read Cunts per Hur f Day Reprt 6.7.4 Viewing Read Cunts per Day f Week Reprt 6.7.5 Viewing Read Cunt per Day f Mnth Reprt 6.7.6 Viewing Success/Failure Reprt 6.7.7 Viewing Bunceback Reasns Reprt 6.8 Publishing and un-publishing the newsletter 6.9 Managing the Tracking infrmatin 6.9.1 Newsletter Tracking 6.9.2 Abut the tracking 6.9.3 Link Tracking 6.9.4 Creating a new link tracking definitin 6.9.5 Editing a link tracking definitin 6.9.6 Deleting a link tracking definitin 6.10 Using the Email Campaigns 6.10.1 Managing Email Campaigns 6.10.2 Creating a new email campaign 6.10.3 Editing an existing campaign 6.10.4 Deleting an email campaign 6.10.5 Managing the Schedule 6.11 Managing the Reprts 6.11.1 Viewing a Newsletter Reprt 6.11.2 Viewing Quick Stats 6.11.3 Viewing Email Subject/Message 6.11.4 Viewing the Distributin Reprt 6.11.5 Viewing the Link Tracking Reprt 6.11.6 Viewing Email Campaign Reprts 6.11.7 Managing Buncebacks Settings
6.12 Managing the dynamic templates 6.12.1 Enabling the Templates 6.12.1.1 Managing the template cnfiguratin 6.12.2 Setting up the Dynamic Templates 6.12.2.1 Setting the dynamic template parameters 6.12.2.2 Managing the Email subject and message 6.12.3 Managing Dynamic Template Fields 6.12.3.1 Example f using the Dynamic Templates 6.13 Deleting Advanced Newsletter Mdule 7 CONTENT LOCALIZATION 7.1 Lcalizing the Opt in List name and descriptin 7.2 Displaying the lcalized lists 7.3 Lcalizing the Layut Settings 7.4 Lcalizing the system emails
1 INTRODUCTION The Opt In Email mdule allws administratrs t create 'Opt In' distributin list(s). Users f the system can easily select which distributin list(s) they wuld like t Opt In/Out f. Maintenance and reprts are available fr administratrs, and an enhanced versin f 'Newsletters' is included s yu can easily distribute t yur Opt In lists. Setup as many Opt In Lists as yu wuld like Settings fr each Opt In mdule can select display all f the Opt In Lists, r a selected few (Nice if yu like t have different areas f yur site(s) t have different pt in categries/lists) Settings t als ptinally cllect the users First/Last name besides their email address Settings t ptinally verify the users email address after Opting In. Allw existing users t manage their Opt In settings. After they enter their email address, it will send them a link t the system Manage Users/Lists alng with ability t easily administratr and maintain users and their pt in preferences Each area f the site and each email distributed thrugh the system are custmizable within the system. Additinally yu can include parameters within the emails send t users -i.e. Dear $(FirstName),... Reprts fr Opt In List(s) including ability t exprt Opt In Lists/Users t Excel Settings fr email subject lines, email messages, and mail SMTP settings New expanded features in V2.1 including extended fields, previus newsletters, simple pt in email mdules, and mre custmizatin! New expanded in v2.6 include the ability t scheduler newsletters. Nw yu can schedule newsletters t send ut X number f emails per X timeframe. Fr example, send ut 400 emails per hur and run every hur until cmpletin. New features in 3.0 include: Email Tracking Nw track the success f yur newsletter. Distributin reprts shw the number emails that g ut t users and which f thse users have actually read the newsletter! Email tracking includes tracking hw many times they have read the newsletter, their IP Address, and their brwser type. New feature t hide help icns within main Opt In Email mdule New feature t aut lad authenticated users Opt In Email subscriptin
1.1 What s new? Enhancements in 5.1 Ability t create Template Sets" fr newsletters. Template Sets allw yu t setup a dynamic set f variables t cllect frm the end user (which is an admin / user sending the newsletter) that wuld then be "Plugged Int" the newsletter. Fr example, instead f the user nw having full "HTML" access t the newsletter, the admin can define maybe 5 text bx areas, tw headlines, and tw images. Then When the user starts t fill in the data fr the newsletter, the system can replace thse specific areas f text with the FULL WYSIWYG template. New "TABS" interface t quickly navigate within sending a newsletter thrugh a wizard experience. As features are enabled/disabled the tab wuld n lnger appear (such as if yu did nt ffer things such as a text-nly newsletter etc.) Ability t test the pt in email verificatin emails with a new "Send Email Test" within the main Opt In Email mdule cnfiguratin cntrl panel Minr Enhancements / Fixes: First / Last Name can nw be visible but ptinal when cllecting the subscribers infrmatin Optinal watermark features fr first name, last name, and email address within main Opt In Email and Simple Opt In Email mdule Ability t send BCC nw t the entire distributin list
2 INSTALLATION PROCEDURE The Opt In Email mdule cnsists f 4 separate mdules. Yu shuld fllw these instructins t install all mdules befre yu start using them. The mdule installatin prcess has been streamlined t nly include ne single mdule installatin file: Included in yur dwnlad are tw mdule zip files plus the surce zip file (if yu have purchased the surce) DataSprings_OptInEmai50_DNN6PLUS_PAINSTALL.zip installatin file fr installing Opt In Email mdule. Nte: Fr versins f DNN 6.x plus, yu shuld navigate t Hst, Extensins, and Install Mdule Extensin. Figure 1: Installatin prcedure (step 1/5) The fllwing screen will be displayed. Figure 2: Installatin prcedure (step 2/5) Click n the Install New Mdule t cntinue installing Opt In Email and the fllwing screen will be displayed. Figure 3: Installatin prcedure (step 3/5) Click n the Brwse buttn and the dialg windw fr lcating the installatin file DataSprings_OptInEmail.zip will be displayed. Lcate the DataSprings_OptInEmail.zip and click n the Open buttn. The fllwing screen will be displayed.
Figure 4: Installatin prcedure (step 4/5) Click Next and the installatin will begin. In a cuple f mments the screen infrming yu n successful cmpletin will be displayed. Yu must agree t the license agreement and fllw the wizard. Figure 5: Installatin prcedure (step 5/5) Nte: please keep track f any errrs that appear during the installatin. These errrs can be helpful if yur mdule has prblems.
3 OPT IN EMAIL MODULE This sectin will give detailed instructins fr all ptins available fr Opt In Email mdule. 3.1 Adding Opt In Email mdule t a page In rder t add Opt In Email mdule t a desired page fllw these steps: 1. Select the Add New Mdule radi buttn 2. Chse Opt In Email frm the Mdule pull dwn menu 3. Click n the Add link (r the arrw icn ). Figure 6: Adding a mdule t a page (step 1/3)
Figure 7: Adding a mdule t a page (step 2/3) The Opt In Email mdule will be added t the page. Click n the arrw next t the title f the mdule in rder t pen the main menu. Figure 8: Opening the mdule main menu
Nte: see sectin 3.2 fr further infrmatin n main menu ptins. 3.2 Opt In Email Quick Menu In rder t start using the quick menu t access the mst imprtant settings fr the mdule, click n ne f the available icns. Figure 9: Opening the quick menu The fllwing ptins are available: - click this icn t access the dashbard, i.e. the cntrl panel (see sectin 3.3) - the ptin fr managing subscribers (see sectin 3.5) - the ptin fr managing the pt in email lists (see sectin 3.6) - the ptin fr cnfiguring the mdule settings (see sectin 3.7) - the ptin fr setting up the extended fields (see sectin 3.8) - the ptin fr imprting the subscribers frm an existing list (see sectin 3.9)
3.3 Using the Cntrl Panel In rder t start using the Opt In Email Cntrl Panel, click n this icn in the quick menu. Figure 10: Chsing the "Cntrl Panel" ptin The fllwing screen will be displayed. Figure 11: Optins inside the cntrl panel The fllwing ptins are available: Dashbard the ptin fr viewing mdule versin, recent subscribers, statistics, etc (see sectin 3.4) Manage Subscribers the ptin fr managing yur subscribers (see sectin 3.5) Opt In Lists the ptin fr managing the pt in lists/ categries (see sectin 3.6 Mdule Cnfiguratin the ptin fr cnfiguring the mdule (see sectin 3.7)
Extended Fields the ptin fr managing the extended fields (see sectin 3.8) List Imprt the ptin fr imprting the list (see sectin 3.9) Exit use this ptin t exit the Cntrl Panel
3.4 Viewing the dashbard The purpse f the dashbard is t prvide the administratr with a central resurce t display the mdule versin, recent subscribers and statistics n the pt in lists, and specific warnings that are determined based n the mdule cnfiguratin and setup. It is displayed by default when yu chse the Cntrl Panel ptin frm the main menu. Figure 12: Viewing the dashbard The fllwing ptins are available:
Versin this will display the current mdule build versin including any incremental versins; the versin is useful when cntacting supprt r t determine if an upgrade is available Inf/Stats statistics will appear within the dashbard fr each pt-in list setup; the statistics will display each pt in list setup within the system and als the number f subscribers within that list Recent Subscribers the mst recent subscribers will be displayed within this area f the dashbard; the infrmatin will include the subscriber infrmatin and the date/time they subscribed Warnings warnings will be displayed based upn any specific cnfiguratin cncerns r recmmendatins fr yur mdule instance Exit Cntrl Panel exit ut f the cntrl panel 3.5 Managing the Subscribers In rder t start managing the subscribers, chse ptin Manage Subscribers frm the main menu. Figure 13: Chsing ptin "Manage Subscribers" The fllwing screen will be displayed.
Figure 14: Managing subscribers The fllwing infrmatin and ptins are available inside this screen: Manage Opt In List(s) /Users this screen is displayed by default and cntains all users Reprts by List chse this ptin t display users by the categry (see sectin 3.5.1) Display names chse this ptin t display names f the subscribers Display extended fields chse this ptin t display extended fields (see sectin 3.8) Search users/emails use this ptin t search fr the users based n name r email address Search term - enter the search term that yu wuld like t query against the pt in email list database fr Page size use this pull dwn menu t specify the size f the page based n the number f users displayed per page First name field displaying user s first name Last name - field displaying user s last name Email address - field displaying user s email address Verified field displaying infrmatin abut whether the user has been verified r nt Subscriptin Date/Time field displaying infrmatin abut the categries users belng t Select / De-Select All - select an actin t perfrm t all selected subscribers frm the grid f subscribers; the actin will be executed against all selected subscribers (see sectin 3.5.5) Glbal actins select the desired subscriber and then chse the desired actin frm this menu Exprt t Excel ptin fr exprting user list t an excel file (see sectin 3.5.6)
3.5.1 Viewing reprts by List In rder t view user by list they belng t, chse Reprts by List radi buttn. The screen with the pull dwn menu fr chsing the desired Opt In List will be displayed. Figure 15: Viewing reprts by Opt In List Chse the desired Opt In List frm the pull dwn menu and click n the Search link. The screen with the users belnging t the chsen Opt In List will be displayed. 3.5.2 Adding a new subscriber In rder t add a new subscriber, chse ptin Manage Subscribers frm the main menu. The fllwing page will be displayed. Figure 16: Adding a new subscriber
Use the input fields at the bttm t enter the fllwing infrmatin abut the new subscriber: First name enter the subscriber s first name in this field Last name enter the subscriber s last name in this field Email address enter the subscriber s email address in this field Multiple select list chse the list yu wish t add the subscriber t (nte: yu can select mre than ne list by clicking the CTRL key fr each item r shift fr multiple items) After entering these parameters inside the input fields, chse the actin f adding the subscriber t the list frm the Glbal Actins menu. 3.5.3 Editing a subscriber In rder t edit a subscriber, chse ptin Manage Subscribers frm the main menu. The screen with the list f current subscribers will be displayed. Figure 17: Editing a subscriber (step 1/2) The fllwing page will be displayed.
Figure 18: Editing a subscriber (step 2/2) The fllwing parameters can be edited inside this screen: Email Frmat Preference select the desired email frmat fr this subscriber (HTML r text) First name field fr editing subscriber s first name Last name - field fr editing subscriber s last name Email - field fr editing subscriber s email address Subscriptin Date the date the user has subscriber t the list Select Opt In List checkbxes fr adding r remving a subscriber frm the desired list (see sectin 3.5.2 r 3.5.4) Verified use this pull dwn menu t verify the user) Nte: nly verified email address s will be distributed an email in the Advanced Newsletter Mdule use the Resend Verificatin Email t send the verificatin email t the subscriber nce again, this will be the exact same email as when they riginally pted int the system Extended fields the part f the page listing all defined previusly defined extended fields (see sectin 3.8) After editing the desired parameters, click Save buttn in rder t save the changes.
3.5.4 Deleting a subscriber In rder t delete a subscriber, chse ptin Manage Lists/Users frm the main menu. The screen with the list f current subscribers will be displayed. Figure 19: Deleting a subscriber (step 1/2) Click n the delete buttn will be displayed. next t the desired subscriber and the fllwing cnfirmatin dialg Figure 20: Deleting a subscriber (step 2/2) Click OK and the subscriber will be deleted. 3.5.5 Perfrming Glbal Actins The Glbal Actins menu is used fr perfrming actins t all selected subscribers, i.e. multiple subscribers at nce. It is used in cmbinatin with the Select All ptin.
Figure 21: Perfrming glbal actins In rder t perfrm a glbal actin, click Select All and then chse the desired actin frm the menu, e.g. Add (Opt In) subscriber t Opt In List: Sales Prmtins, which will autmatically add all selected subscribers t the list called Sales Prmtins. The fllwing actins are available: Set Subscriber t Verified use this ptin t verify multiple subscribers at nce Add (Opt In) use this ptin t add multiple subscribers t a list Remve (Opt Out) use this ptin t remve multiple subscribers frm a list Delete Subscriber - use this ptin t delete multiple subscribers frm a list 3.5.6 Exprting subscribers t Excel In rder t exprt subscribers t an Excel file, chse ptin Manage Lists/Users frm the main menu. The screen with the list f current subscribers will be displayed. Scrll dwn t the bttm f the page and lcate the Exprt t Excel link. Figure 22: Exprting t Excel (step 1/2) Click the Exprt t Excel link and the dialg windw fr saving the file with exprted infrmatin will be displayed.
Figure 23: Exprting t Excel (step 2/2) Chse the desired lcatin n yur PC and click Save t save the file. Nte: the file name f the exprted file but is based n date/time.
3.6 Managing Opt In Lists In rder t start managing Opt In Lists, chse ptin Opt In Lists / Categries frm the main menu. Figure 24: Chsing ptin Opt In Lists / Categries The fllwing screen will be displayed. Figure 25: Managing categries The fllwing ptins are available inside this screen: - the ptin fr deleting a Opt In List (see sectin 3.6.1) - the ptin fr editing a Opt In List (see sectin 3.6.2) - t add a new list, fill in the desired fields and click the save icn (see sectin 3.6.3) - the ptin fr adding a teaser (see sectin 3.6.4)
3.6.1 Creating a new Opt In List In rder t create a new Opt In List, enter the Opt In List name, descriptin and the desired srt rder inside the respective fields and click n this icn. Figure 26: Creating a new Opt In List After yu click n the add icn ( Nte: ), the new Opt In List will be added. The Distributin Security Rle parameter can be used in rder t limit access t the newsletter based n the user rle. In ther wrds yu can set the security rle fr users that are allwed t distribute newsletters. This parameter can be setup during the prcedure f editing a Opt In List (see sectin 3.6.2) A newly added list will nt autmatically be shwn in the lists displayed t subscribers. T display this list, yu will need t g t Mdule Cnfiguratin, General Settings where yu check the Opt In Lists Displayed. (see 3.7.1). 3.6.2 Editing a Opt In List In rder t edit a Opt In List, click n this icn next t the Opt In List name. Figure 27: Editing an Opt In
After clicking edit the fields fr changing the desired parameters will be displayed. Inside this screen yu can change any f the parameters fr the Opt In List: List Name use this field t set a different name fr the Opt In List Descriptin use this field t set a different Opt In List descriptin Srt Order input field fr setting the desired srt rder Default select this checkbx t make the list a default ne (nte: this checkbx is autmatically checked when a subscriber is initially subscribing) Distributin Security Rle pull dwn menu fr chsing the desired distributin security rle; i.e. chsing the rle which will be allwed t distribute the specific newsletters After changing the desired parameters, click n the Update link in rder t save the changes. 3.6.3 Deleting a Opt In List In rder t delete Opt In List, click n the delete icn next t the name f the desired Opt In List. Figure 28: Deleting an Opt In List (step 1/2) The fllwing cnfirmatin dialg will be displayed. Figure 29: Deleting an Opt In List (step 2/2) Click OK and the Opt In List will be deleted.
3.6.4 Creating a teaser Opt-In Email Teasers allw fr extended functinality when distributing newsletters r email campaigns. Teasers (als referred t as issues, peridicals, r cntent snippets) can allw yu t easily create cntent within newsletters and email campaigns by using the $(Teaser) tken within the email cntent. Teasers themselves can als use the tken $(TeaserDetails) t generate a hyperlink fr the user t click n which will display the full detailed teaser. Tips: Yu can have as many teasers per pt in list, hwever nly a single teaser can be set t active. Only the active teaser will be shwcased within the email when utilizing this feature. If the user belnged t multiple pt in lists, and these additinal pt in lists als had teasers, then the distributin system wuld generate a line break and separate the tw teasers. In rder t create a new teaser, click the teaser icn Email Lists. next t the desired list within the Opt In Figure 30: Creating a teaser (step 1/3) The fllwing page will be displayed.
Figure 31: Creating a teaser (step 2/3) The fllwing ptins and parameters are available inside the first part f the page: Select Teaser select Create New Teaser (Blank) t create a new teaser Nte: nce yu create a teaser r several teasers, yu will be able t edit them by selecting the desired teaser frm this menu; yu can als use this menu t cpy the existing teaser and thus use it as a template fr creating a new ne Teaser Name enter the name f the teaser which will help yu differentiate this teaser frm all ther teasers; in ther wrds this name is nt visible t the subscribers Teaser Title enter the title f the teaser Nte: the teaser title will nly appear t the users if they click the 'Teaser Detail' link which will lead them t the title and bdy text f the teaser Teaser Date - select the date fr this teaser; the teaser date will nly appear if the user clicks the 'Teaser Detail' link Draft Mde - select this checkbx t make the teaser a draft i.e. nt visible t the subscribers until yu finish it Teaser (HTML Subscribers) enter the HTML versin f the teaser text that will appear if yu use the teaser tken within a newsletter r email campaign; teasers can include the tken $(TeaserDetails) r $(TeaserDetails_Full) which will represent the hyperlink fr the full teaser bdy
Figure 32: Creating a teaser (step 3/3) The fllwing parameters are available in the secnd part f the page: Teaser (Text Subscribers) enter the text versin f the teaser Teaser Bdy - enter the full teaser bdy fr this teaser; the teaser bdy will appear within the main Opt In Email mdule in case the subscriber clicks the detailed link within a teaser After setting the desired parameters, click "Save t cmplete the prcedure f creating a new teaser. 3.6.5 Activating a teaser Since nly ne teaser can be active per list, yu can use the pull dwn menu t select the teaser yu wish t be active fr a list. Figure 33: Activating a teaser Select the desired teaser frm the menu and click Save t save the changes. This teaser will frm that pint n be active fr that list.
Nte: yu can always select a different active teaser. 3.6.6 Deleting a teaser In rder t delete a teaser, select the desired teaser frm the Select Teaser menu. Figure 34: Deleting a teaser (step 1/2) The page with the selected teaser will be displayed. Figure 35: Deleting a teaser (step 2/2) Click Delete and the teaser will be deleted.
3.7 Cnfiguring the mdule In rder t use mre advanced ptins fr cnfiguring the mdule, chse Mdule Cnfiguratin frm the main menu. Figure 36: Chsing ptin "Mdule Cnfiguratin" The fllwing page will be displayed. Figure 37: Optins fr cnfiguring the mdule The fllwing ptins are available: General Settings see sectin 3.7.1 Layut Settings see sectin 3.7.2 Style Sheet see sectin 3.7.3 Email Settings see sectin 3.7.6
3.7.1 Managing General Settings In rder t start managing general Opt In Email mdule settings, chse Mdule Cnfiguratin frm the main menu and click the General Settings label. Figure 38: Managing general Opt In Email mdule settings (step 1/2) The fllwing parameters are available inside this screen: Opt In Lists Displayed (at least ne required) fields displaying available newsletter lists; select the list in rder t enable it (see sectin 3.6) Nte: use the language menu t specify the list yu wish t display fr varius languages, i.e. language versins f the site Extended Fields select this checkbx in rder t enable extended fields (see sectin 3.8) Request First/Last Name use this ptin in rder t enable first name and last name fields inside the subscriptin frm Enable preferred email frmat - select t allw the subscribers t chse their preferred email frmat (text r html) Aut Verify Users Email check this checkbx if yu want t skip the step f verifying subscriber s email; therwise users will need t click n the Verify Email link that is sent t them upn initial registratin. Initially Hide Lists Fr New Subscriptins - select this ptin and the pt in lists will initially be hidden when the user chses t subscribe Hide Opt-In Management Feature - select this ptin if yu wuld like t hide and disable the feature fr a subscriber t manage their subscriptin Always send verificatin email select this checkbx if yu want t use the verificatin email functinality
Ntify staff f new subscriptins select this ptin if yu wish t enable ntificatins t staff members abut new subscriptin signup Figure 39: Managing general Opt In Email mdule settings (step 2/2) Ntificatin Email Address enter the email address ntificatins shuld be sent t Hide Help Icns select this checkbx in case yu wish t hide the help icns that are by default displayed next t each field label Email Settings - expand the email settings t setup a frm email and frm email name within the mdule. This frm email will be used when emails are distributed based n the wrk flw settings fr initial and updated subscriptins Display a check all lists ptin within pt in / pt ut subscriptin prcess select if yu wuld like the system t display a checkbx abve r belw the pt in lists. This checkbx wuld allw the use t either select r deselect all f the pt in lists. Autmatically lad authenticated users pt in subscriptin select this ptin in case yu wish t autmatically lad authenticated users pt in email subscriptin. There will autmatically put the mdule in update mde when the user has signed int DtNetNuke prtal Disable in-line editr select this checkbx if yu wuld like t disable the in-line editing ability fr the administratrs. The in-inline editing feature is the ability t change the layut f the pt in list by clicking n the pencil icns directly n the user-facing page Remve subscriber frm system if Opted Out frm all lists select this ptin t autmatically remve the subscriber if he has pted ut f all lists Validate subscriber is new - select this ptin t validate that the subscriber is a new subscriptin; the feature shuld be enabled if yu nly have a single mdule instance
thrughut yur prtal, r a single pt in list; the feature shuld be disabled if yu want the user t be allwed t subscribe t multiple pt in lists n multiple pages f yur prtal Disable Ajax - select this ptin t disable AJAX within the user-facing prtins f this mdule Disable Ajax fr Cntrl Panel - select this ptin t disable AJAX within the cntrl panel and mdule cnfiguratin prtins f this mdule Label Suffix enter the desired label suffix in case yu wish t display ne Display labels/textbx n separate lines chse this ptin in rder t display label fr the input field (First name) and input field in tw different lines Frce SSL within generated hyperlinks select this ptin if yu wuld like t frce hyperlinks generated within the mdule fr verificatin and subscriptin management t be HTTPS instead f HTTP nte: the list f accepted SMS carriers can be edited in Hst, Lists
Nte: Starting in Opt In Email 5.1, the SMS Texting feature has the ptinal feature t send the data t the Data Springs Opt In Text service. Yu can find ut mre infrmatin and get setup with Opt-In Text at www.datasprings.cm/optintext In rder t start managing Opt In Email mdule layut settings, click n the + symbl next t the Layut Settings label. 3.7.2 Managing the Layut Settings In rder t start managing the layut settings, click the Layut Settings label. Figure 40: Managing Opt In Email mdule layut settings (1/2) The fllwing parameters are available inside the first part f the screen: Manage Layut Text select this radi buttn and chse the desired ptin frm the pull dwn menu in rder t define messages that will be displayed t the users n the website thrughut the prcedure f subscriptin and managing subscriptin (see sectin 3.7.3) Manage System Emails select this radi buttn and chse the desired ptin frm the pull dwn menu in rder t define email messages that will be sent t the user thrughut the prcedure f subscriptin and managing subscriptin (see sectin 3.7.4) Basic Text Bx chse this ptin in rder t define website messages and email messages in TXT frmat Rich Text Editr - chse this ptin in rder t define website messages and email messages in HTML frmat and with advanced frmatting features (WYSIWYG editr)
Figure 41: Managing Opt In Email mdule layut settings (2/2) The secnd part f the screen allws yu t setup the desired text and layut (whether it will be an image buttn r a text link) fr the fllwing actins: Subscriptin Link Buttn Type chse if yu wish t display text r image buttn fr the Subscribe ptin Update Subscriptin Image Buttn chse if yu wish t display text r image buttn fr the Subscribe ptin Manage Subscriptin Link Buttn Type chse if yu wish t display text r image buttn fr the Subscribe ptin Manage text specify the text fr the subscriptin link buttn Email Subject (New Subscribers) use this field t specify the email subject fr the new subscribers Email Subject (Existing Subscribers) use this field t specify the email subject fr the new subscribers After setting the desired parameters, click n the Update Message buttn in rder t save the changes. 3.7.3 Managing Layut Text In rder t start setting up layut f the email messages sent t the subscriber thrughut the prcedure f subscriptin and managing subscriptin as well as header and fter inside the page, chse the desired ptin frm the pull dwn menu. Figure 42: Managing layut f the email messages The fllwing email messages are available inside the pull dwn menu: Header ptin fr defining header fr the Opt In Email mdule as seen by the end users n the website (see sectin 4.5.2) New Subscriber instructins fr the new subscriber displayed inside the page (see sectin 3.7.3.1) New Subscriber Verificatin message displayed inside the web page after the user submits his email address (see sectin 3.7.3.2) Verificatin Email Sent ptin fr defining text displayed n the website after the user fllws the verificatin link inside the email sent after submitting email address (see sectin 3.7.3.3)
Existing Subscriber ptin is used fr defining text displayed n the website and instructing the user t enter his email address and click n the G link in rder t start managing his subscriptin (see sectin 3.7.3.4) Existing Subscriber Update - ptin used fr defining text displayed inside the page n the website that the user visits after fllwing the link fr managing subscriptin (see sectin 3.7.3.5) Existing Subscriber Opted Out Frm All Lists - ptin used fr defining text displayed inside the page n the website that the user pts ut f all lists (see sectin 3.7.3.6) Existing Subscriber Verificatin ptin is used fr defining text displayed n the website immediately after the user enters his email address and clicks n the G buttn (see sectin 3.7.3.7) Manage Subscriptin Cmplete ptin is used fr defining text displayed n the website immediately after the user updates the subscriptin infrmatin (see sectin 3.7.3.8) Fter ptin fr defining fter fr the Opt In Email mdule as seen by the end users n the website (see sectin 4.5.4) 3.7.3.1 Defining New subscriber website text The New Subscriber ptin is used fr defining text displayed inside the website which cntains instructins fr the new subscribers, such as Check the bxes f the newsletter and hit the Subscribe me buttn. In rder t define the cntents f this message, select Manage Layut Text radi buttn and chse ptin New Subscriber frm the pull dwn menu. Figure 43: Defining "New Subscriber" message
Define the desired text inside this field and click n the Update Message link in rder t save the changes. 3.7.3.2 Defining New Subscriber Verificatin website text The New Subscriber Verificatin ptin is used fr defining text displayed n the website immediately after the user submits his email address and clicks n the Subscribe me buttn. This is a message infrming the user that he will receive an email message cntaining verificatin link he must fllw in rder t cmplete the subscriptin prcedure. In rder t define the cntents f this message, select Manage Layut Text radi buttn and chse ptin New Subscriber Verificatin ptin frm the pull dwn menu. Figure 44: Defining "New Subscriber Verificatin" message Define the desired text inside this field and click n the Update Message link in rder t save the changes. The fllwing screensht demnstrates the lcatin f this text inside the website. 3.7.3.3 Defining Verificatin email sent website text The Verificatin email sent ptin is used fr defining text displayed n the website after the user fllws the verificatin link inside the email sent after submitting email address. This is a message infrming the user that the email address verificatin has been cmpleted successfully. In rder t define the cntents f this message, select Manage Layut Text radi buttn and chse ptin Verificatin Email Sent ptin frm the pull dwn menu.
Figure 45: Defining "Verificatin Email Sent" message Define the desired text inside this field and click n the Update Message link in rder t save the changes. The fllwing screensht demnstrates the lcatin f this text inside the website. 3.7.3.4 Defining Existing Subscriber website text The Existing Subscriber ptin is used fr defining text displayed n the website and instructing the user t enter his email address and click n the G link in rder t start managing his subscriptin. Opt in Email mdule will send the email message cntaining link the user shuld fllw in rder t pen a page n the website where he will be able t manage their subscriptin infrmatin. In rder t define the cntents f this message, select Manage Layut Text radi buttn and chse ptin Existing Subscriber ptin frm the pull dwn menu. Figure 46: Defining "Existing Subscriber" message
Define the desired text inside this field and click n the Update Message link in rder t save the changes. The fllwing screensht demnstrates the lcatin f this text inside the website. 3.7.3.5 Defining Existing subscriber update website text The Existing Subscriber ptin is used fr defining text displayed inside the page n the website that the user visits after fllwing the link fr managing subscriptin. This Manage link is sent t the user in an email message after he enters his email address and clicks n the G buttn (nte: see sectin 3.7.4.2 fr further instructins n defining this email message). In rder t define the cntents f this message, select Manage Layut Text radi buttn and chse ptin Existing Subscriber Update ptin frm the pull dwn menu. Figure 47: Defining "Existing subscriber update" message Define the desired text inside this field and click n the Update Message link in rder t save the changes. The fllwing screensht demnstrates the lcatin f this text inside the website. 3.7.3.6 Defining the Text in Case the Subscriber Opted Out Frm All Lists The Existing Subscriber Opted ut frm All Lists ptin is used fr defining text displayed t the users after they chse t pt ut f all lists. In rder t define the cntents f this message, select Manage Layut Text radi buttn and chse ptin Existing Subscriber Opted ut frm All Lists ptin frm the pull dwn menu.
Figure 48: Defining the Text in Case the Subscriber Opted Out Frm All Lists
3.7.3.7 Defining Existing subscriber verificatin website text The Existing Subscriber Verificatin ptin is used fr defining text displayed n the website immediately after the user enters his email address and clicks n the G buttn. This text infrms the user that he will receive an email message cntaining link that he is suppsed t fllw in rder t visit the page n the website where he will be able t manage his subscriptin infrmatin (nte: see sectin 3.7.4.2 fr further infrmatin n hw t define this email message) In rder t define the cntents f this message, select Manage Layut Text radi buttn and chse ptin Existing Subscriber Verificatin ptin frm the pull dwn menu. Figure 49: Defining "Existing Subscriber Verificatin" message Define the desired text inside this field and click n the Update Message link in rder t save the changes. Nte: yu can use the variables in rder t persnalize this message by using parameters user supplied during the subscriptin prcess. The fllwing is the list f parameters which can be used: $(FirstName) enter this parameter in the email in rder t address the user by his first name (e.g. Dear $(FirstName) wuld be Dear Jhn ) $(LastName) - enter this parameter in the email in rder t address the user by his last name (e.g. Dear Mr. $(LastName) wuld be Dear Mr. Smith ) $(EmailAddress) - enter this parameter in rder t display user s email address inside the email message (e.g. $(EmailAddress) wuld be jhnsmith@address.cm ) $(DateTime) enter this parameter in rder t display date and time $(Subscriptin) enter this email in rder t display the newsletter categries this user is already subscribed t (see sectin 0 fr further infrmatin) The fllwing screensht demnstrates the lcatin f this text inside the website. Define the desired text inside this field and click n the Update Message link in rder t save the changes. The fllwing screensht demnstrates the lcatin f this text inside the website.
3.7.3.8 Defining Manage Subscriptin Cmplete website text The Manage Subscriptin Cmplete ptin is used fr defining text displayed n the website immediately after the user updates the subscriptin infrmatin. This text infrms the user that the updates t his subscriptin have been saved successfully. In rder t define the cntents f this message, select Manage Layut Text radi buttn and chse ptin Manage Subscriptin Cmplete ptin frm the pull dwn menu. Figure 50: Defining "Manage Subscriptin Cmplete" message 3.7.4 Managing System Emails System emails are sent t the user during the curse f subscriptin prcedure as well as when the user verifies his email address and manages his subscriptin settings. In rder t start managing system emails fr Opt In Email mdule, select ptin Manage System Emails and chse the desired email frm the pull dwn menu.
Figure 51: Setting up system emails The fllwing system emails are available inside the pull dwn menu: New Email Verificatin Message email sent t the user after he supplies his email address n the website and clicks n the Subscribe link; this email cntains verificatin link user is suppsed t fllw in rder t verify his email address and cmplete the subscriptin (see sectin 3.7.4.1 Existing Email Verificatin Message email sent t the already subscribed after he supplies his verified email in rder t receive a link fr managing his subscriptin; this email cntains a link which the user has t fllw in rder t visit the page n the website where he can manage his subscriptin infrmatin (e.g. mdify newsletter categries) see sectin 3.7.4.2 Existing Subscriptin Updated Message email sent t the user as a cnfirmatin that his subscriptin infrmatin has been updated successfully (e.g. that the user successfully mdified newsletter categries he is subscribed t); this email sent after the user fllws the link fr managing subscriptin infrmatin and saves the changes (see sectin 3.7.4.3) Existing Subscriber Opted Out Frm All Lists email sent t the user as a cnfirmatin that he has successfully unsubscribed frm all lists (see sectin 3.7.4.4) Staff Ntified f New Subscriptin email sent t the staff ntifying them abut the new subscriptin (see sectin 3.7.4.5) The secnd part f the screen allws yu t setup the desired text and layut (whether it will be an image buttn r a text link) fr the fllwing actins: Subscribe chse if yu wish t display text r image buttn fr the Subscribe ptin (see Figure 52) Update Subscriptin chse if yu wish t display text r image buttn fr the Subscribe ptin (see Figure 53) Manage Subscriptin chse if yu wish t display text r image buttn fr the Subscribe ptin (see Figure 54) Figure 52: Example f the "Subscribe me" buttn
Figure 53: Example f the "Update Subscriptin" buttn Figure 54: Example f the "G" buttn 3.7.4.1 Defining New Email Verificatin Message email message The New Email Verificatin Message is an email sent t the user after he supplies his email address n the website and clicks n the Subscribe link. This email cntains verificatin link that the user is suppsed t fllw in rder t verify his email address and cmplete the subscriptin. In rder t start mdifying this email message, select Manage System Emails and chse ptin New Email Verificatin Message frm the pull dwn menu.
Figure 55: New Email Verificatin Message Yu can mdify the cntents f this email by using the rich text editr. After changing the cntents f this email, click n the Update Message buttn in rder t save the changes. 3.7.4.2 Defining Existing Email Verificatin Message email message The Existing Email Verificatin Message email is sent t the already subscribed after he supplies his verified email n the website. This email cntains a link which the user has t fllw in rder t visit the page n the website where he can manage his subscriptin infrmatin (e.g. mdify newsletter categries). In rder t start mdifying this email message, select Manage System Emails and chse ptin Existing Email Verificatin Message frm the pull dwn menu.
Figure 56: Existing Email Verificatin Message Yu can mdify the cntents f this email by using the rich text editr. After changing the cntents f this email, click n the Update Message buttn in rder t save the changes. Nte: yu can use the variables in rder t persnalize these messages by using parameters user supplied during the subscriptin prcess. The fllwing is the list f parameters which can be used: $(FirstName) enter this parameter in the email in rder t address the user by his first name (e.g. Dear $(FirstName) wuld be Dear Jhn ) $(LastName) - enter this parameter in the email in rder t address the user by his last name (e.g. Dear Mr. $(LastName) wuld be Dear Mr. Smith ) $(EmailAddress) - enter this parameter in rder t display user s email address inside the email message (e.g. $(EmailAddress) wuld be jhnsmith@address.cm ) $(DateTime) enter this parameter in rder t display date and time $(Subscriptin) enter this email in rder t display the newsletter categries this user is already subscribed t (see sectin 0 fr further infrmatin) $(ManageURL) this parameter is a link the user will fllw in rder t return t the page n the website where he will be able t mdify his subscriptin infrmatin (e.g. change the newsletter categries he is subscribed t)
3.7.4.3 Defining Existing Subscriptin Updated Message email message The Existing Subscriptin Updated Message email is sent t the user as a cnfirmatin that his subscriptin infrmatin has been updated successfully (e.g. that the user successfully mdified newsletter categries he is subscribed t). This email is sent after the user fllws the link fr managing subscriptin infrmatin, mdifies his subscriptin and saves the changes (sectin 3.7.4.3). In rder t start mdifying this email message, select Manage System Emails and chse ptin Existing Subscriptin Updated Message frm the pull dwn menu. Figure 57: Existing Subscriptin Updated Message Yu can mdify the cntents f this email by using the rich text editr. After changing the cntents f this email, click n the Update Message buttn in rder t save the changes. Nte: yu can use the variables in rder t persnalize these messages by using parameters user supplied during the subscriptin prcess. The fllwing is the list f parameters which can be used: $(FirstName) enter this parameter in the email in rder t address the user by his first name (e.g. Dear $(FirstName) wuld be Dear Jhn ) $(LastName) - enter this parameter in the email in rder t address the user by his last name (e.g. Dear Mr. $(LastName) wuld be Dear Mr. Smith ) $(EmailAddress) - enter this parameter in rder t display user s email address inside the email message (e.g. $(EmailAddress) wuld be jhnsmith@address.cm ) $(DateTime) enter this parameter in rder t display date and time $(Subscriptin) enter this email in rder t display the newsletter categries this user is already subscribed t (see sectin 0 fr further infrmatin)
3.7.4.4 Existing Subscriber Opted Out Frm All Lists The Existing Subscriber Opted ut frm All Lists email is sent t the user as a cnfirmatin that he has successfully unsubscribed frm all lists. This email is sent after the user fllws the link fr managing subscriptin infrmatin, mdifies his subscriptin and saves the changes (sectin 3.7.4.3). In rder t start mdifying this email message, select Manage System Emails and chse ptin Existing Subscriber Opted ut frm All Lists frm the pull dwn menu. Figure 58: Existing Subscriber Opted Out Frm All Lists Define the cntents f the verificatin email inside this screen and click n the Update Message t save the changes.
3.7.4.5 Setting up Staff Ntified f New Subscriptin In rder t start setting up Staff Ntified f New Subscriptin, which is a message sent t the staff ntifying them abut the new subscriptin, select ptin Manage System Emails and chse Staff Ntified f New Subscriptin frm the pull dwn menu. Figure 59: Setting new email verificatin message Define the cntents f the verificatin email inside this screen and click n the Update Message t save the changes. Nte: yu can use the variables in rder t persnalize this message by using parameters user supplied during the subscriptin prcess. The fllwing is the list f parameters which can be used: $(FirstName) enter this parameter in the email in rder t address the user by his first name (e.g. Dear $(FirstName) wuld be Dear Jhn ) $(LastName) - enter this parameter in the email in rder t address the user by his last name (e.g. Dear Mr. $(LastName) wuld be Dear Mr. Smith ) $(EmailAddress) - enter this parameter in rder t display user s email address inside the email message (e.g. $(EmailAddress) wuld be jhnsmith@address.cm ) $(DateTime) enter this parameter in rder t display date and time $(Subscriptin) enter this email in rder t display the newsletter categries this user is already subscribed t
3.7.5 Editing the Stylesheet The Opt In mdule allws yu t mdify the cntents f the CSS file thus affecting the layut f mdule. In rder t start editing the style sheet, click n the + symbl next t the Style Sheet label. Figure 60: Editing the Stylesheet 3.7.6 Managing Email Settings In rder t start managing the email settings, click n the + symbl next t the Email Settings label. Figure 61: Managing Email Settings The fllwing ptins are available: Frm Email Name - enter the name which will be displayed in the Frm field fr the recipients. If n name is entered the email address will appear in the Frm field Frm Email Address - enter the Frm email address fr the Opt In Email System After setting the desired parameters, click n the "Update Cnfiguratin link t save the changes.
3.8 Managing Extended Fields The purpse f extended fields is t ffer the pssibility f including additinal questins during subscriptin. Fr example: let s say yu als want t cllect the user s zip cde? Or maybe yu wuld like t ask the user if they are a Jb Seeker r a Jb Emplyer? When yu exprt the list yu can filter (in excel) based n these additinal extended questin. One primary feature is yu can cllect as much infrmatin frm the user during the pt in prcess as the yu wuld like because yu can add as many r as few extended fields. In rder t start managing extended fields, chse ptin Manage Extended Fields frm the main menu. Figure 62: Chsing ptin "Manage Extended Fields" The fllwing screen will be displayed. Figure 63: Managing extended fields The fllwing ptins are available inside this screen: New Extended Field ptin fr creating a new extended field (see sectin 3.8.1) Existing Extended Field (e.g. Zip Cde) chse this ptin t edit (see sectin 3.8.2) r delete an existing extended field (see sectin 3.8.3)
3.8.1 Creating a new extended field In rder t create a new extended field, chse ptin New Extended Field frm the pull dwn menu. Figure 64: Creating a new extended field (1/2) The fllwing screen will be displayed. Figure 65: Creating a new extended field (step 2/2) The fllwing are the parameters inside this screen: Questin input field fr entering the questin, i.e. the infrmatin requested frm the user (e.g. Cmpany r Zip Cde ) Shrt Name - enter a shrt name fr this field; shrt names are used fr email and SQL parameters Help Text - enter the text which will be displayed nce the user clicks the help icn fr this questin Srt Order set the desired srt rder fr this questin (the higher the number the further dwn the list the field will be displayed)
Questin type select the desired type f questin by chsing ne f the fllwing elements: TextBx Singleline textbx (Lng) Singleline textbx (Shrt) Multiline Textbx Checkbx Cmb Bx Radi Buttns (Optins) After setting the desired parameters, click n the Update Questin and the new extended field will be created. 3.8.2 Editing an extended field In rder t edit the desired extended field, chse the desired field frm the pull dwn menu. Figure 66: Editing an extended field (step 1/2) The screen with the parameters set fr this field will be displayed.
Figure 67: Editing an extended field (step 2/2) Change the desired parameters and click n the Update Questin link in rder t save the changes.
3.8.3 Deleting an extended field In rder t delete the desired extended field, chse the desired field frm the pull dwn menu. The fllwing page will be displayed. Figure 68: Deleting an extended field Click n the Delete Questin and the chsen field will be deleted.
3.9 Imprting Opt In List The Opt In Email mdule ffers the pssibility f imprting the list f subscribers s it wuld be easier fr yu t setup users in case yu already have a list f email addresses. In rder t star imprting the list, chse ptin Opt In List Imprt frm the main menu. Figure 69: Imprting Opt In List (step 1/2) The fllwing screen will be displayed.
Figure 70: Imprting Opt In List (step 2/2) The fllwing parameters are available inside this screen: Opt In List(s) this is a list f all defined newsletter categries which yu have previusly created (see sectin 3.6.1); select the categries yu wish t imprt users t Imprt Optin chse the desired imprt ptin CSV File select this radi buttn in case the list yu are imprting is in CSV frmat (Excel file). Nte: Yu can nw imprt extended fields frm within a CSV file. The imprt file shuld include the extended clumns and will be based n the extended fields srt rder (S if the fields were zip cde with a srt rder f 5 and city with a srt rder f 10, yu shuld include the zip cde befre the city in the imprt file). Example Frmat: Firstname, lastname, email, zipcde, city User Rle(s) select this radi buttn in case yu wuld like t imprt users directly frm DtNetNuke Users based n their rle; yu can run this imprt prcess as many times as yu wuld like, the system will nly add new unique users t the system.
SQL Query select this radi buttn in case yu wuld like t imprt users frm a SQL query. Make sure yu are imprting at least the EmailAddress clumn within yur SQL query, yu can ptinally imprt FirstName and a LastName clumn. Clumns names must be spelled exactly as FirstName, LastName, and EmailAddress. Nte: Yu can nw imprt extended fields frm within yur SQL Query. The query shuld include clumns which represent the shrt field name f the extended field List Imprt this feature will allw yu t add subscribers frm ne list int anther Example: Let s say yu have a new pt in list called My Ttal List. Yu culd imprt all f the subscribers frm Anther List A and/r Anther List B t be part f this pt in list Brwse click n the brwse buttn t lcate the imprt file n yur PC Ignre First Line In File If yur CSV imprt file includes headers/clumn names fr the first line then checking this bx will ignre the first line f the file. After setting the desired parameters, click n the Imprt in rder t imprt the list f users. 3.10 Deleting Opt In Email In rder t delete Opt In Email part, chse ptin Delete frm the main menu. Figure 71: Deleting a viewer part f the mdule (step 1/2) The cnfirmatin dialg will be displayed. Figure 72: Deleting a viewer part f the mdule (step 2/2) Click n the OK buttn and the mdule will be deleted.
4 SIMPLE OPT IN MODULE Simple Opt In Mdule a simple versin f the Opt In Email mdule. Yu can use this mdule if yu d nt want the users t be frced int checking their pt in categries, r if yu want a simple versin n sme ther lcatin n the site frm the main versin. The Simple Opt In Mdule will nt display the lists the user can chse, and the user cannt manage their subscriptin etc. It is als required that yu setup within the cnfiguratin the lcatin f the main Opt In Email mdule, this is necessary fr functinality such as the ability fr the user t verify their email address etc. 4.1 Adding Simple Opt In mdule t the page In rder t add Simple Opt In mdule t the page, click Add Existing Mdule frm the Mdules menu in the main navigatin. Chse Opt In Simple Op in frm the list f mdules and drag it t the desired lcatin in the page. Figure 73:Adding Simple Opt In mdule t the page Once yu release it in the desired lcatin, the Simple Opt In mdule will be added t the page.
Figure 74: Adding Simple Opt In Mdule t the page Click n the arrw next t the name f the mdule t pen the main menu (see sectin 4.2). 4.2 Simple Opt In mdule main menu In rder t access Simple Opt In mdule main menu, click n the arrw next t the name f the mdule. Figure 75: Simple Opt In mdule main menu Print ptin fr printing this page Settings ptin fr managing mdule settings (see sectin 4.3) Delete ptin fr deleting the simple Opt In mdule Mve ptin fr changing the lcatin f the simple Opt In mdule
4.3 Managing Simple Opt In Mdule Settings In rder t start managing Simple Opt In mdule settings, chse ptin Settings frm the main menu. Figure 76: Managing Simple Opt In mdule settings The fllwing ptins are available inside this screen: Basic Settings ptin fr setting up the title f the mdule Opt In Email Mdule Settings click n the + symbl next t this label t access further ptins
Figure 77: Managing Opt In Email Mdule Settings The fllwing ptins are available: General Settings see sectin 4.4 Layut Settings see sectin 4.5 Style Sheet see sectin 4.6 Email Settings see sectin 4.8
4.4 General Simple Opt In Mdule Settings In rder t start setting the general Simple Opt In settings, click n the + symbl next t this label. Figure 78: Managing general Simple Opt In mdule settings The fllwing parameters are available inside this screen: Opt In Categries select the categries yu wish t enable and add the new subscribers t Standard Opt In Page (Nt Simple) the standard pt in email mdule IS needed /Required if yu plan t nt Aut Verify users. The simple mdule is nt setup t have a verificatin link. Fr this reasn yu must include the page where the standard pt in email mdule is lcated frm this pull dwn menu; when the user submits their infrmatin t the pt in simple mdule the verificatin link will pint them t the standard pt in email mdule Ntify staff f new subscriptins select this ptin if yu wish t enable ntificatins t staff members abut new subscriptin signup Ntificatin Email Address enter the email address ntificatins shuld be sent t Hide Help Icns select this checkbx in case yu wish t hide the help icns that are by default displayed next t each field label Autmatically hide mdule if authenticated is already select this ptin if yu wuld like the system t autmatically lad authenticated users pt in email subscriptin settings Labels Suffix - enter a suffix fr the field labels n the pt in page Labels/Fields n separate lines chse this ptin in rder t display label fr the input field (First name) and input field in tw different lines Request First/Last Name use this ptin in rder t enable first name and last name fields inside the subscriptin frm
Aut Verify Users Email check this checkbx if yu want t skip the step f verifying subscriber s email; therwise users will need t click n the Verify Email link that is sent t them upn initial registratin. 4.5 Managing Simple Opt In mdule layut settings In rder t start setting the Simple Opt In layut settings, click n the + symbl next t this label. Figure 79: Managing "Simple Opt In Mdule" layut settings The fllwing parameters are available inside this screen: Manage Layut Text see sectin 4.5.1 Manage System Emails see sectin 4.7 Basic Text Bx use this ptin if yu want t define emails in TXT frmat Rich Text Editr use this ptin if yu want t use the advanced frmatting features and send an email in HTML frmat (nte: by using WYSIWYG editr) Design/HTML use these buttns t tggle between design and HTML mdes Use Subscribe Link Buttn select this ptin if yu wish t use text fr the Subscribe ptin; if yu chse this ptin, enter the desired text inside the Subscribe Text field Subscribe Image Buttn select this ptin if yu want t use an image/buttn fr the Subscribe ptin; yu can select the file which already resides n the server r chse t uplad a new file
4.5.1 Managing Text Layut In rder t start managing text layut (e.g. fter and header displayed t the user inside the website), select ptin Manage Layut Text. Figure 80: Managing Layut Text The fllwing ptins are available inside this screen: Header ptin fr setting up the cntents f the header as seen by the end users n the page (see sectin 4.5.2) New Subscriber Verificatin ptin fr setting up cntents f the email a new subscriber will receive as a cnfirmatin that he has began subscriptin prcess successfully (see sectin 4.5.3) Verificatin Email Sent - the Verificatin email sent ptin is used fr defining text displayed n the website after the user fllws the verificatin link inside the email sent after submitting email address (see sectin 3.7.3.3) Fter - ptin fr setting up the cntents f the fter as seen by the end users n the page (see sectin 4.5.4)
4.5.2 Setting up header inside the Opt In Email page In rder t setup header as seen by the end users in the page, chse ptin Manage Layut Text and then chse ptin Header frm the pull dwn menu. Figure 81: Setting up header as seen by the end users Use the advanced rich text editr ptins (WYSIWYG editr) t define the header as seen by the end users n the website and click n the Update Message link in rder t save the changes. Nte: put yur muse pinter ver each f the ptins t see its functin. Figure 82: Example f the defined header
4.5.3 Setting up New Subscriber Verificatin In rder t setup cntents f the email a new subscriber will receive as a cnfirmatin that he has began subscriptin prcess successfully (but prir t receiving verificatin email see sectin 4.7.1), select ptin Manage Layut Text and then chse ptin New Subscriber Verificatin frm the pull dwn menu. Figure 83: Setting up new subscriber verificatin email Use the advanced rich text editr ptins (WYSIWYG editr) t define the cntents f the email and click n the Update Message link in rder t save the changes. Nte: put yur muse pinter ver each f the ptins t see its functin.
4.5.4 Setting up fter inside the Simple Opt In page In rder t setup fter as seen by the end users in the page, chse ptin Manage Layut Text and then chse ptin Fter frm the pull dwn menu. Figure 84: Setting up fter inside the "Simple Opt In" page Use the advanced rich text editr ptins (WYSIWYG editr) t define the fter as seen by the end users n the website and click n the Update Message link in rder t save the changes. Nte: put yur muse pinter ver each f the ptins t see its functin Figure 85: Example fr chsing frmatting ptin "bld"
Figure 86: Example f the defined fter 4.6 Managing the Simple Opt In Style Sheet The Simple Opt In mdule allws yu t mdify the cntents f the CSS file thus affecting the layut f mdule. In rder t start editing the style sheet, click n the + symbl next t the Style Sheet label. Figure 87: Editing the Stylesheet Change the desired parameters within the text area and click n the Update link in rder t save the changes.
4.7 Managing System Emails The system email messages available fr Simple Opt In mdule are: New Email Verificatin Message see sectin 4.7.1 Staff Ntified f New Subscriptin see sectin 4.7.2 Figure 88: Available Simple Opt in System Emails
4.7.1 Setting up New Email Verificatin Message In rder t start setting up New Email Verificatin Message, which is a message sent t the subscriber requesting verificatin prir t cmpleting subscriptin, select ptin Manage System Emails. The fllwing screen will be displayed. Figure 89: Setting new email verificatin message Define the cntents f the verificatin email inside this screen and click n the Update Message t save the changes. Nte: yu can use the variables in rder t persnalize this message by using parameters user supplied during the subscriptin prcess. The fllwing is the list f parameters which can be used: $(FirstName) enter this parameter in the email in rder t address the user by his first name (e.g. Dear $(FirstName) wuld be Dear Jhn ) $(LastName) - enter this parameter in the email in rder t address the user by his last name (e.g. Dear Mr. $(LastName) wuld be Dear Mr. Smith ) $(EmailAddress) - enter this parameter in rder t display user s email address inside the email message (e.g. $(EmailAddress) wuld be jhnsmith@address.cm ) $(DateTime) enter this parameter in rder t display date and time
$(Subscriptin) enter this email in rder t display the newsletter categries this user is already subscribed t 4.7.2 Setting up Staff Ntified f New Subscriptin In rder t start setting up Staff Ntified f New Subscriptin, which is a message sent t the staff ntifying them abut the new subscriptin, select ptin Manage System Emails and chse Staff Ntified f New Subscriptin frm the pull dwn menu. Figure 90: Setting new email verificatin message Define the cntents f the ntificatin email inside this screen and click n the Update Message t save the changes. Nte: yu can use the variables in rder t persnalize this message by using parameters user supplied during the subscriptin prcess. The fllwing is the list f parameters which can be used: $(FirstName) enter this parameter in the email in rder t address the user by his first name (e.g. Dear $(FirstName) wuld be Dear Jhn ) $(LastName) - enter this parameter in the email in rder t address the user by his last name (e.g. Dear Mr. $(LastName) wuld be Dear Mr. Smith ) $(EmailAddress) - enter this parameter in rder t display user s email address inside the email message (e.g. $(EmailAddress) wuld be jhnsmith@address.cm ) $(DateTime) enter this parameter in rder t display date and time $(Subscriptin) enter this email in rder t display the newsletter categries this user is already subscribed t
4.8 Managing Email Settings In rder t start setting the Simple Opt In email settings, click n the + symbl next t this label. Figure 91: Managing "Simple Opt In" email settings The fllwing parameters are available inside this screen: Frm Email Name - enter the frm name fr the emails ging ut. If n name is entered the email address will appear as the frm email Frm Email Address enter yur email address Email Subject (New Subscribers) enter the subject f the email fr new subscribers
4.9 Deleting Simple Opt In mdule In rder t delete Simple Opt In mdule, chse ptin Delete frm the main menu. Figure 92: Deleting Simple Opt In mdule (step 1/2) The cnfirmatin dialg will be displayed. Figure 93: Deleting Simple Opt In mdule (step 2/2) Click n the Yes buttn and the mdule will be deleted.
5 PREVIOUS NEWSLETTERS 5.1 Adding Previus Newsletters t the page In rder t add Previus Newsletters mdule t the page, chse ptin Add New Mdule frm the Mdules menu. Figure 94: Adding previus newsletter t the page (step 1/2) The list f mdules will be displayed. Figure 95: Adding previus newsletter t the page (step 2/2) Drag and drp the Opt In Previus Newsletters mdule t the desired lcatin in the page belw. The Previus Newsletters mdule will be added t the page.
5.2 Managing settings fr the Previus Newsletters mdule In rder t start managing settings fr the Previus Newsletters mdule, chse ptin Settings frm the main menu. Figure 96: Managing previus newsletter settings (step 1/2) The fllwing screen will be displayed. Figure 97: Managing previus newsletter settings (step 2/2) The tab fr managing the previus newsletters settings is displayed by default. The fllwing parameters are available inside this screen: Display Type - select the display type fr this mdule instance; the display type can either display multiple previus newsletters r a single previus newsletter Ttal Display Cunt - enter the number f previus newsletters yu wish t display t the users (e.g. 5 ) and click n the Update link in rder t save the changes Opt In Categries chse the desired categries yu wish t display previus newsletters frm
6 ADVANCED EMAIL MODULE The Advanced Email mdule cntains advanced features fr sending newsletter t yur subscribers. Within the 4.0 release the Advanced Newsletter mdule als includes functinality fr link tracking, newsletter tracking, bunceback prtectin, email campaigns (a series f emails), and detailed distributin reprts. 6.1 Adding Advanced Email Mdule t the page In rder t add Advanced Email Mdule mdule t the page, chse ptin Add New Mdule frm the Mdules menu. Figure 98: Adding Advanced Email Mdule t the page Drag and drp the Advanced Email mdule t the desired lcatin in the page belw. Figure 99: Available ptins fr Advanced Email mdule The fllwing ptins are available within the page: Create New Email
Cntrl Panel see sectin View Lg Results the ptin fr viewing the lg results (see sectin 6.6) Opt In Advanced Email Main Menu Settings ptins fr managing the usual mdule settings Delete ptin fr deleting this mdule (see sectin 3.10) Mve use this ptin t mve the mdule t a different sectin f the page Cntrl Panel ptin fr accessing the Advanced Email Cntrl Panel with all majr mdule settings (see sectin 6.2) Create New Email the ptin fr creating a new email (see sectin 6.5) Filter use this pull dwn menu t determine if yu wish t display nly the sent emails r drafts List f newsletters with the fllwing ptins - the ptin fr editing a draft f the newsletter - the ptin fr viewing the newsletter reprt (see sectin 6.7) - the ptin fr viewing the cntents f the newsletter - the ptin fr creating a cpy f the newsletter - the ptin fr un-publishing a newsletter frm newsletter archive (see sectin 6.8) - the ptin fr un-publishing a newsletter t the newsletter archive (see sectin 6.8) - the ptin fr deleting a newsletter
6.2 Using the Advanced Email Cntrl Panel In rder t start using the Advanced Email Cntrl Panel, chse that ptin frm the main menu. Figure 100: Chsing ptin "Cntrl Panel" The fllwing page will be displayed. Figure 101: Using the Advanced Email Cntrl Panel The fllwing ptins are available: Dashbard - see sectin 6.12 Mdule Cnfiguratin - see sectin 6.12 Buncebacks see sectin 6.11.7 Tracking - see sectin 6.9 Email Campaigns - see sectin 6.10 Reprts - see sectin 6.10.1 Dynamic Templates see sectin 6.12 List Cleanup - see sectin 6.12 Exit ptin fr clsing the Cntrl Panel
6.3 Viewing the Dashbard The dashbard cntains plenty f useful infrmatin abut the Advanced Email mdule. It is displayed by default when yu chse the Cntrl Panel ptin frm the main menu. Figure 102: Viewing the dashbard The fllwing infrmatin is available: Versin infrmatin abut the versin f the Opt In Email Advanced Newsletter mdule Infrmatin/Statistics the field displaying useful infrmatin and statistics such as the last newsletter r email campaign distributed Warnings field fr displaying system warnings
6.4 Cnfiguring the Mdule In rder t start cnfiguring the mdule, chse ptin Mdule Cnfiguratin frm the Cntrl Panel. Figure 103: Chsing ptin "Mdule Cnfiguratin" The fllwing page will be displayed. Figure 104: Optins fr cnfiguring the Newsletter General Distributin Settings the ptin fr managing general newsletter distributin settings (see sectin 6.4.1) Alternate Cnfiguratin the ptin fr alternate mdule cnfiguratin (see sectin 6.4.2) Newsletter Schedule Settings the ptin fr managing the newsletter schedule settings (see sectin 6.4.4)
6.4.1 Managing General Distributin Settings In rder t start managing the general settings, click General Distributin Settings within the Mdule Cnfiguratin page. The fllwing page will be displayed. Figure 105: Managing General Distributin Settings The fllwing ptins and parameters are available: Autmatically include the Opt Out Message/Link select this checkbx if yu wish t include the pt ut link in every newsletter Opt Out Message use this text area t define the pt ut message which will g with the link and use $(OptOutURL) parameter t display the link Opt In Mdule Page select yur pt in mdule page frm this pull dwn menu Opt Out Link Text use this field t define the pt ut link text Exclude HTML Header Tags? - select if yu wuld nt like the email t include a header tag D nt replace images with full prtal alias - sme Rich Text Editrs replace site images within the newsletter t include the full prtal alias with image file, while thers just include /prtals/imagefile.jpg etc. If yu are having prblems with images nt shwing up within yur newsletter we suggest enabling this ptin
Inject Prtal Stylesheet int email header - select this checkbx if yu wuld like t have the prtal s stylesheet injected directly int the HTML header tag fr newsletters and email campaigns(nte: the styles frm within the stylesheet will be directly embedded within the newsletter) Email Header Tag - use this setting t define the header tag that is added t each newsletter distributin. The header tag is a feature that allws yu t specify within the HTML header f the message certain features. Fr example yu might want t include a link t a stylesheet here The default header tag is: <head><base href='http://www.yursite.cm></head> Nte: The default header tag is used t set the base reference fr the newsletter t yur prtals web site address. Often using a rich text editr when yu add an image t the editr it will remve the full path t the image. By setting the base href prperty within the header tag yur images shuld appear crrectly. Frce SSL Hyperlinks select this ptin t frce all hyperlinks t be HTTPS Disable AJAX fr Cntrl Panel - select this ptin t disable AJAX within the cntrl panel and mdule cnfiguratin prtins f this mdule Insert Tken Methd - select the methd fr inserting tkens within the newsletter; this feature can either be handled via JavaScript (client side) r AJAX (server side) - nte: sme Rich Text Editrs will nly supprt server side, but the client side is faster; this feature is used when clicking the insert link within the advanced newsletter mdule Client Side (FCK Editr) select this ptin t enable the client side editr Server Side (Other Rich Text Editrs) select this ptin t enable the server side editr Aut create Link Tracking bjects fr any URL's that are present within the newsletter? by enabling this ptin the mdule will autmatically check each newsletter fr hyperlinks and turn these int Link Tracking bjects if the links d nt already exist within the Link Tracking system. Each hyperlink will then be switched ut within the newsletter with the crrect link tracking bject fr distributin. Ntify email address when a newsletter is ready fr distributin? - by enabling this feature an email address will be ntified whenever a newsletter has been marked "Ready fr distributin" within the newsletter creatin area. Distributin ntificatin email address -yu can enter the email address that yu wuld like t have receive ntificatins when a newsletter has been marked as "Ready fr Distributin". This email will be ntified when the feature abve is enabled Security rle necessary fr sending newsletters - select the security rle that is necessary fr the user t be able t schedule and distribute newsletters. This is a separate security rle then users that are allwed t actually create newsletters.
6.4.2 Managing the Alternate Cnfiguratin In rder t start managing the alternate cnfiguratin, click Alternate Cnfiguratin within the Mdule Cnfiguratin page. The fllwing page will be displayed. Figure 106: Managing the Alternate Cnfiguratin The fllwing parameters are available: Alternate Prtal Alias - enter an alternate prtal alias fr distributins; the prtal alias is setup under the admin, site settings area; yu can utilize this setting t use an alternate prtal alias during distributin Alternate Encding - enter an alternate encding fr distributins; the encding is set t UTF8 by default; if yu wuld like t change this encding yu can enter an alternate encding here Alternate SMTP Server specify the alternate SMTP Server; If n SMTP server is specified, the system uses the SMTP cnfiguratin fr yur DNN installatin which is defined under hst, hst settings Alternate SMTP Authenticatin specify the alternate SMTP Authenticatin; If n SMTP authenticatin is specified, the system uses the SMTP cnfiguratin fr yur DNN installatin which is defined under hst, hst settings
Alternate SMTP Username specify the alternate SMTP Username; If n SMTP username is specified, the system uses the SMTP cnfiguratin fr yur DNN installatin which is defined under hst, hst settings Alternate SMTP Passwrd specify the alternate SMTP Passwrd; If n SMTP passwrd is specified, the system uses the SMTP cnfiguratin fr yur DNN installatin which is defined under hst, hst settings Alternate SMTP SSL enabled - select if the SMTP Settings shuld use SSL authenticatin. If n settings are definedngs. fr SSL the mdule will use the default DtNetNuke settins defined under hst, hst settings. 6.4.3 Amazn Simple Email Service (SES) The Amazn SES allws Opt In Email t send the email details and distributin directly ver t the Amazn servers t handle. This increases perfrmance and reliability (especially if yu are using an SMTP server with limitatins). Pricing is extremely affrdable and ffers additinal reprting techniques utside f Opt In Email. In rder t get started, sign up and get an accunt here: http://aws.amazn.cm/ses/ Once yu have an accunt, yu can get the tw tkens yu need t enter within the Amazn AWS Simple Email Service sectin http://dcs.aws.amazn.cm/ses/latest/develperguide/get-aws-keys.html Figure 107: Amazn Simple Email Service (SES) 6.4.4 Managing Newsletter Schedule Settings In rder t start managing the newsletter schedule settings, click Newsletter Schedule Settings within the Mdule Cnfiguratin page. The fllwing page will be displayed.
Figure 108: Setting up newsletter template The fllwing ptins and parameters are available: Maximum number f emails t send in a single schedule enter the maximum number f emails yu wish t send in a single schedule (e.g. 50). This feature will allw yu t distribute a smaller number f distributins per schedule instance. Fr example, if yur distributin list cntains 1000 emails/cntacts and yu wuld like t send nly 100 ut at a time until the entire distributin was delivered. Schedule Enabled select this checkbx in rder t enable scheduling Time Lapse enter the desired amunt f time which shuld pass befre the scheduler shuld run.fr example, shuld the schedule check fr distributin and distributin emails every hur, every day, every 30 minutes? If yu were t schedule the distributin t run every hur and the Maximum number f emails in a single distributin setting was set t 100 then it wuld send 100 the first hur, anther 100 the 2 nd hur, anther 100 the 3 rd hur etc. The full span f the distributin fr 1000 emails wuld be cmpleted after the 10 th hur. Nte: The recmmended settings fr this are t distribute 200 emails every 30 minutes. This setting reflects lgging, shared hsting, and typical implementatins, please review hw many emails are distributed within each schedule instance fr the best settings fr yur prtal. Retain Schedule Histry chse hw many schedules yu wish t keep track f. Example: Select "10" t keep the ten mst recent schedule histry rws Test Mde (Schedule Only) - select this ptin if the mdule shuld be cnfigured t wrk in test mde. Each distributin will be distributed t the email address specified as test email address Lg Categry use this ptin t specify if yu wuld like t lg each categry during the newsletter distributin
Lg email address use this ptin if yu wuld like t lg every distributed email Lg Bdy use this ptin if yu wuld like t lg the bdy f the email fr each distributed email Ignre checks against multiple scheduled instances - by selecting the ptin the system will ignre checking fr nging r ther failed Opt In Email scheduled instances. This can help if fr sme reasn the scheduler gt stuck n a previus distributin as the system wuld stp further distributins until this was crrected. CC Email address specify an email address if yu wish t CC every distributin message BCC Email address specify an email address if yu wish t BCC every distributin message After setting the desired parameters, click n the "Update Settings link in rder t save the changes. Nte: fr the scheduler t run prperly, it is critical that yu specify: Amunt f emails t send per distributin (recmmended 200-10000) Time Lapse (recmmended every 30 minutes fr small distributins and every hur fr large distributins).
6.5 Creating a new email/newsletter In rder t start creating a new email i.e. newsletter, click the Create New Email link inside the main page. Figure 109: Creating a new email/newsletter (step 1/6) The fllwing screen will be displayed. Figure 110: Creating a new email/newsletter (step 2/6) The first part f the page is used fr creating the email message. The fllwing parameters are available:
Start frm previus newsletter this ptin is used fr creating a new newsletter based n the cntents f a previus ne, i.e. srt f as a template Subject enter the subject fr the newsletter Insert mail Merge Tken (Insert) the mail merge tkens are used fr persnalizing yur message fr each f the recipients (fr example: chse the First Name tken t address each f the recipients by their first name); pen the pull dwn menu, chse the desired tken and click the Insert link t put it int the bdy f the message; the fllwing tkens are available: First Name use this tken t display the subscriber s First Name. Nte: this tken will be represented by $(FirstName) within the email message. First Name w/ Cmma use this tken t display the subscriber s First Name with a Cmma (e.g. Jhn, ). If the subscriber des nt have a first name, then n name r cmma will be replaced with the tken. With this methd yur newsletter wuldn t accidentally send a message with just a, fr example if the subscriber didn t have a first name. Nte: this tken will be represented by $(FirstWCmma) within the email message. Last Name use this tken t display the subscriber s Last Name Nte: this tken will be represented by $(LastName) within the email message. Full Name w/ Cmma - use this tken t display the subscriber s Full Name with a Cmma (e.g. Jhn Smith, ). If the subscriber des nt have a full name, then n name r cmma will be replaced with the tken. With this methd yur newsletter wuldn t accidentally send a message with just a, fr example if the subscriber didn t have a first name r last name. Nte: this tken will be represented by $(FullWCmma) within the email message. Email Address use this tken t display the subscriber s Email address (this will extract the email address the subscriber specified during the registratin) Nte: this tken will be represented by $(EmailAddress) within the email message. Subscriptin Infrmatin use this tken t display the pt in lists the user is currently subscribed t Nte: this tken will be represented by $(subscriptin) within the email message. Manage Subscriptin use this tken t display a link fr subscribers t manage their subscriptins within the system Nte: this tken will be represented by $(ManageOptIn) within the email message. Newsletter Web View Link - use this tken t utilize a hyperlink that the subscriber can click n which will render a web versin f the newsletter. The web versin is based n the nn-persnalized versin f the newsletter. Nte: this tken will be represented by $(WebDisplayLink) within the email message. Opt In Email ID (Database Key) - this tken can represent the subscribers Opt In Email ID key value within the Opt In Email system. This tken shuld nly be used fr advanced implementatin where yu might want t make use f this tken. Examples can include integratin with Dynamic Frms fr Surveys Opt Out Link - use this tken t display the Opt Out Link yur subscribers can use t unsubscribe Nte: this tken will be represented by $(OptOutURL) within the email message Opt Out Message w/ Link use this tken t display the Opt Out message and an Opt Out Link. The Opt Out Message is the message defined within the newsletter cnfiguratin f the My Newsletters cntrl panel Nte: this tken will be represented by $(OptOut) within the email message.
Opt Out Frm All Lists - use this tken t display the link yur subscribers can use t Opt Out all f the available lists. This tken is unique as the user will nt have t chse which pt in lists they want t unsubscribe frm. It will just autmatically pt them ut Nte: this tken will be represented by $(OptOutAll) within the email message. Opt Out Frm All Lists (Full URL Link) - his has the same purpse as the $(OptOutAll) but will render the full URL and nt the Opt Out Text in hyperlink Nte: this tken will be represented by $(OptOutAllFull) within the email message. Tracking Bug use this tken t put a tracking bug int a newsletter. This tken will reference whatever the default tken is defined as within the newsletter cnfiguratin f the My Newsletters cntrl panel. Fr example, if yu chse t have Image as yur tracking bug, then this tken wuld be the same as using the Tracking Bug (Image) tken which is listed belw. Nte: this tken will be represented by $(Tracking) within the email message. Tracking Bug (Image) - use this tken t put an image with a tracking bug in the message. Please nte that sme email prgrams, such as MS Outlk, d nt allw this. Nte: this tken will be represented by $(TrackingImage) within the email message. Tracking Bug (Stylesheet) - use this tken t put a tracking bug int the message as a stylesheet included int the message. Please nte, sme email prgrams d nt allw this such as Micrsft Outlk. Nte: this tken will be represented by $(TrackingCSS) within the email message. Extended Fields all extended fields setup within the pt in email system can be referenced here as $(Questin Name). S if yu created an extended questin called Zip Cde yu can reference the subscribers respnse t that questin here in the message as $(Zip Cde). Inject Mdule Cntent - use this tken t inject specific mdule cntent such as RSS Feeds, Annuncements mdules, r any mdule cntent. Injecting mdule cntent is easy but yu first need t find the mdule ID fr the cntent yu wish t inject. T find the MduleID yu can click n Settings and review the URL t find the mduleid. Fr example the URL might be /mid/5141 r /MduleID/5141. The mdule ID fr that mdule wuld be 5141. Nte: this tken will be represented by $(MduleCntent:MduleID) within the email message. Example: $(MduleCntent:5141) Nte: Starting in versin 5.1 and abve, this feature can be disabled within the settings. The feature can als be included t allw STATIC cntent r DYNAMIC cntent. If STATIS cntent is chsen and if that text is a TEXT/HTML mdule, then nly the TEXT/HTML will be injected. Figure 111: Injecting Mdule Cntent
Link Tracking Objects the fllwing ptins are available Link Tracking URL this will include the full http reference fr the link tracking bject. This is useful if yu want t reference the link tracking bject as a hyperlink fr an image r ther specific link in yur message. Link Tracking URL (Full Link) this will include a link which is already setup with a link tracking definitin name. If the link tracking definitin was Data Springs it wuld create a hyperlink with that specific text fr the user. This is useful if yu d nt want t create yur wn link in the message. Email Message and Email Message (Text Only) the text areas fr entering the cntents f the email message i.e. the bdy in HTML r text frmat Figure 112: Creating a new email/newsletter (step 3/6) Nn-Persnalized Message specify the cntents f the email in case that will be saved within the previus newsletters database, r als when viewing fr reprts, statistics. This message shuld represent the same cntent, hwever nt include any custmized r persnalized tkens Nte: Starting within versin 5.1 f Opt In Email, this nn-persnalized message can als be remved as a feature within the mdule cnfiguratin / cntrl panel.
Figure 113: Creating a new email/newsletter (step 4/6) The secnd part f the page is used fr defining the email status. The fllwing parameters are available: Save Draft select this ptin if yu wish t save this newsletter as a draft and send it at sme ther time Send Test Email select this ptin if yu wish t send a test email. The test email will be sent t the email address specified in Advanced Email, Mdule Cnfiguratin, Newsletter Schedule Settings. Only a single test email will be distributed and will be sent immediately (nt within the Opt In Email Scheduler) Send Immediately select this ptin if yu want t send the newsletter immediately; the email is sent as sn as yu click Finish in the bttm f the page Tip: sending immediately is nt recmmended fr large distributins due t lgging, web site time uts, and ability t thrttle email messages within a given number per instance. We highly recmmend utilizing the Scheduler fr ptin Schedule Immediately use this ptin t schedule the newsletter t be distributed immediately. This is the recmmended setting when yu want t distribute a newsletter right away and has better lgging, ability t thrttle distributin, and reprts cmpared t the Send Immediately methd. Schedule fr use this ptin in case yu wish t schedule sending f the newsletter fr a specific date and time Tips: we recmmend using the scheduler fr all large distributins and fr better lgging purpses the scheduler is the recmmended distributin methd and will be defaulted upn creatin f each newsletter
the recmmend schedule settings are fr 200 every 30 minutes (defined when enabling the scheduler under Cntrl Panel/Newsletter Cnfiguratin/Schedule sectin Scheduler Test Mde Tips: the schedule mde will either be displayed as Schedule fr r Schedule fr (test mde). If the newsletter cnfiguratin /schedule sectin test mde is enabled the setting will be reflected within this label. test mde fr the scheduler is a prtal specific setting fr the newsletter scheduler, this setting is nt per newsletter instance the test mde currently reflects the exact emails that wuld g ut if the system was nt in test mde, the nly difference is that the email t will be sent t the email address specified within the newsletter cnfiguratin / schedule sectin. If yu distribute a newsletter in scheduler test mde t an pt in list f 2000 subscribers, it will literally be distribute 2000 emails t the test email address. an alternative methd fr testing newsletters within test mde is t setup a Test Opt In List. This methd can allw yu t add nly a small subset f email addresses t the pt in list and distribute newsletters t this list. Yu can specify which Opt In Lists are displayed and utilized within the main Opt In Email mdule / Simple Opt In Email mdule, s standard subscribers will never see this test pt in list. Testing Is Imprtant: The purpse f test mde is nt just t make sure yur email system and scheduler is wrking prperly, test mde is als recmmended t test newsletter tracking, link tracking, images within yur newsletter, all standard email and extended questin email tkens, and verall success with yur SMTP and email prvider, site, and scheduler settings. The recmmend schedule settings are fr 200 every 30 minutes. Figure 114: Creating a new email/newsletter (step 5/6) The third part f the page is used fr specifying the recipients f yur newsletter. The fllwing parameters are available:
Opt in List(s) chse the pt in lists which will receive this newsletter (see sectin 3.6.1 fr further infrmatin n hw t create an pt in list) Additinal Emails enter any additinal single email addresses yu wish t send the newsletter t (nte: the addresses shuld be divided with a semi-cln such as address@address.cm;test@address.cm;test2@address.cm). Any additinal email addresses that are entered manually will be added t the selected pt in distributin lists that yu are distributing this newsletter t. Figure 115: Creating a new email/newsletter (step 6/6) The furth part f the page is used fr managing the advanced settings. The fllwing parameters are available: Save Cpy - selecting this ptin will save a cpy f this message(as a draft) after sending the newsletter t the recipients Publish t Site select this ptin t publish the newsletter t the public newsletter archive, if the newsletter has been published t the site it will be available fr display within the Opt In Previus Newsletter Archive (see sectin 5) Tip: after distributin f the newsletter yu can easily publish/un-publish yur newsletter t the newsletter archive within the data grid Newsletter page. (Reply-T-Address specify the reply-t address inside this field Frm Name enter the name the newsletter will appear frm n the main My Attachment use these ptins t add an attachment t yur newsletter; yu can either select a file which already resides n yur server r add a new file by using the Uplad New File ptin Pririty select the desired pririty level fr this message
Send Methd chse the desired send methd frm this pull dwn menu One message per email address (persnalized) select this ptin if yu have used the mail merge tkens t persnalize yur message t each f the recipients (i.e. address them by their first name, etc see Figure 110)) One email t blind distributin list select this ptin if yu wish t send the newsletter as ne email t blind distributin list i.e. in case yu haven t used the tkens, but specified the cntents within the Nn persnalized part f the page (see Figure 112) Send Actin select the desired methd fr sending this message After setting the desired parameters, click the Finish buttn. 6.6 Viewing the Lg Results In rder t view the lg results, chse that ptin frm the main menu. Figure 116: Viewing the lg results (step 1/2) The fllwing page will be displayed.
Figure 117: Viewing the lg results (step 2/2) The fllwing ptins and parameters are available: Scheduled Task - select the task that yu wuld like t view the lg results fr; the fllwing tasks are available: Newsletter Distributin select this ptin t view the lg result f the newsletter distributin task Email Campaign Distributin select this ptin t view the lg result f the email campaign distributin task Bunceback Prtectin select this ptin t view the lg result f the email bunceback prtectin task Run Newsletter Distributin Schedule Prcess Nw click this link t run the newsletter distributin schedule prcess immediately (see sectin 6.6.1) Refresh Histry click this link t refresh the page i.e. lg infrmatin Clear Lg click this link t delete all infrmatin within the page
6.6.1 Running the Newsletter Distributin Scheduler In rder t run the newsletter distributin schedule prcess, click that link within the page fr viewing the lg results. Nte: The distributin scheduler is based n the settings defined within the Advanced Newsletter Cntrl Panel. These settings define hw ften the scheduler will run and hw many newsletters shuld be distributed with each scheduler instance. Yu can als manually kick the scheduler ff by clicking the link highlighted belw. Figure 118: Running the Newsletter Distributin Scheduler (step 1/2) The fllwing page will be displayed. Figure 119: Running the Newsletter Distributin Scheduler (step 2/2) Once the scheduler has kicked ff yu can click Refresh Histry t see updated statistics and histry.
6.7 Viewing the Quick Stats Reprt In rder t view a quick stats reprt fr a newsletter, click the View reprt icn desired newsletter. next t the Figure 120: Viewing the Quick Stats Reprt The fllwing types f reprts are available: Newsletter Statistics see sectin 6.7.1 Read/Unread Cunts see sectin Read Cunts per Hur f Day see sectin 6.7.3 Read Cunts per Day f Week see sectin 6.7.4 Read Cunt per Day f Mnth see sectin 6.7.5 Success/Failure see sectin 6.7.6 Bunceback Reasns see sectin 6.7.7
6.7.1 Viewing the Newsletter Statistics In rder t view the newsletter statistics, chse Newsletter Statistics frm the menu. Figure 121: Viewing the Newsletter Statistics
6.7.2 Viewing the Read/Unread cunts Reprt In rder t view the read/unread cunt reprt, chse Read/Unread Cunts frm the menu. Figure 122: Viewing the Read/Unread cunts Reprt
6.7.3 Viewing Read Cunts per Hur f Day Reprt In rder t view the read cunts per hur f day reprt, chse Read Cunts per Hur f Day frm the menu. Figure 123: Viewing Read Cunts per Hur f Day Reprt 6.7.4 Viewing Read Cunts per Day f Week Reprt In rder t view the read cunts per day f the week reprt, chse Read Cunts per Day f Week Reprt frm the menu.
Figure 124: Viewing Read Cunts per Day f Week Reprt 6.7.5 Viewing Read Cunt per Day f Mnth Reprt In rder t view the read cunt per day f mnth reprt, chse Read Cunt per Day f Mnth Reprt frm the menu. Figure 125: Viewing Read Cunt per Day f Mnth Reprt
6.7.6 Viewing Success/Failure Reprt In rder t view the success/failure reprt, chse Success/Failure frm the menu. Figure 126: Viewing Success/Failure Reprt
6.7.7 Viewing Bunceback Reasns Reprt In rder t view the bunceback reasns reprt, chse Bunceback Reasns frm the menu. Figure 127: Viewing Bunceback Reasns Reprt
6.8 Publishing and un-publishing the newsletter This feature allws yu t publish r un-publish the particular newsletter frm the Previus Newsletters Archive. This archive is the separate Previus Newsletter mdule. Previus versins nly allwed yu t define this setting when creating a new newsletter, hwever nw yu can mdify this flag fr each newsletter directly within the interface. Figure 128: Publishing and un-publishing the newsletter Publish use this icn Un-publish - use this icn t un-publish the newsletter
6.9 Managing the Tracking infrmatin In rder t start managing the tracking infrmatin, chse ptin Tracking frm the Cntrl Panel. Figure 129: Chsing ptin "Tracking" frm the Cntrl Panel The fllwing page will be displayed. Figure 130: Distributin and link tracking The fllwing ptins are available: Newsletter Tracking the ptin fr tracking infrmatin abut the newsletters (see sectin 6.9.1) Link Tracking the ptin fr managing tracking infrmatin abut the links (see sectin 6.9.3)
6.9.1 Newsletter Tracking In rder t start setting the Newsletter tracking ptins, click the Newsletter Tracking tab after chsing Tracking in the Cntrl Panel (see Figure 130). Figure 131: Newsletter tracking The fllwing ptins and parameters are available: File lcatin chse the lcatin f the image File name chse the desired image after selecting the lcatin Uplad new file -the ptin fr uplading a new image After setting the desired parameters, click n the "Update link t save the changes. Nte: see sectin 6.9 fr details n viewing the tracking reprts. 6.9.2 Abut the tracking Tips: The tracking feature will either be included within the email as an image r a style sheet, the default implementatin is t use an image and fr that image t be yur lg r ther relative image Subscribers using ppular email applicatins will be frced t 'dwnlad images' befre the tracking can functin prperly, r request that subscribers add the frm distributin email t their safe senders list Tracking implementatin requires that the main Opt In Email mdule is placed n a page that is viewable t all users, this page must be specified within the newsletter cnfiguratin sectin Image is the preferred tracking methd as sme applicatins (such as Outlk 2007) d nt allw style sheets t be rendered frm a link
6.9.3 Link Tracking In rder t start setting the Newsletter tracking ptins, click the Link Tracking tab after chsing Tracking in the Cntrl Panel (see Figure 130). The link tracking is used fr tracking when subscribers click specific links within a newsletter r email campaign. This feature tracks the subscriber s infrmatin and date/time f the click, and then redirects the user t the specific web page. Start using the link tracking feature by clicking the + symbl next t the Link Tracking label. Figure 132: Using the link tracking feature Yu can have unlimited number f link tracking definitins, i.e. links yu wish t track. The Link Tracking Definitin menu can be used fr the fllwing: Creating a new tracking definitin see sectin 6.9.4 Editing an existing tracking definitin - see sectin 6.9.5 Deleting a tracking definitin - see sectin 6.9.6
6.9.4 Creating a new link tracking definitin In rder t start creating a new tracking definitin, chse ptin New Link Tracking Definitin frm the Link Tracking Definitin menu. Figure 133: Creating a new link tracking definitin The fllwing page will be displayed. The fllwing ptins and parameters are available: Tracking Link Name - enter the desired name fr the tracking definitin; this name is used nly as a reference and fr reprts
Hyperlink URL - enter the URL that the user shuld be redirected t fr this link (i.e. http://www.yursite.cm) Tracking Tken - enter the tken that shuld be used fr this tracking link definitin; this tracking tken is required and will be represented within newsletters r email campaigns as $(Tken); when used the tken will be replaced with a link that will prperly track the users click Distribute email if a link has been clicked use this ptin if yu wuld like the subscriber r anyne else t be emailed in case the subscriber clicks n the URL Email frm name - enter the frm name that yu wuld like t be displayed when distributing this email Email frm Email Address - enter the frm email address that yu wuld like t be displayed when distributing this email Email t (blank t send t subscriber) - enter the email address f the persn yu want t ntify abut the click. If n email address is specified, the message will be sent t the subscriber Mail BCC - enter the BCC recipient fr the email ntificatin Email Subject - enter the email subject fr the email ntificatin Display Message Parameters Email Message - enter the email message bdy fr the email ntificatin Email Frmat - select the email frmat fr this message; the frmat can either be in HTML r in plain text Attach file t email select this ptin if yu wish t attach a file t the email and use the ptins belw (File Attachment) t specify the desired file After setting the desired parameters, click n the "Update link t save the changes and cmplete the prcedure f creating a new link definitin. Tips: Yu can setup as few r as many link tracking definitins as yu wuld like, each link tracking bject can be used as many times thrughut newsletters and email campaigns by using $(TkenName) and $(TkenName_Full) within the email message. The standard link tracking tken will generate the full link necessary fr tracking, and the full tken will include the link already setup as a hyperlink with the link tracking name as the link text Link tracking will generate a hyperlink which will prvide bth track the subscribers click, and then als redirect them t the apprpriate URL Link tracking includes the ability t distribute an email message t the subscriber r anyne after clicking a link. Fr example yu culd have an email setup t distribute a message t the administratr that the subscriber is interested in a specific prduct, r distribute an email message t the user letting them knw mre abut a web site page they just clicked t visit Imprtant: Adding tracking links can be really time cnsuming! If yu want t skip the hassle, starting in Opt In Email 5.1 yu can nw chse t enable Aut Link Tracking. This feature is enabled within the standard mdule cnfiguratin area (see sectin 6.4.1). Once the link has been created via the Aut Link Tracking, yu can then cme back in and manage any f the cnfiguratin settings etc.
6.9.5 Editing a link tracking definitin In rder t edit an existing tracking definitin, chse that definitin frm the Link Tracking Definitin menu. Figure 134: Editing a link tracking definitin The definitin fr the chsen link will be displayed. Change the desired values and click the Update link t save the changes. 6.9.6 Deleting a link tracking definitin In rder t delete an existing tracking definitin, chse that definitin frm the Link Tracking Definitin menu. Figure 135: Deleting a link tracking definitin (step 1/2) The definitin fr the chsen link will be displayed. Figure 136: Deleting a link tracking definitin (step 2/2)
Click the Delete link and the definitin will be deleted. 6.10 Using the Email Campaigns The email campaign feature allws yu t create a series f emails that will be distributed t subscribers based n a unique cmbinatin f time lines and precedence. Fr example: Yu culd setup a campaign called Baseball Cards with n prerequisite email campaign. Yu can setup the email campaign t g ut 7 days after a subscriber first signed up Yu culd then setup anther campaign called Ftball Statistics, with a prerequisite f Baseball Cards and setup fr 10 days. The system wuld then send ut the first campaign 7 days after the user first subscribed t the system, and wuld send ut Ftball Statistics campaign 10 days after the user was sent the Baseball Cards campaign email With this feature yu culd als include relevant cntent within the email, such as Did yu enjy last weeks article n Baseball Cards? Yu can setup as few r as many email campaigns as yu wuld like, and all emails can include the same features fr tracking, reprts, and bunceback prtectin as newsletters In rder t start using the email campaigns, chse ptin Email Campaigns frm the Cntrl Panel. Figure 137: Chsing the "Email Campaigns" ptin The fllwing page will be displayed. Figure 138: Available email campaigns ptins The fllwing ptins are available: Email Campaigns ptin fr managing the campaigns (see sectin 6.10.1)
Schedule Settings ptin fr managing the schedule (see sectin 6.10.5) 6.10.1 Managing Email Campaigns In rder t start managing the email campaigns, chse ne f the available ptins frm the Email Campaign menu. Figure 139: Managing Email Campaigns The fllwing ptins are available: Creating a new email campaign see sectin 6.10.2 Editing an existing campaign see sectin 6.10.3 Deleting an email campaign see sectin 6.10.4 6.10.2 Creating a new email campaign In rder t create a new email campaigns, chse ptin Email Campaign menu. Figure 140: Creating a new email campaign The fllwing page will be displayed.
Figure 141: Creating a new email campaign The fllwing parameters are available: Campaign Name field fr setting the name f the campaign; it will nly be used as a reference i.e. will nt be displayed t the users Start Date - enter the starting date fr this email campaign; this date will be used as a starting pint fr sending emails within this campaign; the first email will be distributed after the starting date has been reached and in case the prerequisite days have gne by End Date - enter an ending date this email campaign; n emails will be distributed after this date Only distribute campaign t new subscribers (after start date?) - select this checkbx if yu want t send emails in case the users subscribe after the start date; therwise, emails will be distributed t any users within the pt in email list Opt in Lists - select the pt in list subscribers wh shuld receive these email campaign emails Prerequisite Email Campaign - select a prerequisite Email fr this email campaign; in ther wrds, a campaign that the subscriber must receive befre receiving this email Prerequisite Days - select the number f days that must pass (and after the prerequisite email) befre the user is eligible t receive this email campaign Test Mde Enabled select this ptin if yu wuld like t enable the test mde fr this campaign; the test mde will nly distribute emails t the email address yu have specified as 'frm'; with this feature turned n, n subscriber will receive an email frm yu
Frm Email Name enter the name fr the Frm field Frm Email Address enter the email address fr the Frm field BCC Email Address enter a BCC recipient fr the emails Email Subject - enter the subject line fr this email Display message parameters Email Message enter the cntents f the email message inside this field Email Frmat - select the email frmat fr this message; the frmat can either be in HTML r in plain text File attachment select this ptin if yu wish t attach a file t the email and use the ptins belw (File Attachment) t specify the desired file After setting the desired parameters, click n the "Update link and the new email campaign will be created. 6.10.3 Editing an existing campaign In rder t start editing an email campaign, chse the desired campaign frm the Email Campaign menu. The page with the parameters f the selected campaign will be displayed. Figure 142: Editing an email campaign Change the desired values and click the Update link t save the changes.
6.10.4 Deleting an email campaign In rder t delete an email campaign, chse the desired campaign frm the Email Campaign menu. The page with the parameters f the selected campaign will be displayed. Figure 143: Editing an email campaign Click the Delete link and the email campaign will be deleted. 6.10.5 Managing the Schedule In rder t start managing the schedule fr the emails, click the Schedule Settings tab within the Email Campaigns page (see Figure 137). Figure 144: Managing the Schedule The fllwing ptins and parameters are available: Maximum number f emails t send in a single email campaign schedule set the maximum number f emails which will be sent in a single schedule
Schedule Enabled select this ptin t enable the scheduler Time Lapse - enter the desired amunt f time which shuld pass befre the scheduler shuld run Retain Schedule Histry select Nne if yu d nt want t keep the histry r select the desired number f histry rws After setting the desired parameters, click n the "Update buttn t save the changes. 6.11 Managing the Reprts In rder t start managing the reprts, chse ptin Reprts frm the Cntrl Panel. Figure 145: Chsing ptin "Reprts" frm the Cntrl Panel The fllwing page will be displayed. Figure 146: Opt in Email reprts The fllwing ptins and parameters are available: Newsletter the ptin fr viewing newsletter reprts (see sectin )
Email Campaign Reprts the ptin fr viewing Email Campaign reprts (see sectin 6.11.6) 6.11.1 Viewing a Newsletter Reprt In rder t view a reprt fr a newsletter, select Newsletter Reprts and chse the newsletter frm the pull dwn menu. Figure 147: Viewing a Newsletter Reprt The fllwing page will be displayed. Figure 148: Available newsletter reprts The fllwing ptins and parameters are available: Quick Stats the ptin fr viewing quick statistics (see sectin 6.11.2) Email Subject/Message the ptin fr viewing email subject and bdy f the email message (see sectin 6.11.3)
Distributin Reprt the ptin fr viewing the email distributin parameters such as the time email has been sent, read, IP address f the reader, etc. (see sectin 6.11.4) Link Tracking Reprt - the ptin fr viewing link tracking reprt, i.e. infrmatin such as last clicked date, the time f the click, IP address f the user wh clicked the link, etc. (see sectin 6.11.5) 6.11.2 Viewing Quick Stats The Quick Stats ptin is used fr accessing quick statistics abut the newsletter. In rder t view these statistics click the + symbl next t the Quick Stats label. Figure 149: Viewing quick stats The fllwing infrmatin is available: Subject the field displaying the subject f the email message Distributin Date/time the field displaying infrmatin abut the time and date the distributin tk place Ttal Sent the ttal number f sent message Opens (Distinct) hw many unique penings f the newsletter Opens ttal number by all users Clicks (distinct) hw many unique clicks Clicks ttal number f clicks Failed Distributin the field displaying the number f failed distributins i.e. the newsletters wh weren t delivered t the recipients. This list reflects failures frm the mail system when attempting t actually send the message. Failed distributins ften reflect addresses withut a valid syntax such as nt including a @ r a. within the email address. Bunces the ttal number f bunced emails cllected and currently within the list cleanup table. Nte: If the bunceback list is cleared this number will reflect the cleared changes and n lnger display them as buncebacks within the reprt. Opt Outs the ttal number f users wh have decided t pt ut f yur newsletter frm within this distributin.
6.11.3 Viewing Email Subject/Message The purpse f this ptin is t allw yu t view the cntents f the newsletter i.e. the subject and the bdy f the message. In rder t see the cntents, click the + symbl next t the Email Subject/Message label Figure 150: Viewing the cntents f the email message 6.11.4 Viewing the Distributin Reprt In rder t view the distributin reprt click + next t the Distributin Reprt label. Figure 151: Viewing the distributin reprt The fllwing ptins and parameters is available: Search Users/Emails use these ptins t lk fr the specific users based n their email address, first name r last name Email Address the email address f the newsletter recipient Status the status f the actin fr each f the recipients, mst cmmnly Sent but this field can als reflect ther statuses such as failed distributins.
Sent At the time and date newsletter was sent Read the read flag reflects if the specific subscriber ever pened the newsletter r email campaign and triggered the tracking mechanism (nte: Please review the tracking sectin 6.9), the tracking feature requires the main Opt In Email mdule t be visible t all users and requires that the user either adds yur email address as a safe sender, r mre cmmnly allws fr images within the email (ften applicatin such as Micrsft Outlk will allw the user t right click within the message t allw images) Read Date/Time the date and time the newsletter has been read by the recipient Read Cunt the field displaying the number f times the recipient has read the newsletter IP Address the IP address f the recipient User Agent (Brwser) the brwser used t pen the newsletter 6.11.5 Viewing the Link Tracking Reprt In rder t view the link tracking reprt, click the + symbl next t the Distributin Reprt label. Figure 152: Viewing the Link Tracking Reprt The fllwing parameters are available: Link Tracking Name the field displaying the name f the link tracking definitin (see sectin 6.9) Link the link the recipient visited Email Address the email address f the visitr Last Clicked Date Time the date and time the visitr last clicked n the link Click Cunt the ttal number f clicks frm the specific subscriber IP Address the IP address f the visitr
6.11.6 Viewing Email Campaign Reprts In rder t view the email campaigns reprts, chse ptin Email Campaign Reprt ptin and select the campaign yu wish t see the reprt fr frm the pull dwn menu. Figure 153: Viewing Email Campaign Reprts The fllwing screen will be displayed. Figure 154: The available Email Campaign Reprts The fllwing ptins are available. Quick Stats the ptin fr viewing quick statistics (see sectin 6.11.2) Email Subject/Message the ptin fr viewing email subject and bdy f the email message (see sectin 6.11.3) Distributin Reprt the ptin fr viewing the email distributin parameters such as the time email has been sent, read, IP address f the reader, etc. (see sectin 6.11.4) Link Tracking Reprt - the ptin fr viewing link tracking reprt, i.e. infrmatin such as last clicked date, the time f the click, IP address f the user wh clicked the link, etc. (see sectin 6.11.5)
6.11.7 Managing Buncebacks Settings The purpse f the bunceback prtectin feature is t check an email accunt fr emails that have bunced back In rder t start managing the bunceback settings, chse that ptin frm the Opt in Email Reprt page (see Figure 153). Figure 155: Managing the Buncebacks Settings The fllwing ptins and parameters are available: Bunceback Settings Bunceback Hst (i.e. mail.yursite.cm) - enter the name f yur mail hst Username enter the username fr that email accunt Mail Passwrd enter the passwrd fr that email accunt Alternate Prt - select this ptin if yu wuld like t enable SSL fr the Bunceback email cnfiguratin settings Use SSL select this ptin t use SSL Maximum number f emails t check fr each schedule instance - use this ptin t specify the maximum number f emails which shuld be checked fr buncebacks within each schedule Deleting email after flagging it as bunced? select this ptin if yu wuld like t delete the email message after yu have saved the bunce flag t the database Frward nn-bunced emails t an alternate email address - enable this feature t send nn bunced emails t an alternate email address. This feature allws peple wh might have replied t yur newsletter r nreply email address
and yu wuld like t fllw up with. By enabling this feature if the email is nt marked as a bunceback the email will be frwarded t yu fr review. Nn bunced email address - enter the email address that yu wuld like t have receive nn bunced emails. Figure 156: Managing the schedule settings In rder t access the Schedule Settings, click that tab n the right. The fllwing parameters are available: Schedule Enabled select yes t enable the schedule Time lapse select the desired time interval fr the schedule Fr example: enter "5" and select "Minutes" t run task every 5 minutes. Leave blank t disable the timer fr this task. Retain Schedule histry enter the desired number f rws fr the schedule histry (fr example: select "10" t keep the ten mst recent schedule histry rws) Recmmended Settings: Sending emails ut with a frm email address that is nt checked n a regular basis is recmmended. Fr example, nreply@yursite.cm r news@yursite.cm, r newsletter@yursite.cm Cnfiguring the system t delete emails is recmmended, the scheduled prcess will nly delete emails if the message is marked as bunced and is als stred within the bunced reprt A number between 200 and 1000 is the recmmended setting fr number f emails t check fr each scheduled instance
6.12 Managing the dynamic templates The Dynamic Templates feature (when enabled belw) allws the website Administratr t create templates with Dynamic Fields such as textbx s, images, and links, which can then be referenced within the email message that will g ut. This feature is great when yu wuld like t allw end-user newsletter administratrs t create newsletters withut allwing them t change the HTML r wrry abut the prper frmatting fr the email message. In summary, yu are creating fields that the user will fill ut and will be injected within the email message t simplify creating prperly frmatted newsletters. In rder t start managing the Dynamic Templates, chse that ptin frm the Cntrl Panel. Figure 157: Managing the dynamic templates The fllwing page will be displayed.
Figure 158: Optins fr managing dynamic templates The fllwing ptins are available: Enable Templates the ptin fr enabling the dynamic templates (see sectin 6.12.1) Dynamic Templates the ptin fr managing the dynamic templates (see sectin 6.12.2) Dynamic Template Fields the ptin fr enabling the dynamic templates (see sectin 6.12.3) 6.12.1 Enabling the Templates In rder t start managing the ptins fr enabling dynamic templates, chse that ptin frm the menu. Figure 159: Optins fr enabling the templates The fllwing ptins are available: Template Cnfig see sectin 6.12.1.1 Default/Static Template
6.12.1.1 Managing the template cnfiguratin In rder t start cnfiguring the dynamic templates, chse the Template Cnfig ptin (see Figure 159). Figure 160: Managing the template cnfiguratin The fllwing ptins are available: Disabled (Static Template Only) chse this ptin t keep the dynamic templates disabled Enabled (Dynamic Templates Only) chse this ptin if yu wish t allw using the dynamic templates nly withut allwing the users t mdify it Enabled With Free Frm (Dynamic Templates w/ Ability t Change) chse this ptin if yu wish t allw the users t mdify the templates during the newsletter creatin and distributin prcess 6.12.2 Setting up the Dynamic Templates In rder t start setting up the dynamic templates, chse that ptin frm the menu. Figure 161: Setting up the Dynamic Templates The fllwing ptins are available: Dynamic Templates the ptin fr setting the dynamic template parameters (see sectin 6.12.2.1) Dynamic Template Email Subject/Message the ptin fr managing the email subject and message (see sectin 6.12.2.2)
6.12.2.1 Setting the dynamic template parameters In rder t start managing the dynamic template parameters, chse that ptin frm the menu. Figure 162: Setting up the dynamic template The fllwing parameters are available: Dynamic Template select New t create a new template r select an existing template t edit it Template Name enter the name f the new dynamic template Srt Order set the desired srt rder fr the new dynamic template Template Descriptin - enter the descriptin fr this template. The descriptin will appear when creating a new email frm this template. Template Security Rle -Select the security rle that the user is required t have in rder t utilize this template. Frm Name -Enter the 'frm name' fr the Advanced Newsletter System. When creating new newsletters this is the name that will be defaulted. Frm Email Address - Enter the default 'frm email' address fr the Advanced Newsletter System. When creating new newsletters this is the name that will be defaulted. Can Change Dynamic Template Subject? - By selecting this ptin the mdule will allw the user t change the email subject within Dynamic Templates. Can Change Dynamic Template Message? - By selecting this ptin the mdule will allw the user t change the email message within Dynamic Templates.
Can Change Dynamic Template Frm Email? - By selecting this ptin the mdule will allw the user t change the frm email within Dynamic Templates. Can Change Dynamic Template Frm Name? - By selecting this ptin the mdule will allw the user t change the frm name within the Dynamic Templates. 6.12.2.2 Managing the Email subject and message In rder t start managing the dynamic email subject and message, chse that ptin frm the menu. Figure 163: Managing the email subject and message The email bdy can be ppulated with the dynamic fields by calling these fields in the desired lcatin in the message (see 6.12.3)
6.12.3 Managing Dynamic Template Fields The Dynamic Template Fields ptin is used fr creating the individual dynamic fields within the template. These can then be incrprated int the email bdy Figure 164: Managing the dynamic template fields (screensht 1/2) The fllwing parameters are available: Dynamic Template Fields Dynamic Template - select the Dynamic Template that yu wuld like t manage fields fr. Dynamic Fields - select the Dynamic Field yu wuld like t edit r select t create a new Dynamic Field fr this template. Field Label - Enter the Dynamic Field label fr this field. Field Help Text - Enter the Dynamic Field help text fr this field. Field Shrt Name - Enter the Dynamic Field shrt name fr this field. This is a very imprtant field because the shrt field name will be referenced within the email subject, email message, and ther prperties f the email. Srt Order - Enter the srt rder the email.
Field Type - Select the field type that this template field will represent. Field Descriptin Field Descriptin - Enter the field descriptin fr this field. The field descriptin will be presented t the user when entering the data fr the field as a literal befre the field Field Example Text - Enter the field example text fr this field. The example text will be displayed t the user when entering the data fr the field as a literal belw the field. Figure 165: Managing the dynamic template fields (screensht 2/2) Advanced Field Optins Default Value enter the default value Alternate field CSS - enter the field alternate CSS prperty. Field Max Length set the maximum length fr the field Use Default As Watermark - Select if yu wuld like the default value t be displayed as a watermark within the mdule. Field is Required - Select if yu wuld like this field t be setup as a required field within the mdule. Required Field Errr Text - Enter the required field text that will appear if the user des nt submit the crrect infrmatin fr the newsletter. Required Field Errr Message - Enter the required field text that will appear if the user des nt submit the crrect infrmatin fr the newsletter.
6.12.3.1 Example f using the Dynamic Templates The created template will be available in the Newsletter Template menu. Figure 166: Example f using the Dynamic Template (screensht 1/2) Figure 167: Example f using the Dynamic Template (screensht 2/2)
Figure 168: Example f hw the fields are displayed The screensht belw demnstrates using the tken $(CupnCde) within the bdy f the email message. Figure 169: Using the tken within the email bdy The user can then enter the JuneCllectin as the cupn Figure 170: the added cupn is available t the user when creating g the newsletter
6.13 Deleting Advanced Newsletter Mdule In rder t delete Advanced Newsletter mdule, chse ptin Delete frm the main menu. Figure 171: Deleting advanced newsletter mdule (step 1/2) The cnfirmatin dialg will be displayed. Figure 172: Deleting advanced newsletter mdule (step 2/2) Click n the OK buttn t cnfirm deletin and the mdule will be deleted.
7 CONTENT LOCALIZATION The Opt In email mdule can be setup t display the cntent in several different languages. Yu can lcalize the Opt in list name and descriptin as well as the layut settings and the system emails. 7.1 Lcalizing the Opt in List name and descriptin The name and descriptin f the pt in list can be lcalized within the Opt In Lists sectin f the Cntrl Panel (chse Cntrl Panel frm the main menu and then click Opt In Lists ). Figure 173: Setting up lists In rder t lcalize the name and the descriptin, yu can either create a new list by using the ptins in the bttm r edit the existing ne with the edit icn. Nte: see sectin 7.2 fr further infrmatin n hw t display the lcalized lists nce yu have created them.
7.2 Displaying the lcalized lists In rder t display the lcalized lists, chse Mdule Cnfiguratin frm the Cntrl panel, then expand the General Settings. Figure 174: Displaying the lcalized lists Inside this page yu can specify which lists will be displayed based n the desired language. Chse the language first and then select the lists which are defined in that language. The result is that the selected lists will be displayed fr the chsen language n the website.
7.3 Lcalizing the Layut Settings In rder t lcalize the layut settings, chse Mdule Cnfiguratin frm the cntrl panel and then expand the Layut Settings sectin. Figure 175: Lcalizing the layut settings All f the available elements fr custmizing the layut can be lcalized with the fllwing steps: 1. selecting the desired language frm the language menu 2. chsing the element (e.g. Header) 3. specifying the cntent in the text area In the screensht abve the header has been lcalized fr the French versin f the site.
7.4 Lcalizing the system emails In rder t lcalize the system emails, chse Mdule Cnfiguratin frm the cntrl panel and then expand the Layut Settings sectin. Figure 176: Lcalizing the system emails Within this page chse Manage System Emails t display the ptins related t the emails. All available system emails can be lcalized with the fllwing steps: 4. selecting the desired language frm the language menu (e.g. French) 5. chsing the desired system email (e.g. New Email Verificatin Message ) 6. specifying the email cntent in the text area In the screensht abve the New Email Verificatin Message has been lcalized fr French subscribers.