README.md

Neos CMS - Publisher Notifier

This package sends notifications every time someone publishes to an internal workspace. If the internal workspace already has unpublished changes it will not send notifications anymore to not spam Slack channels or email inboxes.

Simply install the package via composer:

composer require codeq/publishnotifier

Make sure your site has Neos.Flow.http.baseUri setting defined, so your reviewers would get correct urls. If you don't want to do this, you can manually set the domain in the message text like this:

Please review the changes and publish to live: https://example.com/%3$s'

Configuration for email notifications

In order to send messages to emails you need to add configure the neos/swiftmailer credentials

Then you need to configure the target email addresses, together with the email content:

CodeQ:
  PublishNotifier:
    email:
      enabled: false
      senderName: 'Neos'
      senderAddress: '[email protected]'
      notifyEmails:
        - '[email protected]'
      subject: '%1$s has published changes'
      body: |+
        %1$s has published changes to the private workspace %2$s.
        Please review the changes and publish to live: %3$s'

Configuration for Slack messages

In order to send messages to Slack you need to add an incoming WebHook to your Slack workspace. Read more about it here https://api.slack.com/incoming-webhooks

As the incoming webhooks are treated as Slack Apps they are bound to a single channel. Therefore, you can configure multiple "postTo" to use several webhooks:

CodeQ:
  PublishNotifier:
    slack:
      enabled: false
      postTo:
        myExampleTarget:
          webhookUrl: 'https://hooks.slack.com/services/...'
      message: |+
        %1$s has published changes to the private workspace %2$s.
        Please review the changes and publish to live: %3$s'

Possible Improvements

• Automatically get email addresses from all live-publishers.
• Show visual diff of changes