JungleMail | Deploy tracking to external Site Collection

It is possible that you want to use JungleMail for SharePoint on an external Site Collection. In this case you will have to deploy JungleMail's Tracker and Subscription Web Parts on this external site for all of JungleMail's tracking features to work. In this tutorial you will learn how to do this.

This tutorial, for your convenience, is split into three different sections.

1. Deploying JungleMail 
  • Activating the Tracker and Subscription Web Parts
2. Tracker configuration
  • Creating a page and adding the JungleMail Tracker Web Part

  • Configuring JungleMail Tracker Web Part
  • Entering web part URL in JungleMail Site Collection Settings

3. Subscription management functionality configuration
  • Creating a page and adding the JungleMail Subscription Web Part
  • Configuring JungleMail Subscription Web Part
  • Entering web part URL in JungleMail Site Collection Settings

Note: When starting this tutorial you should have completed all the necessary configurations for the JungleMail Tracker and/or Subscription feature as described in the Preparing for Tracking and Subscription configuration tutorial.


1. Deploying JungleMail 

Activating the Tracker and Subscription Web Parts

To set up JungleMail's Tracking and Subscription functionality, you will need to deploy JungleMail solution in the new site collection.

1. To begin, go to Central Administration and click ‘System Settings’ > ‘Manage Farm Solutions’.  

2. Click on the enova.sp.junglemail.wsp solution.    

3. Click 'Deploy Solution'.  

4. Choose the previously created web application.

5. After deploying JungleMail solution, open site settings on the root web site.
Now, under Settings click 'Site Settings' > 'Site Collection Features'.
Activate the JungleMail Publishing Web Parts feature.

Enable this feature in Site Collection Settings. This will activate tracking and subscription management in the JungleMail Core. If there are no required lists available they will be created automatically.

6. Go to Settings > Site Settings > EnovaPoint JungleMail Site Collection Settings to enable Tracking functionality. It is enabled by default.      

7. Go to Settings > Site Settings > EnovaPoint JungleMail Site Collection Settings to enable the subscription management and topics management functionality. By default these settings are enabled. You can disable them if you don’t need them.

      

2. Tracker configuration

Creating a page and adding the JungleMail Tracker Web Part     

1. To start creating a new page go to Settings and click “Add a page”. 
2. Enter the name, “Tracker”, for example, and click Create.

3. Start editing the page and add JungleMail Tracker web part to the page that you have created earlier.

Configuring JungleMail Tracker Web Part

1. Go to the page where you added the web part, start editing the page and click Edit Web Part.

2. Choose the JungleMail Core location. You should choose/specify the location in which JungleMail is operating and where its system lists are located.

  • Choose “Current Site Collection” to use JungleMail tracking 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.
  • Choose “Other Site Collection” if you want to track remote users, and want to place the web part on a different site collection than the one used for sending emails. If you choose this option, you will have to specify the main site collection URL on which the “EnovaPoint JungleMail Core” feature is activated. You will also need to provide credentials to access this site collection. For the web part to work you should specify a user which has read access to site on which JungleMail system lists are located. Test the connection to ensure user can access site which includes the JungleMail system list.
  • From JungleMail 5.5 and up:
    1. Create a separate user in Active Directory to access your main SharePoint Collection with JungleMail Core feature activated. User name could be like Domain\jmUser. Should be a member of Domain Users group.Speaking of Group Policy, you might want to ensure that your domain service accounts are denied the Log on Locally user right at the very least. This action will prevent a malicious user from succeeding in an interactive logon attempt by using a breached service account. 
    2. Create New Permission level  on a root site level for newly created account. This will ensure this account will only has access to access JungleMail Service and do not has access to parent lists or libraries of that site collection.  
      -Open root site’s Site Permissions -> permission levels

      -Add  a New Permission Level -Select “Open” and “Use Remote Interfaces” check-boxes and save this custom permission level. For Instance 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 required permissions for the user in JungleMail built-in lists. All lists are located on a site collection root. Assign the following permissions to the user on a list level in the following lists: 
      JungleMail Subscribers  - View, Add and Edit items permissions
      JungleMail Topics - Read permission level
      JungleMail History - Read permission level
      JungleMail Tracker Links - Read permission level
      JungleMail Tracker Actions - View, Add permissions.  

      Note: You should break the permission inheritance or Set Unique permissions for the lists above. 

Entering web part 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.
2. Enter the URL of Subscriptions page that you previously created.

Congratulations! You have now successfully set up JungleMail's tracking feature.

3. Subscription management functionality configuration

Creating a page and adding the JungleMail Subscriptions Web Part

1. To create a new page go to Settings and click “Add a page”.
2. Enter the name, “Subscriptions”, for example, and click Create.
3. Start Editing the Page and add JungleMail Subscriptions web part to the page that you have created earlier.

Configuring JungleMail Subscriptions web part

1. Go to the page, where you have added the web part, start editing the page and click Edit Web Part.

2. Choose the JungleMail Core location. You should chose/specify a location where JungleMail is operating and it system lists are located.

  • Choose “Current Site Collection” to use the JungleMail Subscription Web Part on the same site collection which is used for sending emails.
  • Choose “Other Site Collection” if you want to track remote users, and want to place the web part on a different site collection than the one used for sending emails. If you choose this option, you will have to specify the main site collection URL on which the “EnovaPoint JungleMail Core” feature is activated. You will also need to provide credentials to access this site collection. For the web part to work you should specify a user which has read access to site on which JungleMail system lists are located. Test the connection to ensure the user can access site which includes the JungleMail system list.

Note: If you choose “Current Site Collection” JungleMail will automatically add the page URL to the site collection settings.



3. Enter the address of the user that is responsible for the functioning of JungleMail's subscriptions. If the Web Part fails to connect to your main site collection, it will notify this user via email.

The appearance of the Web Part can be edited from JungleMail site collection options. Click “Update Look and Feel” to refresh the Web Part for changes to take effect.

Entering web part URL in JungleMail Site Collection Settings

Here you will enter the tracking URL which 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 of the Subscriptions page that you previously created.

Congratulations! You have now successfully set up the Subscription Management feature of JungleMail.

Still need help? Contact Us Contact Us