Notifications
UmbSocial publishes these Umbraco notifications. Handle them with builder.AddNotificationAsyncHandler<TNotification, THandler>() in a composer (or the synchronous AddNotificationHandler). They are in the namespace UmbSocial.Core.Notifications.
See Extending UmbSocial for the rules every handler follows, including how cancelling works. Every operation follows the same pattern: an “…ing” notification before it, which can change or stop it, and an “…ed” notification after it is saved. The one exception is sealing the free edition’s history: its “…ing” notification is for information, as sealing always happens.
When a handler throws
Section titled “When a handler throws”- An “…ed” notification is published after the change is saved. A handler that throws doesn’t undo the save, but the request that made the change may still report a failure, so the person may see an error for a change that was made.
- Sealing the free edition’s history is the exception: an exception from a SocialHistorySealingNotification or SocialHistorySealedNotification handler is logged (with the post ids) and ignored, and sealing carries on.
| Notification | When | Can cancel |
|---|---|---|
| SocialPostSavingNotification | Before a post is created or updated | Yes |
| SocialPostSavedNotification | After a post was created or updated | No |
| SocialPostDeletingNotification | Before a post is deleted | Yes |
| SocialPostDeletedNotification | After a post was deleted | No |
| SocialPostsLoadedNotification | Before posts are returned by a list or read | No (remove items to hide them) |
Channels
Section titled “Channels”| Notification | When | Can cancel |
|---|---|---|
| SocialChannelSavingNotification | Before a channel is added or changed | Yes |
| SocialChannelSavedNotification | After a channel was added or changed | No |
| SocialChannelRemovingNotification | Before a channel is removed | Yes |
| SocialChannelRemovedNotification | After a channel was removed | No |
Publishing
Section titled “Publishing”| Notification | When | Can cancel |
|---|---|---|
| SocialPostDispatchingNotification | Before a post is handed to a channel’s automation | Yes (the target fails) |
| SocialPostTargetPublishedNotification | A post is live on a channel | No |
| SocialPostTargetFailedNotification | A post failed on a channel, or its outcome is unknown | No |
| SocialPostDispatchedNotification | After a post was handed to a channel’s automation | No |
| SocialPostOutcomeRecordedNotification | After any result was recorded for a channel (published, failed or unknown) | No |
| SocialPostRetryingNotification | Before a person sends a failed or unknown result again | Yes |
| SocialPostRetriedNotification | After a result was put back in the queue | No |
| SocialPostMarkingPublishedNotification | Before a person marks a result as published | Yes |
| SocialPostMarkedPublishedNotification | After a result was marked as published | No |
Schedule and settings
Section titled “Schedule and settings”| Notification | When | Can cancel |
|---|---|---|
| SocialScheduleSavingNotification | Before the posting schedule (slots and time zone) is saved | Yes |
| SocialScheduleSavedNotification | After the posting schedule was saved | No |
| SocialSettingsSavingNotification | Before the settings (time zone and webhook opt-ins) are saved | Yes |
| SocialSettingsSavedNotification | After the settings were saved | No |
History and links
Section titled “History and links”| Notification | When | Can cancel |
|---|---|---|
| SocialHistorySealingNotification | Before the free edition seals a batch of old posts | No (sealing always happens) |
| SocialHistorySealedNotification | After old posts were sealed | No |
| SocialLinkPreviewFetchedNotification | A link card was read, before it is returned | No (change the card) |