Breaking News | Version 3

Breaking News Guide

This guide provides detailed information about the add-on components so that editors are able to create and publish breaking news in a simple workflow.

Archived documentation for Sophora 3. End-of-support date for this version: 7/25/21

Documentation for Sophora 4

"Publish Breaking News" Workflow

With this add-on, editors can publish breaking news by opening the Tools menu and selecting the "Eilmeldung veröffentlichen" ("Publish Breaking News") menu entry.

Sophora Add-on Breaking News - Werkzeug-Menüeintrag
Sophora Add-on Breaking News - Werkzeug-Menüeintrag (Image: subshell/CC BY)

A dialog is then opened with fields to write down the headline and text of the breaking news. If there is more than one distribution channel available (see Distribution Channels and Templates), the editor additionally has to select the channels to publish the breaking news into. Otherwise the only available channel will be used.

Sophora Add-on Breaking News - Dialog
Sophora Add-on Breaking News - Dialog (Image: subshell/CC BY)

With one final click, the breaking news document(s) will be created, published and opened in the DeskClient automatically.

Breaking News Configuration

The breaking news configuration document "Eilmeldungskonfiguration" is a system document that can be found in the Administration View. Here the necessary property mapping is done, so that the textual components given by the editor as well as additional information can be transferred into one or more properties of the resulting breaking news document.

FieldDescription
Fester ID-StammFixed id stem that will be used for all new breaking news documents. If this field is empty, the id stem will be generated from the headline.
Zielfelder für ‚Überschrift‘Fields that should be filled with the headline provided by the user.
Zielfelder für ‚Text‘Fields that should be filled with the text provided by the user.
Zielfelder für ‚Verbreitungskanal‘Fields that should be filled with the distribution channels selected by the user.
Mit aktuellem Datum zu füllende FelderFields to fill with the date at which the breaking news document has been created.
Mit dem Benutzernamen zu füllende FelderField to fill with the name of the user that has created the breaking news document.

Distribution Channels and Templates

During the "Publish Breaking News" Workflow one or more distribution channels are selected. The script then uses templates which are linked to the distribution channel to create new breaking news documents.

All available distribution channels have to be specified in the provided select value document "Verbreitungskanäle". To assign a template to a channel (which is mandatory), drag and drop a template document into the "Referenced documents" column. To create a document template from an existing document, open the existing document first. Then, on the Template tab, activate the checkbox Use as template.

Since creating new breaking news from the templates is a cloning process, all information that is already present in a template, e.g. pre-filled fields or components like a teaser image, will be preserved. An exception to this are the properties defined in the Breaking News Configuration document because they will be overwritten by the script.

If the same breaking news document is allowed to be published into multiple channels, assign the same template document to them. Otherwise, multiple breaking news documents will be created upon selection of different channels and each one is published into the according channel.

Notification Messages in Breaking News Documents

The mixin sophora-breaking-news-mix:isBreakingNews should be assigned to every node type that is used when creating breaking news. These are the node types of the documents which are used as templates. The property sophora-breaking-news:isBreakingNews from the mixin will be set when a new breaking news document is created via script. The property may be configured on a document tab if it should be visible to the user.

With this property, the provided validation script identifies breaking news documents. It triggers a notification message to be shown, informing the user that the open document is a breaking news document. If there are other currently published breaking news documents, the notification will list the Sophora-IDs of the other documents as well (with a maximum of 5 documents).

Last modified on 9/8/20

The content of this page is licensed under the CC BY 4.0 License. Code samples are licensed under the MIT License.

Icon