PHPackages                             hn/typo3-mail-sender - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail &amp; Notifications](/categories/mail)
4. /
5. hn/typo3-mail-sender

ActiveTypo3-cms-extension[Mail &amp; Notifications](/categories/mail)

hn/typo3-mail-sender
====================

TYPO3 extension for configuring and validating email sender addresses with DNS and deliverability checks

v0.3.0(1mo ago)3443[1 issues](https://github.com/hauptsacheNet/typo3-mail-sender/issues)GPL-2.0-or-laterPHPPHP ^8.1.0CI passing

Since Dec 29Pushed 4w agoCompare

[ Source](https://github.com/hauptsacheNet/typo3-mail-sender)[ Packagist](https://packagist.org/packages/hn/typo3-mail-sender)[ Docs](https://github.com/hauptsacheNet/typo3-mail-sender)[ RSS](/packages/hn-typo3-mail-sender/feed)WikiDiscussions main Synced today

READMEChangelog (5)Dependencies (21)Versions (25)Used By (0)

TYPO3 Extension: Mail Sender Configuration
==========================================

[](#typo3-extension-mail-sender-configuration)

Configure and validate email sender addresses with DNS and deliverability checks for TYPO3 CMS.

**Funded by the TYPO3 Community Budget Q4 2025** — [Learn more](https://typo3.org/article/members-have-selected-four-ideas-to-be-funded-in-quarter-4-2025)

The Problem
-----------

[](#the-problem)

Email delivery fails silently. Your TYPO3 site sends emails, but they never arrive — or worse, they land in spam. Common causes:

- **SPF misconfiguration**: Your SMTP server isn't authorized to send for your domain
- **Missing DKIM**: Emails aren't signed, reducing trust
- **No DMARC policy**: Receiving servers don't know how to handle authentication failures
- **Invalid addresses**: Typos or non-existent sender addresses cause bounces
- **Missing MX records**: The sender domain can't receive replies

These issues are invisible until someone reports missing emails. By then, you've lost form submissions, notifications, and customer trust.

The Solution
------------

[](#the-solution)

This extension validates sender addresses *before* they cause problems. Configure your sender addresses once, validate them, and use them across your TYPO3 site with confidence.

What Gets Validated
-------------------

[](#what-gets-validated)

CheckWhat It Does**Email Syntax**Validates RFC 5322 compliance — catches typos and malformed addresses**MX Records**Confirms the domain has mail servers configured**SPF**Verifies your TYPO3 SMTP server is authorized to send for this domain**DKIM**Checks email signatures are properly configured (requires test email)**DMARC**Analyzes authentication policy and provides recommendations**Email Existence**Confirms the mail server accepts the addressValidation runs automatically and results are cached. Upload a test email (EML file) for complete SPF/DKIM/DMARC validation against your actual mail flow.

Features
--------

[](#features)

- Manage sender addresses in the TYPO3 backend
- Visual validation status in the record list
- CLI command: `mail:sender:validate`
- Integration with TYPO3 System Information module
- Integration with ext:form (validated sender dropdown)
- Scheduler task for periodic re-validation

Screenshots
-----------

[](#screenshots)

### Backend Module

[](#backend-module)

[![Mail Sender Backend Module](Documentation/Images/backend-module-overview.png)](Documentation/Images/backend-module-overview.png)

*Manage sender addresses with validation status, scheduled re-validation, and webhook notifications.*

### Validation Details

[](#validation-details)

[![Validation Results](Documentation/Images/validation-results.png)](Documentation/Images/validation-results.png)

*Detailed validation results showing individual checks for syntax, MX, SPF, DKIM, DMARC, and email existence.*

### System Reports Integration

[](#system-reports-integration)

[![Reports Integration](Documentation/Images/reports-integration.png)](Documentation/Images/reports-integration.png)

*Integration with TYPO3 System Reports showing sender address status at a glance.*

Requirements
------------

[](#requirements)

- TYPO3 12.4, 13.4 or 14.3 (LTS)
- PHP 8.1 or later (TYPO3 14 requires PHP 8.2+)
- Optional: `mika56/spfcheck` for full SPF validation

Installation
------------

[](#installation)

```
composer require hn/typo3-mail-sender
```

Usage
-----

[](#usage)

### Managing Sender Addresses

[](#managing-sender-addresses)

1. Navigate to the **List** module
2. Select the **root page** (ID: 0)
3. Create new **"Mail Sender Address"** records

Each record contains:

- **Sender Email Address**: The email to use as sender
- **Sender Name**: Display name for the sender
- **EML File**: Optional test email for SPF/DKIM/DMARC validation

### CLI Validation

[](#cli-validation)

Validate all sender addresses:

```
vendor/bin/typo3 mail:sender:validate
```

Validate a specific address:

```
vendor/bin/typo3 mail:sender:validate --email=info@example.com
```

### Integration with ext:form

[](#integration-with-extform)

The extension provides a `SenderEmailAddress` form element that shows a dropdown of validated sender addresses instead of a freetext field.

Development
-----------

[](#development)

### Running Tests

[](#running-tests)

Functional / unit tests (host PHP + SQLite):

```
composer test
```

#### End-to-end tests (Playwright)

[](#end-to-end-tests-playwright)

The end-to-end suite drives a real TYPO3 backend with Playwright and verifies the three user-facing surfaces against all supported TYPO3 versions (12.4, 13.4, 14.3):

1. the **ext:form integration** (the validated sender-address dropdown is injected into the form editor and the form can be saved),
2. the **validation backend module** (lists sender addresses and revalidates),
3. the **List module** (lists and creates Mail Sender Address records).

```
# Run against the currently installed TYPO3 version
Build/runTests.sh -s e2e --no-docker

# Run against a specific TYPO3 version (installs it via composer)
Build/runTests.sh -s e2e -t 12.4 --no-docker
Build/runTests.sh -s e2e -t 13.4 --no-docker
Build/runTests.sh -s e2e -t 14.3 --no-docker
```

The runner sets up an SQLite-backed TYPO3 instance, seeds a validated sender address and a form definition, starts the PHP built-in web server and runs the Playwright specs in `Build/tests/playwright/`. CI runs the same suite across the three versions (see `.github/workflows/tests.yml`).

### Test Coverage

[](#test-coverage)

- Basic CRUD operations
- Record soft-delete and visibility
- TCA configuration
- Database schema
- End-to-end coverage of the form editor, validation module and List module

Contributing
------------

[](#contributing)

We welcome contributions from the TYPO3 community!

- Share feedback via [GitHub Issues](https://github.com/hauptsacheNet/typo3-mail-sender)
- Report bugs
- Improve documentation
- Submit pull requests

Roadmap
-------

[](#roadmap)

### Phase 1: Foundation ✅

[](#phase-1-foundation-)

Basic extension structure with sender address management in the TYPO3 backend.

### Phase 2: Core Validation ✅

[](#phase-2-core-validation-)

Complete email validation system with DNS checks, SPF/DKIM/DMARC analysis, and status reporting.

### Phase 3: Integration &amp; Adoption 🔄

[](#phase-3-integration--adoption-)

- ✅ Integration with ext:form
- 📋 TCA Extra Field API for third-party extensions
- 📋 Documentation for extension developers

### Phase 4: Polish &amp; Import 🔄

[](#phase-4-polish--import-)

- ✅ Import from `$GLOBALS['TYPO3_CONF_VARS']['MAIL']`
- 📋 Import from TypoScript configurations
- 📋 Reference tracking (where sender addresses are used)
- 📋 TER release

**Target Release:** December 2025

License
-------

[](#license)

GPL-2.0-or-later

Authors
-------

[](#authors)

- **Marco Pfeiffer** —
- **TYPO3 Community** — Funded by Community Budget Q4 2025

###  Health Score

42

—

FairBetter than 88% of packages

Maintenance87

Actively maintained with recent releases

Popularity20

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 88.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~31 days

Recently: every ~21 days

Total

6

Last Release

30d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f18b6c8ad90bb53f9c5273b79360259b0ec172951de367046ac13ab0f1b44f63?d=identicon)[Nemo641](/maintainers/Nemo641)

---

Top Contributors

[![Nemo64](https://avatars.githubusercontent.com/u/1749936?v=4)](https://github.com/Nemo64 "Nemo64 (31 commits)")[![kaywalker](https://avatars.githubusercontent.com/u/1043613?v=4)](https://github.com/kaywalker "kaywalker (2 commits)")[![claude](https://avatars.githubusercontent.com/u/81847?v=4)](https://github.com/claude "claude (1 commits)")[![knusperpixel](https://avatars.githubusercontent.com/u/1455404?v=4)](https://github.com/knusperpixel "knusperpixel (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/hn-typo3-mail-sender/health.svg)

```
[![Health](https://phpackages.com/badges/hn-typo3-mail-sender/health.svg)](https://phpackages.com/packages/hn-typo3-mail-sender)
```

###  Alternatives

[friendsoftypo3/content-blocks

TYPO3 CMS Content Blocks - Content Types API | Define reusable components via YAML

103519.9k53](/packages/friendsoftypo3-content-blocks)[aimeos/aimeos-typo3

Professional, full-featured and high performance TYPO3 e-commerce extension for online shops and complex B2B projects

1.5k94.0k6](/packages/aimeos-aimeos-typo3)[netresearch/rte-ckeditor-image

Image support in CKEditor for the TYPO3 ecosystem - by Netresearch

611.1M8](/packages/netresearch-rte-ckeditor-image)[wazum/sluggi

TYPO3 extension for URL slug management with inline editing, auto-sync, locking, access control, and redirects

40529.5k](/packages/wazum-sluggi)[pagemachine/typo3-formlog

Form log for TYPO3

23238.6k8](/packages/pagemachine-typo3-formlog)[typo3/cms-redirects

TYPO3 CMS Redirects - Create manual redirects, list existing redirects and automatically createredirects on slug changes.

167.4M80](/packages/typo3-cms-redirects)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
