📄 4. Tuning Conversion Settings for Quality & Performance

See JaJuMa > WebP Image Optimization > Conversion Configuration
This is the heart of the JaJuMa WebP Optimized Images extension's configuration. Here, you will choose your preferred conversion tool and fine-tune its settings to achieve the perfect balance between image quality and file size for your store.

⚙ 4.1 Choosing Your Conversion Tool

The tool you select is the single most important factor influencing the outcome of the image conversion. The extension supports three options, each with distinct advantages.

💡 Pro Tip: We recommend using cwebp whenever possible. As Google's official tool, it offers the most advanced features and typically produces the smallest files for a given quality level. If cwebp is not available, GD is an excellent and reliable alternative that works out-of-the-box on nearly all Magento systems.

⚙ 4.2 Configuring Each Conversion Tool

Below are the specific settings for each tool, located in the Conversion Configuration section.

4.2.1 Using GD

GD is the simplest tool to configure.

1. Conversion Tool: Select "GD" from the dropdown.
2. WebP Quality: Define the compression factor, from 0 (lowest quality, smallest file) to 100 (best quality, largest file). The default of 75 is a great starting point for most use cases.

4.2.2 Using cwebp

cwebp offers the most control and two distinct modes of operation.

1. Conversion Tool: Select "Cwebp" from the dropdown.

2. Path to cwebp:

   • Leave Empty: If cwebp is installed globally on your server (as verified in the pre-flight check).

   • Use Bundled Binary: Use the path:

     # Path for manual install
     ./app/code/Jajuma/WebpImages/bin/cwebp
     
     # Path for composer install
     ./vendor/jajuma/module-webpimages/bin/cwebp

     Ensure this file is executable by your web server user.

   • Custom Path: If you have installed cwebp in a custom location, enter the full path to the executable here.
3. Conversion Parameters:
   • Base Mode (Recommended): To use this mode, simply set a value for WebP Quality and leave the "Cwebp Custom Command" field empty. This mode uses a carefully curated set of parameters based on Google's recommendations, designed to provide an excellent balance of speed, quality, and compression for a wide range of images.
   • Advanced Mode: To use this mode, leave "WebP Quality" empty and enter your own command string in the Cwebp Custom Command field. This gives you full control over all of cwebp's advanced options. For a full list of parameters, refer to the official cwebp documentation.

4.2.3 Using Imagemagick

Configuration for Imagemagick is similar to cwebp.

1. Conversion Tool: Select "Imagemagick" from the dropdown.
2. Path to Imagemagick:
   • Leave Empty: If Imagemagick is available globally via the convert command.
   • Custom Path: If your server uses a custom command or path (e.g., /usr/local/bin/convert), enter it here.
3. Conversion Parameters:
   • Base Mode (Recommended): Set a value for WebP Quality and leave the "Imagemagick Custom Command" field empty.
   • Advanced Mode: Leave "WebP Quality" empty and provide a full command string in the Imagemagick Custom Command field. For a full list of parameters, see the official Imagemagick WebP documentation.

⚙ 4.2.4 Test & Preview Your Settings

After configuring your chosen tool, it is crucial to test the results. The built-in test tool provides a visual feedback loop, allowing you to fine-tune your settings with confidence. Play with different quality settings, finding the right balance is key to achieving the performance benefits offered by our WebP Optimized Images solution.

1. Input Product ID: In the "Test & Preview Conversion" section, enter the ID (not the SKU) of a product with a representative image.
2. Click "Test Conversion Tool": A popup window will appear.
   • Success: You will see a side-by-side comparison of the original image and the newly created WebP version. Use the slider to compare details and ensure you are happy with the quality/compression trade-off.
   • Fail: If the conversion fails, the popup will display an error message with hints to help you troubleshoot the issue, such as an incorrect path or a permissions problem.

📞 Need Help?

Having trouble with the setup? Check our Troubleshooting, FAQ & Best Practices for common solutions.

Still have questions or need help verifying your system requirements? Our expert team is here to assist. Please don't hesitate to contact our support team for personalized assistance.