Loading...

All project content is available for reading, but you need to be a member of the project for Subversion checkout of source code, or to create/modify any information.
Login if you are a member. Apply here to request membership (open to all).

Configuration

Configuring the Newsletter module.

Securing the plugin

Add a web.config file to the /bvn/sendmail/ folder with the following contents:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
    <system.web>
        <globalization requestEncoding="utf-8" responseEncoding="utf-8" />
        <!-- 
         Do not allow anonymous users access to plug-in or tools
        -->
    <authorization>
      <allow roles="CmsEditors, CmsAdmins, WebEditors, WebAdmins, Administrators" />
      <deny users="*" />
    </authorization>
    </system.web>
    <!--
    If you use the standard subscribe / unsubscribe user controls
    we need to allow these to be loaded.
    -->
    <location path="Units">
        <system.web>
            <authorization>
                <allow users="*" />
            </authorization>
        </system.web>
    </location>
</configuration>

Please change the groups in the roles setting above according to your needs (editors that needs access to the module should be a member of at least one of the groups).

web.config - 2.x version

Important
These configuration settings target the CMS 5/6 platform and requires v2.x of the Newsletter module.

You need to configure the SMTP settings, as these are used by the Newsletter module when sending emails. Make sure the SMTP server you're configuring is allowed to send emails on your network, or is granted relay rights to send through another server. Your network administrator can help you with these settings.

<system.net>
  <mailSettings>
    <!-- Pick Up directory is not supported for the Newsletter module -->
    <!--<smtp deliveryMethod="PickupDirectoryFromIis"/>-->
    <smtp from="newsletter@yourcompany.com" deliveryMethod="Network">
      <!-- Should point to a server that is allowed to send emails -->
      <network host="localhost" port="25" 
               userName="" password="" 
               defaultCredentials="false" />
    </smtp>
  </mailSettings>
</system.net>

Additional configuration settings. All these have default values, so you only need to change them if the default values are not ok.

<appSettings>

 <!-- Default sender address, if missing on page -->
 <add key="EPsSendMailFromAddress" value="your@address.here" />

 <!-- Comma separated list of page types where the plug-in should be available. If empty
       the module will look for a page type called "Newsletter"
  -->
 <add key="EPnSendMailPageType" value="" />

 <!-- The location of the production license file. The root dir will be prepended.
       Note! This is a filesystem path, not a virtual path. It needs to be relative
        to the root dir of your site.
 -->
 <add key="EPsAspNetEmailRelativeLicensePath" value="newsletter\aspnetemail.xml.lic" />

 <!-- The (max) number of emails the send task will send each time it runs.
        If you set the scheduled task to run each minute, and each mail takes one second
        to send, a value of 50 is optimal.
 -->
 <add key="EPnSendMailSendBatchSize" value="50" />

</appSettings>

web.config - 1.x version

Important

  • These configurations are for the 1.x version of the Newsletter module, targeted for v4 of EPiServer.
  • Some of these values can be added or changed directly from the system settings plug-in (see the screenshots).
<appSettings>
 <!-- BEGIN Newsletter module settings -->
 
 <!-- Master Mail Plug-in availability setting -->
 <add key="EPfEnableSendMailPlugIn" value="True" />
 
 <!-- Default sender address, if missing on page -->
 <add key="EPsSendMailFromAddress" value="your@address.here" />
 
 <!-- Not in use! The address the report should be sent to. -->
 <add key="EPsSendMailSendReportMailTo" value="feature.will@be.removed.soon" />
 
 <!-- If missing on page, default title to be used -->
 <add key="EPsSendMailSubject" value="Newsletter" />
 
 <!-- Comma separated list of page types where the plug-in should be available. If empty
       the module will look for a page type called "Newsletter"
  -->
 <add key="EPsSendMailPageType" value="" />
 
 <!-- A class inheriting from MailSenderBase, responsible for sending the email. 
        For this version you should use the setting below.
 -->
 <add key="EPsSendMailSenderType" value="BVNetwork.EPiSendMail.Library.MailSenderAdvIntellect, BVNetwork.EPiSendMail" />
 
 <!-- Location of email templates used by the system. Currently, only used for 
        the admin report. You should not change the original templates, but copy
        and point to the new directory.
  -->
 <add key="EPsSendMailTemplateDir" value="~/bvn/sendmail/mailtemplates/" />
 
 <!-- The configuration xml file. This is very important for the newsletter
  functionality, and things will not work without it. Copy this file, and
  point to the new file here. Note - this feature has been replaced, and will
  be removed from the code in v2.1 -->
 <add key="EPsSendMailConfigurationFile" value="~/bvn/sendmail/configuration/newsletterconfiguration.xml" />
 
 <!-- The location of the production license file. The root dir will be prepended.
       Note! This is a filesystem path, not a virtual path. It needs to be relative
        to the root dir of your site.
 -->
 <add key="EPsAspNetEmailRelativeLicensePath" value="newsletter\aspnetemail.xml.lic" />
 
 <!-- The (max) number of emails the send task will send each time it runs.
        If you set the scheduled task to run each minute, and each mail takes one second
        to send, a value of 50 is optimal.
 -->
 <add key="EPnSendMailSendBatchSize" value="50" />
<!-- END Newsletter module settings -->

</appSettings>

Depending on your infrastructure, you might want to change the SMTP settings.

<!-- The SMTP Server to use. Use the IP address of the smtp
     server if your production server does not have access to DNS.
-->
<add key="EPsSmtpServer" value="yourservername" />