Troubleshooting Logo Issues

Table of Contents

Compatible image formats #

  • An important test involves changing the logo’s source to a different file that has a different file type (or file extension), in order to see if your server lacks support for a particular file type.
  • Some plugins may convert your images into an incompatible file type. These plugins should therefore be temporarily disabled or their conversion options must be changed.

JPEG #

  • These tend to be easier to handle. If you have issues with this filetype specifically, check that you do not have a plugin or service that modifies your images.
  • Some older systems or applications may not recognize JPEG as a file format leading to potential compatibility issues. On such an older system, changing a JPEG to a JPG image may lead to success.

JPG #

As this file type (or image format) is light and compatible on many platforms, these tend to be the easiest to handle. If you have issues with this filetype specifically, check that you do not have a plugin or service that modifies your images.

PNG #

If you are having issues with PNG images specifically for example, you may need to check the versions of these extensions:

  • GMagick is a php extension to create, modify and obtain meta information of images using the GraphicsMagick API.
    Install GMagick
  • Imagick is a native php extension to create and modify images using the ImageMagick API. This extension requires ImageMagick version 6.5.3-10+ and PHP 5.4.0+.
    Install IMagick

WebP #

  • Safari on iOS 14.4 and higher now has full support.

AVIF #

Native AVIF support requires installing the mPDF extension.

If mPDF is not being used, AVIF images may have mixed or unexpected results.

Temporarily disable any CDN #

You may be using a CDN (content delivery network) in order to have access to images. There are various ways to temporarily disable this, depending on your website host. Please contact them for assistance.

Alternatively, you may give this code snippet a try.

add_filter( 'wpo_wcpdf_use_path', '__return_false' );

If you haven’t worked with code snippets (actions/filters) or functions.php before, read this guide: How to use code snippets.

We also have a blog post here that you may find helpful about adding custom code to your site.

Check server requirements #

Path: WooCommerce > PDF Invoices > Advanced > Status > System Configuration.

The table that appears indicates red items as missing required items from your server, for proper functioning of our plugin.

Check our article for more: All server requirements

Deactivate plugins, code snippets and custom integrations #

Temporarily deactivate any plugins, code snippets that target images or any custom integrations in order to see if there is a difference.

Translation plugins like WPML, Polylang, TranslatePress, could be a possible culprit, as we have media translation as a compatible feature. Temporarily deactivating them in order to observe the logo/image is a test that should be performed.

Check woocommerce error logs #

Path: WooCommerce >Status > Logs.

Check the WooCommerce logs to see if there are errors with the wpo-wcpdf or fatal-errors that may mention any useful information.

Test without cache #

Disable any caching plugin or plugin that may implement cache for a feature, in order to eliminate caching as the culprit. Some of these plugins may contain an option to disable cache.

After successfully disabling or deleting the cache, other troubleshooting steps should be repeated.

What are your Feelings