Skip to content

SocialSettingsSavingNotification

Published before Social’s settings are saved from Settings › Social › Schedule & writing (the page saves the schedule and these settings in two requests, so SocialScheduleSavingNotification covers the slots). The settings are the time zone and the two webhook opt-ins. A handler can change them, or refuse the save. Whether publishing is switched on comes from configuration, not from here.

The following properties are available within the notification

Property Name Type Use
Target SocialSettingsDraft The settings as they are about to be saved. Change them here.
Existing SocialSettingsView The settings as stored: TimeZoneId and Webhooks (WebhookOptIns).
Messages EventMessages Add the message to return when you cancel.
Cancel bool Set to true to cancel without a message.

SocialSettingsDraft has these properties, all settable:

Property Name Type Use
TimeZoneId string? The time zone to set, or null to keep the current one.
IncludePostTextInWebhooks bool Whether Social’s webhooks carry the post’s text.
IncludeAuthorInWebhooks bool Whether Social’s webhooks carry the post’s author.

Call CancelOperation(new EventMessage(category, message, EventMessageType.Error)). Nothing is saved, and the result is settings.cancelled:<message>.

The time zone is checked after the handlers (settings.time_zone_unknown). SocialSettingsSavedNotification is published after the save.