Note: This topic has no later version.
Subscription allows website visitors to subscribe by e-mail to website content of their choice. Selected content pages, for instance news or event pages, can be made available to be included in the subscription scheduled job that is set up. This document describes the subscription feature in in EPiServer CMS, and how to configure the look and content of subscription e-mails sent out.
Setting up Subscription
The following are basic parts of subscription in EPiServer CMS:
- At least one page where the EPSUBSCRIBE property is set to true.
- A page exposing the SubscriptionList web control that handles loading and saving of subscription information.
- The Subscription Scheduled Job.
Each page where EPSUBSCRIBE is set to true will act as a root page for a subscription branch. Information about changes made to this page and its substructure may be sent out via subscription e-mail when the “Mark page as changed” check box has been selected. If you don't want a page in the subscription branch to be included in subscription e-mail, you can set the EPSUBSCRIBE-EXCLUDE property to true for this page
The SubscriptionList web control allows users to apply for and configure their subscription. This control will list all pages where EPSUBSCRIBE is set to true in a check box list allowing the user to subscribe to one or several subscription branches.
The language in which the subscription page is displayed determines which language the user will be subscribing to. For example, if the user applies for a subscription on the English version of the subscription page, the user will receive subscription information about all English pages that have been modified in the selected subscription branches. Please see the SubscriptionPage template in our basic template package for an example on how the SubscriptionList control can be used.
The subscription job is responsible for determining which pages have been updated and formatting/sending subscription mail. Make sure that this scheduled job is active and running by looking at the job's configuration in Admin mode.
Modifying the Content of Subscription E-mails
By default, the from-address, subject, introduction and link titles used in the subscription e-mail will all use hard-coded values or values fetched from the language files. The subscription job allows the default values to be overridden and determines if that is the case by looking for specifically named properties on the subscription root pages. It does not matter if the properties are dynamic or placed on the subscription root’s PageType. The following table specifies the properties that can be overridden, their default values and the name of the override property that the subscription job looks for.
|Property||Default value||Name of override property|
|Link title||language specific||SubscriptionMailReadMore|
- Refer to the Scheduled Jobs section of this SDK documentation for more information in this area.