You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/guides/integrations/news-agencies.md
+28-28Lines changed: 28 additions & 28 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -237,49 +237,49 @@ POST /api/{{< api-version >}}/import/documents
237
237
}
238
238
```
239
239
240
-
## Setup of news agencies notifications
240
+
## Notifications
241
241
242
-
To enable notifications for news agency reports, you need to extend the configuration as follows:
242
+
{{< added-in "release-2025-09" block >}}
243
243
244
-
Within the [`newsAgency` property]({{< ref "/reference/project-config/news-agencies" >}}), add a property named notifications.
245
-
This property specifies the categories that users can subscribe to in order to receive notifications.
244
+
To ensure that users don't miss breaking news while working on other topics, Livingdocs provides notifications for incoming news agency reports. These notifications appear throughout Livingdocs—whether on a dashboard, article, or in any other view. Users can directly create an article from a notification with a single click.
246
245
247
-
If the notifications property is empty or missing, users will neither be able to configure notification settings nor receive any notifications.
To enable notifications for news agency reports, extend the [`newsAgency` property]({{< ref "/reference/project-config/news-agencies" >}}) with a `notifications` property. This property defines the categories users can subscribe to for notifications. If `notifications` is missing or empty, users cannot configure or receive notifications.
248
251
249
252
```js
250
253
newsAgency: {
251
-
// ...
252
254
notifications: [
253
255
{
254
256
handle:'politics',
255
257
label: {en:'Politics', de:'Politik'},
256
258
category:'politics'
257
259
},
258
-
{
259
-
handle:'economy',
260
-
label: {en:'Economy', de:'Wirtschaft'},
261
-
category:'economy'
262
-
},
263
-
{
264
-
handle:'sports',
265
-
label: {en:'Sports', de:'Sport'},
266
-
category:'sports'
267
-
},
268
260
{
269
261
handle:'feuilleton',
270
-
label: {en:'Feuilleton', de:'Feuilleton'},
271
-
category:'feuilleton'
272
-
},
273
-
{
274
-
handle:'media',
275
-
label: {en:'Media', de:'Medien'},
276
-
category:'media'
277
-
},
278
-
{
279
-
handle:'other',
280
-
label: {en:'Other', de:'Sonstiges'},
281
-
category:'other'
262
+
label: {en:'Feuilleton and Media', de:'Feuilleton und Medien'},
263
+
category: ['feuilleton', 'media']
282
264
}
283
265
]
284
266
}
285
267
```
268
+
269
+
### 2. User Settings
270
+
271
+
With the configuration applied, a settings button becomes available on every news agency screen. Opening this panel allows users to configure their individual notification preferences. The following options are available:
272
+
273
+
-**Enable**: Toggle notifications on or off.
274
+
-**Categories**: Subscribe to one or more of the preconfigured categories to receive notifications only for relevant reports.
275
+
-**Sleep Timer**: Temporarily mute notifications until the next day without disabling them entirely.
Notifications are triggered only if all of the following conditions are met:
280
+
281
+
- Notifications are enabled and the sleep timer is deactivated.
282
+
- The report matches the selected categories.
283
+
- The report has Priority 1 or Priority 2.
284
+
285
+
Each notification remains visible until the user closes it, creates an article from it, or 30 minutes have elapsed, after which it is closed automatically.
Copy file name to clipboardExpand all lines: content/operations/releases/release-2025-09.md
+21-20Lines changed: 21 additions & 20 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -196,6 +196,8 @@ Since the following dashboard cells are now exclusive to the News Agency module,
196
196
-`liTableDashboardCellTime` to `liTableDashboardCellNewsAgencyTime`
197
197
-`liTableDashboardCellAgency` to `liTableDashboardCellNewsAgencyCreate`
198
198
199
+
If you are using any of these dashboard cells, please update their names accordingly.
200
+
199
201
{{< feature-info "Operations" "server" >}}
200
202
201
203
### Migrate the Postgres Database :fire:
@@ -215,26 +217,26 @@ TODO: check migration
215
217
216
218
### News Agency Notifications
217
219
218
-
It is now possible to receive notifications for news agency reports directly in Livingdocs. Once enabled, these notifications appear throughout the application - whether on a dashboard, in the editor, or in any other view. They inform users that a new news agency report matching the defined criteria is available. From there, an article can be created instantly with just one click.
220
+
It is now possible to receive notifications for news agency reports directly in Livingdocs. Once enabled, these notifications appear throughout the application—whether on a dashboard, article, or in any other view. They inform users that a new news agency report matching the defined criteria is available. From there, an article can be created instantly with just one click.
219
221
220
222
To ensure users stay informed even when they are not actively working in Livingdocs, the favicon is highlighted whenever a new notification is available. In addition, browser notifications can be activated to alert users outside of the Livingdocs tab as soon as a new report is received.
221
223
222
224
#### Criteria for receiving News Agency Notifications
223
225
224
-
An incoming news agency report will always be displayed on the news agency screen if its criteria match the screen’s configuration.
225
-
However, a notification will only be triggered if all of the following conditions are met:
226
+
An incoming news agency report will only trigger a notification if the following conditions are met:
226
227
227
228
- The news agency report has a Priority 1 or Priority 2.
228
229
- Notifications are enabled and the sleep timer is deactivated.
229
230
- The corresponding category of the report is selected in the news agency notification settings.
230
-
- The report has not already been received by Livingdocs.
231
231
232
232
#### News Agency Notification Settings
233
233
234
-
The settings for news agency notifications are available on every news agency screen. To show the settings, its icon must be clicked. It is located next to the display filters at the top of the document list and indicates the current status: Disabled, Enabled, Sleep Timer Active.
234
+
The settings for news agency notifications are available on every news agency screen. To show the settings, click its icon. It is located next to the display filters at the top of the document list and indicates the current status: Disabled, Enabled, or Sleep Timer Active.
235
235
236
236
Clicking the icon opens the settings. When the toggle is switched on, a list of all configured categories is displayed. Notifications are delivered for all categories that are checked.
Configure these categories using the `notifications` property inside the `newsAgency` property:
239
241
240
242
```js
@@ -251,31 +253,29 @@ newsAgency: {
251
253
```
252
254
253
255
In addition to enabling or disabling notifications and adjusting the category selection, users can also activate a sleep timer to temporarily mute notifications. Settings changes are persisted per user.
254
-
It can also contain a hint regarding browser notifications, if they are unset or disabled (see respective sections below for more information).
The settings may also contain a hint regarding browser notifications if they are unset or disabled (see the respective sections below for more information).
257
257
258
258
#### News Agency Notifications Modal
259
259
260
-
When all notification criteria are met, a notification will appear in the top center of the Livingdocs interface.
260
+
When all notification criteria are met, a notification will appear at the top center of the Livingdocs interface.
261
261
It contains a cell representing the news agency report, including the timestamp, title, source, and a plus button. Clicking the plus button immediately creates a Livingdocs article based on this report.
262
262
Below the report cell, users can either toggle notifications on/off or activate the sleep timer, just as in the notification settings. Additionally, a Details button opens the full report details, mirroring the side panel on the news agency screen.
263
-
If multiple notifications are present, a navigation element appears in the top-right corner. Users can click the arrows to browse through all received news flash reports. The currently opened notification remains active and visible, even when new notifications arrive.
263
+
If multiple notifications are present, a navigation element appears in the top-right corner. Users can click the arrows to browse through all received news agency reports. The currently opened notification remains active and visible, even when new notifications arrive.
264
264
265
-
These notifications behave similarly to other Livingdocs notifications (e.g. error messages). They overlay all other interface elements. While interacting directly with the notification and its content, the background remains inactive. However, when clicking or working outside of the notification, the rest of the interface behaves as usual.
265
+
These notifications behave similarly to other Livingdocs notifications (e.g., error messages). They overlay all other interface elements. While interacting directly with the notification and its content, the background remains inactive. However, when clicking or working outside the notification, the rest of the interface behaves as usual.
A notification will remain visible until one of the following occurs:
271
271
272
272
- An article is created directly from the notification using the plus button.
273
273
- The notification is closed manually via the close button in the top-right corner.
274
274
- 30 minutes have passed. In this case, only the specific notification that reached the 30-minute limit will disappear; other notifications remain unaffected.
275
275
276
-
Notifications and news agency settings are synchronized across all open browser tabs. When a notification is closed in one tab, it is automatically closed in all other tabs. The same applies when a new notification is received - it becomes visible in every open tab.
276
+
Notifications and news agency settings are synchronized across all open browser tabs. When a notification is closed in one tab, it is automatically closed in all other tabs. The same applies when a new notification is received—it becomes visible in every open tab.
277
277
278
-
When notifications are open, the favicon changes. A small red circle is added on top of the Livingdocs logo (the default favicon). Once all notifications are closed, the favicon reverts to its normal state. This visual cue ensures that users can easily recognize when new notifications are available - even if no Livingdocs tab is currently active.
278
+
When notifications are open, the favicon changes. A small red circle is added on top of the Livingdocs logo (the default favicon). Once all notifications are closed, the favicon reverts to its normal state. This visual cue ensures that users can easily recognize when new notifications are available—even if no Livingdocs tab is currently active.
279
279
280
280
#### Sleep Timer
281
281
@@ -286,16 +286,17 @@ If news agency notifications are switched off completely, the sleep timer will b
286
286
287
287
The sleep timer is available both in the News Agency Notification Settings and in the Notification Modal.
288
288
289
-
#### Browser Notification
289
+
#### Browser Notifications
290
290
291
291
Livingdocs now supports browser notifications for incoming news agency reports that meet the notification criteria, providing a way to receive alerts outside of the application.
292
-
When opening the new agency notification settings for the first time, the browser will ask users to grant permission for Livingdocs notifications (by default, this setting is unset).
292
+
When opening the news agency notification settings for the first time, the browser will ask users to grant permission for Livingdocs notifications (by default, this setting is unset).
293
+
293
294
If the user declines, a permanent hint will be shown in the News Agency Notification Settings.
294
-
If the user accepts, in addition to the in-app News Agency Notification, a browser notification will be displayed.
295
+
If the user accepts, then in addition to the in-app News Agency Notification, a browser notification will be displayed.
295
296
296
-
The browser notification itself contains only the title of the incoming news agency report that matches the criteria. Handling of the notification depends entirely on the browser and on the users system (computer) settings. Livingdocs has no control over the appearance, duration, or sound of these notifications.
297
+
The browser notification itself contains only the title of the incoming news agency report that matches the criteria. Handling of the notification depends entirely on the browser and the user’s system (computer) settings. Livingdocs has no control over the appearance, duration, or sound of these notifications.
297
298
298
-
Note: When sharing your screen in a video call, or if system notifications are disabled, browser notifications may not be displayed at all.
299
+
Note: if system notifications are disabled, or when sharing your screen in a video call, browser notifications may not be displayed at all.
0 commit comments