Features 

Requirements 

• TYPO3 12.4 LTS, 13.4 LTS, or 14 LTS
• PHP 8.1 or newer
• microsoft/microsoft-graph ^2 (installed automatically)
• zbateson/mail-mime-parser ^3 (installed automatically)

Composer 

Install the extension via Composer:

composer require oliverkroener/ok-typo3-helper

Local path repository 

When used as a local path-repository extension (as in the oliverkroener project layout), place the package under packages/ and require it as a development version:

composer require oliverkroener/ok-typo3-helper:@dev

Setup 

After installation, run the extension setup and flush caches:

vendor/bin/typo3 extension:setup
vendor/bin/typo3 cache:flush

The Microsoft Graph SDK (microsoft/microsoft-graph) and the MIME parser (zbateson/mail-mime-parser) are declared as dependencies and are installed automatically.

Converting a message for Microsoft Graph 

MSGraphMailApiService::convertToGraphMessage() is static and takes a Symfony SentMessage. It returns an array with the built Graph message and the resolved from address:

use OliverKroener\Helpers\MSGraphApi\MSGraphMailApiService;

$result = MSGraphMailApiService::convertToGraphMessage($sentMessage);
$graphMessage = $result['message']; // Microsoft\Graph\Generated\Models\Message
$fromAddress  = $result['from'];    // string|null

Inline images work automatically: build the mail with Symfony's ->embed() (or a TYPO3 Fluid mail template with an inline image), and the cid: reference in the HTML body is preserved end-to-end into the Graph attachment's contentId. This is what lets Outlook / OWA render the image inside the body instead of only listing it as an attachment.

Resolving the site root 

SiteRootService returns the site root page UID for a given page UID. It is registered as a public singleton in Configuration/Services.yaml and can be injected via dependency injection:

use OliverKroener\Helpers\Service\SiteRootService;

$rootPageId = $siteRootService->findNextSiteRoot($currentPageId); // int|null

If the page is not part of any configured site, null is returned.

Dynamic property accessors 

ReflectionPropertiesTrait provides dynamic getters and setters via __call() and reflection, giving access to protected and private properties:

use OliverKroener\Helpers\Traits\ReflectionPropertiesTrait;

class MyModel
{
    use ReflectionPropertiesTrait;

    private string $title = '';
}

$model = new MyModel();
$model->setTitle('Hello');   // routed through __call → reflection
echo $model->getTitle();     // "Hello"

An unknown method name, or access to a property that does not exist, throws an \Exception.

Author — Oliver Kroener 

Support 

If you encounter issues or have questions about this extension:

• Bug reports & feature requests: Use the GitHub issue tracker
• Email: ok@oliver-kroener.de

Contributing 

Contributions are welcome. Please open a pull request or issue on GitHub.

License 

This extension is licensed under the GPL-2.0-or-later.