fooman / emailattachments-m2

fooman/emailattachments-m2

Automatically attach pdf and terms and conditions documents to outgoing sales emails.

metapackage Compatibility: Not yet tested Code Quality: Fail Tests: N/A Security: Pass OSL-3.0

Are you the maintainer of fooman?

Packagento pulls fooman's Composer packages from the public registry so buyers can find them here.

Claim the namespace to take ownership, publish new releases directly, and start charging for premium versions.

Claim this namespace →

Fooman Email Attachments

Extension for Magento 2

A User Manual can be found here

Installation

This package is available via packagist.org. Please use Composer to install the extension

bin/magento deploy:mode:set developer (if you are in production mode)
composer require fooman/emailattachments-m2:^3.0
bin/magento module:enable --clear-static-content Fooman_EmailAttachments
bin/magento setup:upgrade

your usual sequence of commands to enable production mode, for example
bin/magento deploy:mode:set production

Depending on Email Attachments

If you are using Email Attachments to build functionality on top of please require the implementation package
composer require fooman/emailattachments-implementation-m2 instead as only that package will be semantically versioned.

Change Log

[3.7.0] - 2026-04-20

Added

  • Support for Magento 2.4.9
  • Support for Php 8.5

Changed

  • Lowest supported versions are now Magento 2.4.4-p13 and php 8.1 - use previous versions for older Magento versions

[3.6.1] - 2025-04-10

Fixed

  • Rework extension to also support Symfony Mailer

[3.6.0] - 2025-04-08

Added

  • Support for Magento 2.4.8
  • Support for Php 8.4

[3.5.0] - 2024-03-26

Added

  • Support for Php 8.3

Changed

  • Code style updates for newer Magento Coding Standard

[3.4.0] - 2023-03-06

Added

  • Support for Php 8.2
  • Support for Magento 2.4.6

[3.3.11] - 2022-08-03

Added

  • Support for Magento 2.4.5

[3.3.10] - 2022-03-29

Added

  • Support for Magento 2.4.4
  • Support for Php 8.0/8.1

[3.3.9] - 2021-09-08

Changed

  • Switch to Laminas Mime package, minimum Magento version is now 2.3.5

Fixed

  • Don't send the same named attachment twice

[3.3.8] - 2021-07-30

Added

  • Support for Magento 2.4.3

[3.3.7] - 2021-04-30

Added

  • Support for Magento 2.3.7

[3.3.6] - 2021-02-02

Added

  • Support for Magento 2.4.2

[3.3.5] - 2020-10-02

Added

  • Support for Magento 2.3.6 and 2.4.1

[3.3.4] - 2020-07-28

Added

  • Support for PHP 7.4
  • Support for Magento 2.4.0

Fixed

  • Mislabeled admin setting

[3.3.3] - 2020-05-02

Fixed

  • Reworked email identification to strictly cover supported types only

[3.3.2] - 2020-04-22

Added

  • Support for Magento 2.3.5

[3.3.1] - 2020-01-24

Added

  • Support for Magento 2.3.4

[3.3.0] - 2020-01-21

Added

  • Ability to attach invoices to the shipping confirmation email

Changed

  • Updated comments for latest Magento Coding Standards

[3.2.0] - 2019-10-05

Changed

  • Refactor for new email handling in Magento 2.3.3
  • Use previous releases for earlier versions of Magento
  • Removed support for Php 7.0

[3.1.9] - 2019-10-03

Added

  • Support for Magento 2.3.2-p1

[3.1.8] - 2019-08-16

Changed

  • Adjust for changed core behaviour around plain text emails

[3.1.7] - 2019-06-26

Added

  • Support for Magento 2.3.2 and 2.2.9

[3.1.6] - 2019-05-10

Changed

  • Adopt latest Magento Coding Standards

[3.1.5] - 2019-04-11

Fixed

  • Reverse additional return types

[3.1.4] - 2019-04-09

Fixed

  • Reverse adding return types to maintain 2.2.8 compatibility

[3.1.3] - 2019-03-28

Added

  • Compatibility with Magento 2.2.8

[3.1.2] - 2019-03-27

Added

  • Compatibility with Magento 2.3.1
  • Initial MFTF acceptance test

[3.1.1] - 2019-01-04

Added

  • Readme

Changed

  • Reverse 7.1 features as Magento Marketplace does not yet support it

[3.1.0] - 2018-11-28

Changed

  • Add compatibility with Magento 2.3.0 and handle upgrade of Zend_Mail, for earlier versions of Magento use
    previous versions
  • Use newer php features (minimum 7.1)

