JungleMail | Configuring subscription functionality

It can be useful to offer your users a newsletter subscription service. With JungleMail, you can do this in SharePoint. Simply start by creating a page, dedicated to this purpose. If you plan to send newsletters to external users or mobile devices, this page should be anonymously accessible from the internet.

The subscription management page with the JungleMail Subscription Web Part will allow users to subscribe, unsubscribe or manage their Newsletter subscription on topics of interests. This tutorial is partitioned into five separate steps.

  1. Creating a Page and adding the Web Part
  2. Configuring the JungleMail Subscription Web Part
  3. Entering the Subscription page URL in JungleMail Site Collection Settings
  4. Enabling subscription and topic management
  5. Creating subscription topic groups and topics in JungleMail

Understanding environment requirements

When setting up your newsletter subscription service, it is useful to understand the specific requirements of your environment. If you are using JungleMail internally, on a Windows domain for example, then it is still recommended to use an external SharePoint page with anonymous access. This is to ensure it will work properly with mobile devices and different email clients. However, if email applications are able to exchange login details, an internally accessible page will work just fine. 

To publish page externally, for access by non-employees or from unauthenticated devices, we recommend creating an empty site collection on a new Web Application with two pages, one for tracking and another one for unsubscribe and subscription management. It is also necessary to activate the EnovaPoint JungleMail Publishing Web Part site collection feature JungleMail Tracking and Subscriptions Web Parts for your Web Part gallery. You should enable this feature on the Site Collection you are going to place Web Parts in.

Note: For more information on how to create a new Site Collection, please refer to our tutorials Creating a publicly accessible SharePoint site and Deploying JungleMail to external site collection for tracker and subscription Web Parts.

1. Creating a page and adding the web part

Note: Subscription and Tracker Web Parts have to be placed in separate pages.

1. Go to Settings and click Add a page.

2. Enter the name and click Create

3. Insert the JungleMail Subscription Web Part to the newly created page. You will find this web part in the EnovaPoint Web Parts folder.

2. Configuring the JungleMail Subscription Web Part

Choose the JungleMail Core location (i.e., location where JungleMail is operating and where its system lists are stored).     

  • Choose Current Site Collection to use the JungleMail Subscription Web Part on the site collection which is used for sending emails. JungleMail Core feature and settings should be enabled for the web part to work correctly. 
    Note: if you choose Current Site Collection, JungleMail will automatically add the page URL to the site collection settings.
  • Choose Other Site Collection (recommended when dealing with external recipients or mobile devices) if you want to offer subscription modification services on a remote and publicly available SharePoint site collection with anonymous access. If you choose this option, you will have to specify the main site collection URL under which the EnovaPoint JungleMail Core feature is activated. You should then provide user credentials to access this site collection. We recommend creating  a separate user account with very limited permissions to access JungleMail Service of the main SharePoint Environment where JungleMail Core feature is activated. Do not activate the JungleMail Core feature on an external environment with anonymous access.

In JungleMail 5.5 and up:

1. Create a separate user in Active Directory to access your main SharePoint Collection on which the JungleMail Core feature is activated. Your  user name  could be, for example, Domain\jmUser. Note that the user should be a member of the Domain Users group. For security  purposes , we recommend you to ensure that your domain service accounts are denied  the  log-on  locally user rights at the very least. This action will prevent a malicious user from logging in using a breached service account.

2. Next, create a new Permission level on root site level for the newly created account. This will ensure the account will only have access to the JungleMail Service and not to the parent lists or libraries of that site collection.

Go to root site's Site Permissions -> Permission Levels

Click Add a  Permission Level.

Check the Open and Use Remote Interfaces boxes and save this custom permission level under an easy-to-understand name, e.g., JungleMailWebPartsPrivileges.

3. On the root site, go to Site Settings -> Site Permissions -> Grant Permissions and assign the newly created permission level to the user created in Step 1 ( domain\JMuser).
4. Now you need to assign the required permissions for the user in JungleMail built-in lists. All lists are located on the root site collection. Assign the following permissions to the user on a list level in the following lists:
  • JungleMail Subscribers  - Contribute permission level
  • JungleMail Topics - View only permission level

In tracking web part specified user should have permissions in the following lists:

  • JungleMail History - View only permission level
  • JungleMail Tracker Links - View only permission level
  • JungleMail Tracker Actions - Contribute permission level.   

Note: you should disable permission inheritance or Set Unique permissions for the above lists.  

5. Choose how to see new subscribers. If you choose to see new subscribers as External users, they will always be asked for their email address when subscribing. If you choose Internal, the JungleMail Subscription Web Part will try to resolve user information from a SharePoint login. Enter the address of the user responsible for the functioning of JungleMail subscriptions. If the Web Part fails to connect to your main site collection, it will notify the user via E-mail.

The appearance of the Web Part can be edited from the JungleMail site collection options. To do this click Update Look and Feel to refresh the Web Part. JungleMail updates Look and Feel automatically every 12 hours.

Important: update Web Part Look and feel every time you change its appearance in Site Collection settings.

3. Entering the Subscription page URL in JungleMail Site Collection Settings

This URL will be placed in the email body when sending group emails.

1. Go to the Site Collection settings. Click EnovaPoint JungleMail Site Collection Settings.

Note: If you choose Current Site Collection in the web part options, JungleMail will automatically add the page URL to the Site Collection settings.

2. Enter the URL (external address) of the Subscriptions page that you previously created. 

4. Enabling Subscriptions management and Topics management

Please make sure that you enabled Subscription and Topics management in JungleMail Site Collection settings.

1. To find these settings, open Settings and click Site Settings.

2. Under Site Collection Administration, click EnovaPoint JungleMail Site Collection Settings.

3. At the bottom of the page, enable Subscribe, unsubscribe and the subscription management functionality. Enable subscription on topics of interest, too.

Now we can move on to creating subscription topics.

5. Creating subscription topic groups and topics in JungleMail

1. Navigate to JungleMail Topics SharePoint list which is located on the site collection root site (Home).

2.  Use Add new item to add new topics.

3. To group topics, use the Parent Topic column. For ordering use the Position column with order numbering.

4. You can now open your subscriptions page and all of the topics should be available in the Web Part. If they are not, you might need to update the Look and Feel of the Web Part. To do this, edit the Web Part and click Update Look and Feel for the changes to take immediate effect. In the example below, the Subscription Web Part for Internal users is used:

5. The appearance of your Subscription Web Part can be edited in JungleMail Site Collection Settings to match your requirements.

Note: After you edit the Web Part's appearance, you must go to the page where the Web Part is located, edit the page, edit the Web Part and click “Update Look and Feel” for the changes to take immediate effect. If you do not do this, the Web Part will retain its previously cached appearance.

Still need help? Contact Us Contact Us