ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer Class Reference

Composes the HTML representation of a mail body, and the plain text alternative that goes with it. More...

Inheritance diagram for ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer:

Collaboration diagram for ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer:

Public Member Functions
	__construct (private readonly MailAssets $assets, private readonly PlainTextMailBodyComposer $plain_text, private readonly UIFactory $ui, private readonly Renderer $renderer, private readonly Refinery $refinery, private readonly DataFactory $data, private readonly string $installation_title, private readonly string $installation_url)
	compose (MailBodySource $source)
	compose (MailBodySource $source)

Private Member Functions
	containsHtml (string $email_body)

Private Attributes
const string	BLOCK_ELEMENT_PATTERN = '~</?(p|br|div|ul|ol|li|code|pre|h[1-6])\b~i'
const string	INLINE_TAGS = '<b><u><i><a>'

Detailed Description

Composes the HTML representation of a mail body, and the plain text alternative that goes with it.

Knows nothing about recipients, transports or where assets are stored.

Definition at line 35 of file HtmlMailBodyComposer.php.

Constructor & Destructor Documentation

__construct()

ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer::__construct	(	private readonly MailAssets	$assets,
		private readonly PlainTextMailBodyComposer	$plain_text,
		private readonly UIFactory	$ui,
		private readonly Renderer	$renderer,
		private readonly Refinery	$refinery,
		private readonly DataFactory	$data,
		private readonly string	$installation_title,
		private readonly string	$installation_url
	)

Definition at line 40 of file HtmlMailBodyComposer.php.

      {
    }

Member Function Documentation

compose()

ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer::compose

(

MailBodySource

$source

)

Implements ILIAS\Mail\Mime\Presentation\MailBodyComposer.

Definition at line 52 of file HtmlMailBodyComposer.php.

                                                   : ComposedMailBody
    {
        $html = $source->transformedToHtml();
        $html = $this->containsHtml($html) ? $html : nl2br($html);
        $html = $this->refinery->string()->makeClickable()->transform($html);
 
        $images = $this->assets->inlineImages();
        $logo = $images->logo();
        $page = $this->ui->layout()->page()->mail(
            $this->assets->styleSheet()->path(),
            'cid:' . ($logo?->cid() ?? ''),
            $this->installation_title,
            $this->ui->legacy()->content($html),
            $this->data->link($this->installation_url, $this->data->uri($this->installation_url))
        );
        $plain_text = $this->plain_text->compose(new MailBodySource($html));
 
        return new ComposedMailBody(
            $this->renderer->render($page),
            $plain_text->body(),
            $images
        );
    }

References $page, ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer\containsHtml(), ILIAS\Repository\refinery(), renderer(), ILIAS\Mail\Mime\Presentation\MailBodySource\transformedToHtml(), and ILIAS\Repository\ui().

Here is the call graph for this function:

containsHtml()

ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer::containsHtml ( string  $email_body )

private

Definition at line 76 of file HtmlMailBodyComposer.php.

                                                     : bool
    {
        if (!str_contains($email_body, '<') || !str_contains($email_body, '>')) {
            return false;
        }
 
        if (preg_match(self::BLOCK_ELEMENT_PATTERN, $email_body) === 1) {
            return true;
        }
 
        return strip_tags($email_body, self::INLINE_TAGS) !== $email_body;
    }

Referenced by ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer\compose().

Here is the caller graph for this function:

Field Documentation

BLOCK_ELEMENT_PATTERN

const string ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer::BLOCK_ELEMENT_PATTERN = '~</?(p|br|div|ul|ol|li|code|pre|h[1-6])\b~i'

private

Definition at line 37 of file HtmlMailBodyComposer.php.

INLINE_TAGS

const string ILIAS\Mail\Mime\Presentation\HtmlMailBodyComposer::INLINE_TAGS = '<b><u><i><a>'

private

Definition at line 38 of file HtmlMailBodyComposer.php.

---

The documentation for this class was generated from the following file:

• components/ILIAS/Mail/src/Mime/Presentation/HtmlMailBodyComposer.php