The WebToffee WooCommerce PDF Invoices, Packing Slips, and Credit Notes plugin is a one-stop solution to customize, auto-generate, and print WooCommerce PDF invoices, packing slips, and credit notes. However, even the most reliable tools can face occasional hiccups. This troubleshooting guide will provide you with the common problems faced while using the plugin and their solutions.
1. Missing or corrupted images in PDF documents
This issue mainly occurs due to the following reasons:
1. Lack of an image processing library
If an image processing library is absent or incompatible with the uploaded image, it may result in missing or corrupted images in the PDF.
Solution
Make sure to use an image processing library that is compatible with the uploaded images.
2. Image size
Uploading images that exceed the server capacity can lead to image-missing issues.
Solution
Make sure to upload images that fit within the server’s capacity.
3. Server request restrictions
When your site’s images are hosted on an external server, there is a possibility that the server may block requests from external servers.
Solution
Contact your server team to identify and resolve any restrictions blocking external server requests.
4. Permission issues
Insufficient file permissions can prevent WordPress from accessing and displaying images stored on the hosting server, leading to missing or corrupted images in PDFs.
Solution
Ensure that WordPress has the required file permissions to read and process images on the hosting server.
5. Issue with the dompdf library
The plugin uses the built-in Dompdf library, which may not support certain image formats when converting HTML to PDF. This can result in missing images in the generated PDF documents.
Solution
Replace the Dompdf library with the Mpdf library using WebToffee’s free mPDF add-on. Follow these steps:
- Install and activate WebToffee’s free mPDF add-on.
- Navigate to Invoice/Packing > General Settings > Advanced.
- Under PDF library, select Mpdf.
- Click on Update Settings.
To learn more, check out the following article: Fix Image/Logo Missing Issues.
2. Missing language and RTL support issues in PDF documents
The built-in Dompdf library struggles to handle certain languages, particularly RTL (Right-to-Left) languages like Arabic and Hebrew, which can cause text to appear incorrectly in PDF documents.
Solution
To resolve this issue, install WebToffee’s free mPDF add-on, enable RTL support, and replace the Dompdf library with mPDF. Follow these steps:
- Install and activate WebToffee’s free mPDF add-on.
- Navigate to Invoice/Packing > General Settings > Advanced.
- Enable RTL support for documents.
- Under the PDF library option, select Mpdf.
- Click on Update Settings.
To learn more, check out the following article: Fix Language Missing Issue.
3. Unable to save settings
This issue often occurs due to a firewall installed on your website. Firewalls like WordFence and Sucuri may block the actions required to save the plugin settings, preventing changes from being applied.
Workaround
Whitelist the blocked action to allow settings to be saved. Admins can allow certain actions by adding them to the whitelist.
4. Missing string translations
The plugin supports popular translation tools like WPML String Translation and Loco Translate, which help translate strings within the plugin. However, when using WPML String Translation, some strings may not appear for translation.
Solution
To make the missing strings available for translation in WPML, follow these steps:
- From the WordPress dashboard, navigate to WPML > String Translation.
- Enable the ‘Look for strings while pages are rendered’ option.
- Navigate to WooCommerce > Orders and generate an invoice (if the missing strings are in the invoice document).
- Return to WPML > String Translation, where the previously missing strings will now appear.
- Add translations for the newly detected strings.
- Finally, disable the ‘Look for strings while pages are rendered’ option.
Is your issue not on the list?
If you’re still facing difficulties, contact our support team for further assistance. Provide them with the error details to receive additional help and guidance.
waseem
May 30, 2024
i try the add on rtl pluginn and i try all the ways ,, the pdf still same !! what i can do
Sanjai Valsan
June 4, 2024
Hi Waseem,
Thank you for reaching out!
It sounds like you’ve tried the mPDF add-on plugin and various methods, but the PDF issue persists. Technical assistance may be required to resolve this. Kindly contact our customer support team for further assistance.
Susie
February 28, 2024
When I receive an order notification and a copy of the pdf packing list I have noticed that the date and invoice number do not show. The files is there but no narrative. Only when I go to download the invoice does it appear in the download copy of the packing list. How do I resolve this please?
Sanjai Valsan
March 20, 2024
Hi Susie,
Thank you for reaching out!
From the information provided, it seems like you need some technical assistance to resolve the issue. Kindly contact our customer support team; they’ll be happy to assist you.
Xenofon
December 22, 2023
Hello,
I cannot find how to add custom Attribute in Woocommerce, in a way that Webtoffee Import/Export will display them when I reach step 3>Attributes dropdown menu.
In other words, how do I add/remove/edit attributes fields from Webtoffee Import/Export?
E.g. I want to remove attribute:pa_brand . Or add a custom one: attribute:pa_carats
Thank you!
Vineetha
December 28, 2023
Hi Xenofon,
If you have an attribute assigned to a product on your site, you can find that in your mapping screen attribute drop-down while exporting. You can check all the necessary attributes and uncheck all the unnecessary attributes in this screen for export. Regarding import, if your import file has the attribute header in the format supported by our plugin, it will be automatically mapped in Step 3.
For more details please refer this article.
To remove an attribute, you can make that particular column value empty (please note that you need to keep the header) and reimport the product by enabling the option Update even if empty values.
Please note that you need to import CSV with data in all other fields expect the one you need to delete.