Five New Optimizely Certifications are Here! Validate your expertise and advance your career with our latest certification exams. Click here to find out more
AI OnAI Off
Navigation [hide]
[expand]
- Caching
- Client Resources
- CMO
- Installing and Configuring the Aggregation Service
- Integrating EPiServer CMO with External Applications
- Configuring Live Monitor for Multiple Bindings
- Configuring the Statistics Handler
- Configuration
- How To
- Configuration Syntax
- Configuring episerver Section
- Configuring episerver.basicAuthentication Section
- Configuring episerver.dataStore Section
- Configuring Image Service
- Configuring Live Monitor
- Configuring Quick Publishing
- Configuring Which User Interface to Use
- Content
- Pages and Blocks
- How To
- Adding Edit Hints When Not Using the Property Web Control
- Changing Display Channel Programmatically
- Converting Page Types for Pages
- Creating a Page Programmatically
- Creating Page Templates and Block Controls
- Edit hints in MVC
- Selecting a Template Based on Tag
- Working with Page Objects
- Attributes
- Blocks, Block Types and Block Templates
- Pages, Page Types and Page Templates
- Refactoring Content Type Classes
- Synchronization
- Properties
- Display Channels
- Links
- Persisting IContent Instances
- Shared Blocks and Folders
- Working with IContentRepository/DataFactory
- Content Providers
- Deployment
- Configuring a Multi-Site Setup
- Configuring XML Update Reference
- Deployment Center
- Enterprise Features
- Dynamic Content
- Editing
- Event Management
- File System
- Globalization
- Initialization
- Localization
- Logging
- Mirroring
- Navigation and Listings
- Personalization
- Routing
- Scheduled Jobs
- Search
- Search Integration
- Searching for Pages Based on Page Type Property
- Searching for Pages Based on Page Type
- Security
- Authentication and Authorization
- Configuring Active Directory Membership Provider
- Handling Cookies on the Website
- Protecting Users From Session Hijacking
- Securing Edit and Admin
- Virtual Roles
- Configuring Web Services Authentication
- Subscription
- Validation
- WebDAV
- Workflows
- XForms
Area:
Optimizely CMS
Subscription
Note: This topic has no later version.
Introduction
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.
Note Subscription e-mails are sent on a subscription root and language basis. This means that a user subscribing to two subscription roots in two languages will receive one e-mail per language.
Note It is necessary to define EPSUBSCRIBE-ROOT ('Root page for Subscription' in Edit mode) as a Page type in the subscription page and select the node/page below which all of the subscription pages can be found. If you miss this then no subscriptions items appear on the page.
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 |
|---|---|---|
| From-address | subscription@[host] | SubscriptionMailFrom |
| Subject | language specific | SubscriptionMailSubject |
| Introduction | empty | SubscriptionMailBody |
| Link title | language specific | SubscriptionMailReadMore |
See Also
- Refer to the Scheduled Jobs section of this SDK documentation for more information in this area.
Last updated: Mar 25, 2013
