in2code/groupmailer

Installs: 1

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 4

Forks: 1

Open Issues: 0

Type:typo3-cms-extension

1.0.1 2020-06-08 09:03 UTC

This package is auto-updated.

Last update: 2024-11-07 23:11:16 UTC


README

Usage

Generate Mailing via MailService

Parameter for generateMailing:

  • $backendGroups [array]: an array with backend groups
  • $subject [string]: the email subject. The max length is currently 255. This can be increased via the TCA
  • $bodytext [string]: the email content
  • optional $senderEmail [string]: the sender email. If not defined the fallback $GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromAddress'] is used
  • optional $senderName [string]: the sender name. If not defined the fallback $GLOBALS['TYPO3_CONF_VARS']['MAIL']['defaultMailFromName'] is used
  • optional $mailFormat [string]: default FluidEmail::FORMAT_BOTH valid options are FluidEmail::FORMAT_BOTH, FluidEmail::FORMAT_HTML or FluidEmail::FORMAT_PLAIN
  • optional $context [string]: default Context::FRONTEND valid options are Context::FRONTEND, Context::BACKEND
  • optional $workflowState [int]: default Workflow::STATE_DRAFT valid options are Workflow::STATE_DRAFT, Workflow::STATE_REVIEW, Workflow::STATE_APPROVED, Workflow::STATE_REJECTED
  • optional $attachments [array]: an array with SysFile Objects

How to use the mailService

        $beGroupRepository = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\TYPO3\CMS\Extbase\Domain\Repository\BackendUserGroupRepository::class);
        $beGroups = [
            $beGroupRepository->findByUid(2),
            $beGroupRepository->findByUid(4)
        ];
        
        $fileRepository = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\TYPO3\CMS\Core\Resource\FileRepository::class);
        $attachments = [
            $fileRepository->findByUid(2)
        ];

        $mailService = \TYPO3\CMS\Core\Utility\GeneralUtility::makeInstance(\In2code\Groupmailer\Service\MailService::class);
        $mailService->generateMailing(
            $beGroups,
            'Betreff',
            'Inhalt',
            'sender@in2code.de',
            'Sender Name',
            \TYPO3\CMS\Core\Mail\FluidEmail::FORMAT_PLAIN,
            \In2code\Groupmailer\Context\Context::BACKEND,
            \In2code\Groupmailer\Workflow\Workflow::STATE_DRAFT,
            $attachments
        );

Generate the mail queue

The mail queue can be generated via the groupmailer:generateMailQueue command.

./vendor/bin/typo3 groupmailer:generateMailQueue

This can be automated via an Scheduler task.

Process the mail queue (sends the actual mails)

The mail queue can be generated via the groupmailer:processMailQueue command.

./vendor/bin/typo3 groupmailer:processMailQueue

This can be automated via an Scheduler task.

Configuration

This extension can be configured in the "Extension Configuration" (Backend Module 'Settings' -> "Extension Configuration")

Configuration options

  • Storage Pid [integer]: Sets the PID on which the records are stored
  • Emails to sent per execution [integer]: Defines how many mails should be sent on one execution of the process mail queue command
  • Recursion Level [integer]: Defines the recursion level for the given backend user groups in a mailing

Workflow

  • DRAFT: mailings with this status will be ignored if mail queue entries will be generated
  • REVIEW: mailings with this status will be ignored if mail queue entries will be generated
  • REJECTED: mailings with this status will be moved into locked mailings and no mail queue entries will be generated
  • APPROVED: queue entries will be generated on the next execution of the generateMailQueue command