Newsagent/Newsletters

Newsagent
Author	Chris Page
Contact	Support
Repository	github
Issue tracker	github
OS	Neutral (web based) Will not work with IE8 or older
URL	Newsagent
Navigation
General Overview Feed List Feed Subscription Logging in Logout Articles Composing Articles (Quickstart) Image Library Files Notification Method Options Feeds and Visibility Multiple Feeds Listing Articles Editing Articles Template Articles Syndication Newsletters Newsletters Newsletter Editor Tell Us Tell Us Queues Tech docs Advanced/Upcoming features Installation Technical Autogenerated docs

Newsletters

Newsagent allows individuals, or groups of individuals, to work together to produce newsletters - structured collections of stories published on a more or less regular basis, and sent via email or other transports to groups of individuals.

Two types of Newsletter exist in the system:

• Manual release. These newsletters are not automatically sent by the system; instead a newsletter publisher must press a button in the Newsletter Editor to trigger publication.
• Automatic release. Newsletters configured for automatic release have a defined publication schedule. Provided the publication criteria are met, automatic release newsletters will publish the stories set for the newsletter without human intervention.

Manual release newsletters can be converted to automatic release mode by the addition of a release schedule, and vice versa.

Newsletters consist of one or more sections, and each section can contain zero or more stories. Each story in a section is a Newsagent Article. You may place multiple stories into a single article if you want, but doing so may prevent it being templated and styled correctly in the generated newsletter - one story/piece per article is generally recommended.

Newsletter sections may be configured to require a number of articles to be present in the section before the newsletter may be published. So, for example, if the "News and events" section requires a minimum of two articles, the newsletter can not be published until at least two articles are available to be published in that section. The default is to not require a minimum article count for sections.

If a section is empty when a newsletter is published, it will generally be omitted entirely - the header will not be included, and it will not be linked to from any quick-jump menu that may be defined. If this behaviour is not desirable (for example, a "No news is available for this section" message would be preferred), sections may be configured to include a templated 'empty' message instead.

Adding articles to newsletters

The Compose page is used to create articles to add to newsletters. During the compose process you select the "Newsletter" tab in the Settings box at the right of the page to switch to Newsletter mode:

• Go to the Compose page
• Click on the Newsletter tab in the Settings box on the right side of the page to switch to Newsletter mode.
• Select the newsletter to add the story to
• Select the section of the newsletter you want to add the story to.
• If you want the story included in the next published copy of the newsletter, leave the Publish option on "In next publication", otherwise you can delay its release until a later date.
• Enter the title of the story in the Subject box
• The Summary is optional, leave it blank if you want
• Enter the text of your story in the Full text box, formatting as desired.
• Optionally set an article image to show at the side of your story (as in the attached screenshot)
• Click Create Article to add the story to the newsletter.