Added

  • Ability to customise affect the final filename

[3.0.4] - 2018-11-06

Changed

  • Reorganised unit tests

[3.0.3] - 2018-07-20

Changed

  • Code Quality improvement - use class constants

Fixed

  • Failing integration test for replaced pdfs

[3.0.2] - 2018-06-25

Changed

  • Major rewrite - removed all preferences, use plugins on TransportBuilder and TransportFactory instead

[3.0.1] - 2018-03-20

Changed

  • Adjusted tests to provide for Pdf Customiser transforming T&Cs to Pdfs

[3.0.0] - 2018-03-16

Changed

  • Package changed into a Metapackage - Implementation moved into fooman/emailattachments-implementation-m2 package
  • Semantic versioning will only be applied to the implementation package
  • Attachments are also added to emails sent separately

[2.1.0] - 2017-09-01

Added

  • Support for PHP 7.1
  • Support for Magento 2.2.0

[2.0.8] - 2017-06-02

Fixed

  • Make CheckoutAgreements dependency explicit

[2.0.7] - 2017-02-28

Added

  • Ability for integration test to check for attachment name

[2.0.6] - 2017-02-26

Fixed

  • Translations of file names (thanks Manuel)

[2.0.5] - 2016-09-22

Added

  • Add note to "Attach Order as Pdf" that it requires the Print Order Pdf extension

[2.0.4] - 2016-06-15

Changed

  • Widen dependencies in preparation for Magento 2.1.0

[2.0.3] - 2016-04-03

Fixed

  • Add missing configuration setting for attaching T&Cs to shipping email

[2.0.2] - 2016-04-01

Changed

  • Release for Marketplace

[2.0.1] - 2016-03-25

Added

  • Integration tests now support Pdf Customiser supplied attachments

[2.0.0] - 2016-01-21

Changed

  • Change project folder structure to src/ and tests/ (not applicable for Marketplace version)

[1.0.0] - 2015-11-29

Added

  • Initial release for Magento 2
Versions
Version Stability QA Status Compatibility Released
3.7.0 stable Fail Not yet tested Details 2026-04-20 05:03:04
3.6.1 stable Not tested Not yet tested Details 2025-04-10 05:33:21
3.6.0 stable Not tested Not yet tested Details 2025-04-08 01:41:53
3.5.0 stable Not tested Not yet tested Details 2024-03-26 05:22:35
3.4.0 stable Not tested Not yet tested Details 2023-03-06 08:10:45
3.3.11 stable Not tested Not yet tested Details 2022-08-03 11:47:55
3.3.10 stable Not tested Not yet tested Details 2022-03-29 21:55:17
3.3.9 stable Not tested Not yet tested Details 2021-09-08 02:17:55
3.3.8 stable Not tested Not yet tested Details 2021-07-30 00:40:48
3.3.7 stable Not tested Not yet tested Details 2021-04-30 11:06:06
3.3.6 stable Not tested Not yet tested Details 2021-02-02 09:53:14
3.3.5 stable Not tested Not yet tested Details 2020-10-02 04:26:28
3.3.4 stable Not tested Not yet tested Details 2020-07-28 22:57:39
3.3.3 stable Not tested Not yet tested Details 2020-05-02 02:49:01
3.3.2 stable Not tested Not yet tested Details 2020-04-22 00:36:53
3.1.11 stable Not tested Not yet tested Details 2020-01-25 10:34:11
3.3.1 stable Not tested Not yet tested Details 2020-01-24 22:11:11
3.3.0 stable Not tested Not yet tested Details 2020-01-21 11:38:11
3.1.10 stable Not tested Not yet tested Details 2019-10-08 21:44:21
3.2.0 stable Not tested Not yet tested Details 2019-10-05 02:17:03
3.1.9 stable Not tested Not yet tested Details 2019-10-03 11:23:46
3.1.8 stable Not tested Not yet tested Details 2019-08-16 02:15:19
3.1.7 stable Not tested Not yet tested Details 2019-06-26 06:32:43
3.1.6 stable Not tested Not yet tested Details 2019-05-10 03:28:16
3.1.5 stable Not tested Not yet tested Details 2019-04-11 03:54:06
3.1.4 stable Not tested Not yet tested Details 2019-04-09 23:44:33
3.1.3 stable Not tested Not yet tested Details 2019-03-28 04:05:15
3.1.2 stable Not tested Not yet tested Details 2019-03-27 05:51:53
3.1.1 stable Not tested Not yet tested Details 2019-01-04 00:54:01
3.1.0 stable Not tested Not yet tested Details 2018-11-28 06:12:55
3.0.4 stable Not tested Not yet tested Details 2018-11-06 01:55:03
3.0.3 stable Not tested Not yet tested Details 2018-07-20 10:28:45
3.0.2 stable Not tested Not yet tested Details 2018-06-25 07:03:45
3.0.1 stable Not tested Not yet tested Details 2018-03-20 22:57:01
3.0.0 stable Not tested Not yet tested Details 2018-03-16 01:29:21
2.1.0 stable Not tested Not yet tested Details 2017-09-01 01:12:01
2.0.8 stable Not tested Not yet tested Details 2017-06-02 10:08:42
2.0.7 stable Not tested Not yet tested Details 2017-02-28 03:15:02
2.0.6 stable Not tested Not yet tested Details 2017-02-26 22:32:20
2.0.5 stable Not tested Not yet tested Details 2016-09-22 03:31:24
2.0.4 stable Not tested Not yet tested Details 2016-06-15 07:30:26
2.0.3 stable Not tested Not yet tested Details 2016-04-03 02:23:34
2.0.2 stable Not tested Not yet tested Details 2016-04-01 04:17:52
2.0.1 stable Not tested Not yet tested Details 2016-03-25 06:31:04
2.0.0 stable Not tested Not yet tested Details 2016-01-21 01:47:01

