fooman / emailattachments-m2
fooman/emailattachments-m2
Automatically attach pdf and terms and conditions documents to outgoing sales emails.
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.
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
| 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.
| 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.
| 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.
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
| 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
| 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.
- License
- OSL-3.0
More from fooman
View vendorUse the Magento order number as the related invoice, shipment and credit memo number.
Print the order as a pdf from the admin
Print the order as a pdf from the admin
Automatically attach pdf and terms and conditions documents to outgoing sales emails.
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.