markocupic/be_email

Send emails from the Contao backend. Backend extension for the Contao Open Source CMS

3.4.1 2022-08-29 20:26 UTC

Requires

• php: ^8.0
• contao/core-bundle: ^4.13 || ^5.0
• markocupic/contao-component-vue-js: ^2.6

Requires (Dev)

• contao/easy-coding-standard: ^5.0

Replaces

• contao-legacy/be_email: *

MIT

• Marko Cupic

• Backend Email Client
• Contao CMS

README

Contao Backend E-Mail

Contao E-Mail Erweiterung für den Versand von Nachrichten aus dem Contao Backend. In den Contao Einstellungen kann definiert werden, woher das Adressbuch seine Adressen zieht. Entweder tl_member oder tl_user oder aus beiden Tabellen.

Kompatibilität

Die Version 3.3 ist nur zu Contao >=4.9 kompatibel.

Viel Spass mit Contao Backend E-Mail!

beEmailBeforeSend Hook

Mit dem beEmailBeforeSend-Hook können die beiden Objekte vor dem Versand manipuliert werden. Dazu muss eine Contao Hook Klasse geschrieben werden.

Damit der Hook via Annotation registriert wird, muss er in der services.yml registriert werden.

# services.yml
services:
    _defaults:
        autowire: true
        autoconfigure: true
        public: true

    Vendorname\App\:
        resource: ../../
        exclude: ../../{DependencyInjection,Resources,Model,Widget}

Die Hook-Klasse könnte ungefähr so aussehen. Der Hook erwartet drei Parameter und keinen Rückgabewert.

<?php

namespace Vendorname\App\Listener\ContaoHooks;

use Contao\CoreBundle\ServiceAnnotation\Hook;

/**
 * @Hook("beEmailBeforeSendHook")
 */
class BeEmailBeforeSendHook
{
    /**
     * !!!Important
     * For manipulating data first and second parameter should be passed by reference!
     * @param $objEmail
     * @param $beEmailModel
     * @param $dc
     */
    public function __invoke(&$objEmail, &$beEmailModel, $dc)
    {
        // f.ex. manipulate sender email address
        $objEmail->from = '[e-mail]';

        // f.ex. manipulate content
        $objEmail->text = 'bla bla!!';
        $objEmail->html = 'bla bla!!';
    }

}