Requires 3

Package Constraint
php ~8.1.0||~8.2.0||~8.3.0||~8.4.0||~8.5.0
magento/framework >=103.0.4-p13 < 103.0.10
fooman/emailattachments-implementation-m2 107.6.0

Suggests 2

Package Reason
fooman/printorderpdf-m2 Allows attaching the order confirmation pdf to the order confirmation email
fooman/pdfcustomiser-m2 Allows to easily customise the sales pdfs while also reducing file sizes

Compatibility

Each Magento release line is installed on its supported PHP versions, then the module is built (DI compilation + static-content deploy) and its unit and integration suites are run. The matrix shows the lines and PHP versions the module is confirmed to install and run on. Code-quality results further down (phpstan, phpcs, …) are reported separately and never affect compatibility.

Compatibility matrix (Magento × PHP)
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 not tested not tested
2.4.8 not tested not tested
2.4.9 not tested not tested

Code Quality

Advisory checks against the module's source. Static analysis runs once across the whole module; PHPStan re-runs per Magento + PHP version because resolvable symbols differ between releases. These NEVER affect the Compatibility badge. A phpcs finding can't make a module incompatible.

Static analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

Static analysis results
Tool Status Findings Summary
PHPCS N/A 0 metapackage ships no source of its own — phpcs skipped (#122)
PHPMD N/A 0 metapackage ships no source of its own — phpmd skipped (#122)
Cpd N/A 0 metapackage ships no source of its own — cpd skipped (#122)
PHP Compatibility N/A 0 metapackage ships no source of its own — php-compatibility skipped (#122)
Composer validate Info 2 valid; 2 advisory notes (composer validate --strict)

PHPStan

Type-checks the module's PHP against a real Magento install at the configured gate level. Re-runs per Magento and PHP version because resolvable symbols differ between releases.

PHPStan results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 4 4
2.4.8 2 2
2.4.9 2 2

Tests

Unit and integration suites, run for each applicable Magento and PHP version. A test failure speaks to the module's behaviour, not its compatibility with a Magento line, so it is reported here separately and never reddens the compatibility matrix.

Unit tests

Unit tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Integration tests

Integration tests results by Magento and PHP version
Magento PHP 8.2 PHP 8.3 PHP 8.4 PHP 8.5
2.4.7 N/A N/A
2.4.8 N/A N/A
2.4.9 N/A N/A

Security

Security checks run directly against the module: an audit of its declared dependencies for known vulnerabilities (composer audit) and a scan of its source for malware and web-shell signatures. Each runs once. A malware detection fails the version outright.

Security results
Tool Status Findings Summary
Composer audit Pass 0
Malware scan N/A 0 metapackage ships no source of its own — malware scan skipped (#122)
License
OSL-3.0

More from fooman

View vendor
Make it pay

Turn an existing module into recurring revenue.

If you already maintain a Magento 2 module on GitHub or GitLab, listing it on Packagento takes about five minutes. We mirror your tags, handle distribution signing, and route paid licenses through Stripe Connect, so you can keep shipping the way you already do.