hn/typo3-mail-sender

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

Maintainers

Details

github.com/hauptsacheNet/typo3-mail-sender

Homepage

Source

Issues

Installs: 16

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

Type:typo3-cms-extension

pkg:composer/hn/typo3-mail-sender

dev-main 2025-12-01 12:05 UTC

Requires

Requires (Dev)

Suggests

Conflicts

GPL-2.0-or-later 59001c9d3cc11b371be1e43cf553a223126cc082

  • Marco Pfeiffer <marco.woop@hauptsache.net>

This package is auto-updated.

Last update: 2025-12-01 12:05:17 UTC

README

🚧 Work in Progress - Currently in Phase 1 development 🏆 TYPO3 Community Budget Q4 2025 Winner

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

About This Project

This extension is proudly funded by the TYPO3 Community Budget for Q4 2025. It was selected by TYPO3 members as one of four ideas to receive community funding, reflecting the strong need for better email sender configuration and validation in TYPO3.

Learn more: TYPO3 Community Budget Q4 2025 Winners

Current Features (Phase 1)

  • ✅ Manage email sender addresses in the TYPO3 backend
  • ✅ Store sender email addresses and display names
  • ✅ Database structure for validation tracking
  • ✅ System record configuration (root-level records)

Planned Features

  • 📋 Phase 2: DNS record validation (SPF, DMARC, MX)
  • 📋 Phase 2: Email deliverability checks
  • 📋 Phase 3: Integration with ext:form and other extensions
  • 📋 Phase 4: Import from existing configurations

Roadmap

Phase 1: Foundation ✅ In Progress

Goal: Basic extension structure and system integration

Features:

  • Extension scaffolding (composer.json, ext_emconf.php, TCA)
  • Database schema for sender address configuration
  • TCA configuration for backend management
  • Basic CRUD operations with functional tests
  • System record design (root-level, no translation)

Deliverable: Functional extension with sender address management in TYPO3 backend

Phase 2: Core Validation 📋 Planned

Goal: Implement email validation - the core functionality

Features:

  • SPF record validation using dns_get_record()
  • MX record verification
  • DMARC record analysis
  • Email existence checks (similar to email-checker.net)
  • Test email functionality
  • Validation result caching for performance
  • Status reporting and visual display
  • Decision on synchronous vs. asynchronous validation (with timeouts)

Deliverable: Complete email validation system with DNS checks and status reporting

Phase 3: Integration & Adoption 📋 Planned

Goal: Wide adoption through easy integration

Features:

  • Integration with ext:form (replace freetext sender with validated dropdown)
  • TCA Extra Field API for third-party extensions (similar to enableRichtext)
  • Identify and integrate with popular TYPO3 extensions
  • Comprehensive documentation for extension developers
  • Integration testing and examples

Deliverable: API and integrations enabling easy adoption by extension developers

Phase 4: Polish & Import 📋 Planned

Goal: Production-ready release with import functionality Target: December 2025

Features:

  • Import functionality:
    • From $GLOBALS['TYPO3_CONF_VARS']['MAIL']
    • From TypoScript configurations
    • From other extension databases
  • Reference tracking (show where sender addresses are used)
  • Final documentation and changelog
  • Testing, bug fixes, and polish
  • TER (TYPO3 Extension Repository) release preparation
  • TYPO3.org news article

Deliverable: Release-ready extension with full documentation

Requirements

  • TYPO3 13.4 or later
  • PHP 8.1 or later

Installation

Install via Composer:

composer require hn/typo3-mail-sender

Usage

After installation, mail sender addresses can be managed in the TYPO3 backend:

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

Record Fields

Each sender address record contains:

  • Sender Email Address: The email address to be used as sender
  • Sender Name: Display name for the sender
  • Hidden: Toggle to temporarily disable a sender address

Validation Fields (Phase 2+)

The following fields will be populated automatically by validation services in Phase 2:

  • Validation Status: Current validation state (pending, valid, invalid)
  • Last Validation Check: Timestamp of the last validation
  • Validation Result: Detailed JSON validation results

Development

Running Tests

composer test

The extension uses the TYPO3 testing framework with SQLite. Tests are automatically bootstrapped via the Build/setup-typo3.sh script.

Test Coverage

Current functional tests cover:

  • ✅ Basic CRUD operations
  • ✅ Record soft-delete
  • ✅ Record hiding/visibility
  • ✅ TCA configuration
  • ✅ Database schema

Contributing

We welcome contributions from the TYPO3 community! As a community-funded project, your input helps shape this extension.

Ways to contribute:

  • 💡 Share feedback and feature suggestions via GitHub Issues
  • 🐛 Report bugs and issues
  • 📖 Improve documentation
  • 🧪 Help with testing
  • 💻 Submit pull requests

Please check the GitHub repository for open issues and contribution guidelines.

Project Status

Current Phase: Phase 1 (Foundation) Next Milestone: Phase 2 (Core Validation) Target Release: December 2025

License

GPL-2.0-or-later

Authors

Acknowledgments

Special thanks to the TYPO3 community for selecting this project for funding and supporting open-source development in the TYPO3 ecosystem.