WooCommerce PDF Invoices, Packing Slips and Credit Notes Plugin – Troubleshooting Guide

The WebToffee’s 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.

This issue can mainly occur due to the following reasons.:

Image-missing issues may arise when there is an absence of an image-processing library or when the existing library is incompatible with the uploaded image.

Solution

Make sure to use an image processing library that is compatible with the uploaded images.

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.

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

Get in touch with your server team and find a solution for unblocking the external server requests.

Insufficient permissions can hinder WordPress from reading files on the hosting server.

Solution

Ensure that WordPress has the necessary permissions to read files on the hosting server.

The plugin uses the built-in dompdf library which may not support certain images while converting HTML to PDF documents. This can cause image missing issue in PDF documents.

Solution:

Install WebToffee’s free mPDF add-on and replace the dompdf library with the Mpdf library. To do so, follow the below steps:

1. Install and activate WebToffee’s free mPDF add-on.
2. Navigate to Invoice/Packing > General Settings > Advanced.
3. Under PDF library, select Mpdf.

4. Click on Update Settings.

This issue occurs due to the limitation in the built-in dompdf library which is used for HTML to PDF conversion. The dompdf library doesn’t support RTL languages like Arabic and Hebrew.

A solution to this is to install WebToffee’s free mPDF add-on. Then enable RTL support for documents and replace the dompdf library with the mPDF library. Below is the step-by-step solution:

1. Install and activate WebToffee’s free mPDF add-on.
2. Navigate to Invoice/Packing > General Settings > Advanced.
3. Head to the Enable RTL support option and enable it by marking the checkbox next to it.
4. Under the PDF library option, select Mpdf to replace the existing library.

5. Click on Update Settings.

This issue commonly arises due to the presence of an installed firewall on your website. WordFence and Sucuri are common firewalls that can cause this issue. The firewall might be preventing the action required to save the plugin settings.

Whitelist the action that is currently preventing the settings from being saved. Admins can allow certain actions by adding them to the whitelist.

The plugin is compatible with popular translation plugins like WPML string translation, Loco Translate, etc, which are useful for translating strings within the plugin. While using the WPML string translation tool, there may be instances where certain strings within the plugin are not available for translation.

1. From the WordPress dashboard, navigate to WPML > String Translation.
2. Head to the ‘Look for strings while pages are rendered’ option and enable it by marking the checkbox.

3. Proceed to the WooCommerce Orders page (WooCommerce > Orders) and generate the invoice (if the missing strings are present in the invoice document) for an order.
4. Return to the WPML > String translation page, and you’ll see the previously missing strings are now added.
5. Now, add the translations for the newly added strings.
6. Finally, turn off the ‘Look for strings while pages are rendered’ option.

If you continue to experience difficulties, feel free to contact our support team. Provide them with the error details to receive additional help and guidance.