SwissUpLabs Logo

Known Issues

The items table disappears when the display of the product image or barcode enabled

It happens because of a bug in tables logic in mPDF library.

Workaround can be added in file vendor/mpdf/mpdf/src/Tag/Table.php (lines 827-850):

if (isset($c)) {
    if (!$this->mpdf->simpleTables) {
        ...
    } elseif ($this->mpdf->simpleTables) {
        ...
    }
}

Magento 2.4.4+ Compatibility

With the release of Magento 2.4.4 and 2.4.3-p2, legacy email templates support was removed. PDF templates should be re-created based on the default templates to use new correct variables. Also, it can be migrated manually, please check the guide here: Migrate custom email templates

Squares instead of text

Sometimes you can see squares in place of text in generated PDF file. It means your font is missing some font-weight or font-style used for this text.

It usually happens with Arabic fonts and product option labels that have bold italic styling:

Squares in place of text

The solution is adding the following styles to the Template Styles field:

strong, em {
    font-weight: normal !important;
    font-style: normal !important;
}

When Sales > Sales Emails > General Settings > Asynchronous sending enabled order emails are sent by cron. Download PDF link does not work in such case. We recommend using PDF attachment in such case instead of Download PDF link.

Due to a bug in Magento 2.3.4 $order variable is empty in emails. It causes missing order items in emails, please check the issue on Github.

As we use the $order variable to generate download PDF link it stopped to work too. The issue was fixed in Magento 2.3.6/2.4.0. For older versions, it can be fixed using legacy mode for email templates.

When using Email Templates module, it can be done in file Controller/Adminhtml/Template/Save.php on line 62:

--- a/Controller/Adminhtml/Template/Save.php
+++ b/Controller/Adminhtml/Template/Save.php
@@ -60,6 +60,7 @@ public function execute()
            }

            $template->addData($data);
+           $template->setIsLegacy(1);

            try {
                $template->save();

If you have previously created email templates, you will need to open and save them again after the change.

HTML and CSS support

PDF Invoices extension uses mPDF library to generate PDF files from HTML and CSS.

mPDF library has limited HTML and CSS support. Please check the following links for more information:

Edit this Page