ssch/t3-notifier

Wrapper for Symfony Notifier

v1.0.3 2023-12-12 14:59 UTC

Requires

• php: ^7.4 || ^8.0
• symfony/notifier: ^5.0 || ^6.2
• symfony/options-resolver: ^5.0 || ^6.2
• typo3/cms-core: ^10.4 || ^11.5 || ^12.4
• typo3/cms-extbase: ^10.4 || ^11.5 || ^12.4

Requires (Dev)

• php-parallel-lint/php-parallel-lint: ^1.3
• phpstan/extension-installer: ^1.2
• phpstan/phpstan: ^1.8
• phpstan/phpstan-phpunit: ^1.2
• phpstan/phpstan-strict-rules: ^1.4
• saschaegerer/phpstan-typo3: ^1.8
• symplify/easy-coding-standard: ^12.0
• typo3/cms-lowlevel: ^10.4 || ^11.5 || ^12.4
• typo3/minimal: ^10.4 || ^11.5 || ^12.4
• typo3/testing-framework: ^6.16 || ^7.0

Replaces

• typo3-ter/t3-notifier: v1.0.3

GPL-2.0+

• Sebastian Schreiber

• notifier

README

Integrates Symfony Notifier into TYPO3 https://symfony.com/doc/current/notifier.html

Integration guide

The extension basically provides the same functionality as if you would use the notifier in the Symfony Framework. In order to configure the notifier you have to put a Notifier.php file under the Configuration folder of an extension.

return [
    'chatter_transports' => [
        'slack' => '%env(SLACK_DSN)%'
    ],
    #
    'texter_transports' => [
        'twilio' => '%env(TWILIO_DSN)%'
    ],
    # https://symfony.com/doc/current/notifier.html#configuring-channel-policies
    'channel_policy' => [
        'urgent' => ['sms', 'chat/slack', 'email'],
        'high' => ['chat/slack'],
        'medium' => ['browser']
    ]
];

In order to use the notifier you can inject it via Dependency Injection

use Symfony\Component\Notifier\NotifierInterface;
use TYPO3\CMS\Extbase\Mvc\Controller\ActionController;
use Symfony\Component\Notifier\Notification\Notification;
final class SomeController extends ActionController
{
    public function __construct(private readonly NotifierInterface $notifier) {}
    public function someAction() {

        $notification = (new Notification('New Notification'))
            ->content('You got a new notification.')
            ->importance(Notification::IMPORTANCE_HIGH);

        $this->notifier->send($notification, new Recipient('[e-mail]'));
    }
}

This would send a new notification to the chat channel via the slack transport.

LogWriter

The extension ships with a custom LogWriter to send LogRecords via the Notifier. In order to use the LogWriter you can configure it i.e. via ext_localconf.php

use Ssch\T3Notifier\Logger\Writer\NotifierWriter;
use Symfony\Component\Notifier\Recipient\Recipient;
use TYPO3\CMS\Core\Log\LogLevel;

$GLOBALS['TYPO3_CONF_VARS']['LOG']['Examples']['writerConfiguration'] = [
    LogLevel::ERROR => [
        NotifierWriter::class => [
             // Optional configuration
            'channels' => ['chat/slack']
            'recipients' => [new Recipient('[e-mail]', '123455678')],
        ],
    ],
];

If you don´t pass the channels option, you have to configure your channel_policy. The PSR-3 LogLevel will be translated to the importance level for the Notification. I.e. if you would call $this->logger->error it would be translated to the importance level of high.

BrowserChannel

[tbd]

EmailNotification

[tbd]