Using The Newsletter

The Newsletter feature is brand new as of version 2.2.4.6 of mojoPortal content management system and will be evolving based on user feedback.

You must have correct settings for the smtp server in Web.config/user.config

Create a Newsletter by clicking the key icon to get to the Administration menu, then click the link for Newsletter Administration, then click the "Add New Newsletter" link to create a new newsletter. There you will define the title of the newsletter, description, and some other settings. You can select which roles are allowed to subscribe, by default it is All Users. Once you have saved the newsletter additional links will appear on the Newsletter Administration page that allow you to create new letter editions and view previous editions that have been sent (of course at first none have been sent).

A new option appears in the My Account page where users can opt into the list. You can view current subscribers also from the Newsletter Administration page.

I've only included one email template since I'm really not a designer myself. I recommend see the list of resources below with links to some free templates and information that may help you create your own templates. Html email is quite a different animal than regular html. Most email clients like Gmail or Yahoo will strip out the head section and sometimes even the body tags, leaving only what was contained in the body. You may have some success with styles by putting them in <style type="text/css">...</style> inside the body, but this is not valid html even though it will display correctly. You can use valid html by using inline styles with style="..." on each element that you want to style but this becomes very verbose and clumsy.

Images may not display unless the user allows it so its best if your content conveys the message well even if images are not visible.

Token Replacement

Most important when creating your letter editions is to make sure you include #unsubscribe# somewhere in your letter. This token will be replaced with a user specific unsubscribe link automatically. We may also implement other tokens for personalizing the messages in future versions in a mail merge fashion.

Unsubscribe links are mandatory. You should familiarize yourself with the CAN-SPAM Act Requirements to make sure you do not violate them. Used correctly email marketing can be a great tool to build connections with your readers.

It is possible but not recommended to disable the enforcement of the #unsubscribe# token by adding this in user.config:

<add key="NewsletterEnforceCanSpam" value="false" />

If the newsletter is available for all roles then you can also optionally use a token to include a "View As Web Page" link, the token is #viewaswebpage#

Additional Tokens added as of mojoPortal CMS version 2.3.9.4

#username#
Will be replaced by the site member display name or the non member email address.

#email#
Will be replaced by the email address.

#displayname#
Will be replaced by the site member display name from the user profile
For non site members will be replaced by a default value from the newsletter definition Display Name Token Default setting or empty string if that is not populated.

#firstname#
For site members will be replaced by the first name from the user profile if populated else it will use the display name from the user profile.

For non site members will be replaced by the First Name Token Default setting on the newsletter definition or empty string if not populated.

#lastname#
For site members only will be replaced by the last name from the user profile if populated else it will use be replaced by an empty string.

For non site members will be replaced by the Last Name Token Default setting on the newsletter definition or empty string if not populated.

So, as an example, for non site members one could put Valued Customer for the first and last name defaults.
These would not be used for site member since we can at least be sure of a display name even when first and last name are not populated.

Importing Subscriber Data

We have example code for importing subscribers from a comma separated value (csv) file. Download the mojoNewsletterSubscriberImportExampleCode.zip file, and read the readme.txt for further details. Thanks to Steve Railsback who provided the example code.

Created by Joe Audette on Jan 12, 2008
Last Modified by Joe Audette on Nov 17, 2012

Monetize Your Site With Site Membership Pro!