WebP Converter

Version: 1.4


Step 1: Purchase the Extension

  • Purchase the WebP Converter Plugin from the Joomla store.

Step 2: Check Your Email

  • You will receive an email with a download link for the extension.

Step 3: Create an Account (Optional)

  • Alternatively, create an account in the Joomla store using the same email address used for the purchase (not the PayPal address).
  • Log in to your account.

Step 4: Navigate to Downloads Section

  • Go to the downloads section of the store.
  • Find the option to download the WebP Converter Plugin.
  • Note: You can also find the license key here, which is needed for future updates.

Step 5: Download the Extension

  • Click on the download link to get the file named WebPConverter_UNZIP.zip.

Step 6: Unzip the Package

  • Use an Unzipper or unarchive software to unzip the package.
  • The package contains two files:
    1. The installable plugin file - plg_webpconverter.zip
    2. The ReadMe.txt file with version information.

Step 7: Update the Extension (if applicable)

  • If you have an active license, you can update the extension directly from the Joomla update manager.

Now, you have successfully downloaded and unzipped the WebP Converter Plugin for Joomla, and you can proceed with the installation and configuration as per your needs.


Step 1: Log in to Joomla Admin Panel

  • Log in to your Joomla 4 website's administrator panel using your credentials.

Step 2: Navigate to Extensions Manager

  • From the main menu, select System > Extensions > Manage > Install.

Step 3: Choose the Installation Method

  • You will see several options for installing extensions. Choose the "Upload Package File" method.

Step 4: Upload the Plugin File

  • Click the Choose File button or drag and drop the plg_webpconverter.zip file into the designated area.
  • Click the Upload & Install button.

Step 5: Verify Installation

  • Once the installation is complete, you should see a success message confirming the installation.
  • You can verify the installation by going to Extensions > Plugins and searching for "WebP Converter."

Step 6: Enable the Plugin

  • Find the WebP Converter Plugin in the list and click on the red "X" or the status icon to enable it.
  • Configure the plugin settings as needed by clicking on the plugin's name.

Step 7: Test the Plugin (Optional)

  • You may want to test the plugin on your site to ensure it's working as expected.

How it works

Before setting up the plugin lets understand how exactly the plugin works.

  1. Image Tag Search: When enabled, the plugin searches for <img src=""/> tags within the web pages that are loaded.
  2. Image Conversion: It identifies images from the path and converts formats like jpg, png, or gif into the webp format.
  3. Replacement, Not Regeneration: The plugin replaces the images with their webp versions but doesn't generate the webp images every time the page is loaded. The webp images just gets created once.
  4. Local Images Only: The plugin works for images hosted within the Joomla installation folder. It will not replace images loaded from other sites.

Additional Options

  1. Bluk Folder Conversion: The plugin allows you to select a specific folder (e.g., the default Joomla Images Folder) to convert all the images inside the folder to webp format.
  2. Manual Replacement: After generating the webp images, you can manually replace the path/URL of images on your website.
  3. Handling Non-Standard Image Displays: Some modules, plugins or components may not use the standard <img src=""> tag to display images. In these cases, you can replace the generated images directly.


Configuration Guide

After installation, you can configure the plugin by navigating to Extensions > Plugins and searching for "WebP Converter." Click on the plugin name to access the settings.

General Settings

WebP Quality

Set the quality for WebP images. This slider allows you to choose the desired quality level for the converted images, ranging from 0 to 100. Higher quality may result in larger file sizes.

Debug Mode

 When enabled, the debug mode displays a detailed table on the frontend. This table includes information about each processed image, such as the original and WebP image paths, their respective file sizes, the amount of data saved through conversion, and the percentage of compression achieved. Note that the debug mode is designed for development and testing purposes, and it should be turned off in a production environment to maintain optimal site performance and user experience.

Exclusion Settings

Disable for Menu Items

Select specific menu items where the WebP conversion should be disabled. Menu names are displayed in bold, and you can select individual menu items using checkboxes.

Disable for Components

Select specific frontend components where the WebP conversion should be disabled. You can choose multiple components from the dropdown list.

Disable for URLs

Enter URLs where the WebP conversion should be disabled, one per line. This allows you to exclude specific pages from conversion.

Exclude Images

Enter image names to exclude from WebP conversion, one per line. This allows you to exclude specific images from conversion.

Manage Settings

Select Folder

Choose a folder within your site to generate WebP images. This allows you to target specific directories for conversion.

Generate WebP Images

Click this button to generate WebP images for the selected folder. This initiates the conversion process for the chosen directory.

Delete Generated WebP Images

Click this button to delete all generated WebP images created by this plugin. This allows you to revert all conversions and remove the WebP files.


1. How Do I Select Specific Folders for WebP Conversion?

In the "Manage Settings" section of the plugin configuration, you'll find an option called "Select Folder." Use the dropdown menu to choose a specific folder within your site where you want to generate WebP images. This allows you to target specific directories for conversion.

2. Can I Exclude Certain Images or URLs from Conversion?

Yes, you can! In the "Exclusion Settings" section, you have options to exclude specific images, URLs, menu items, or components from WebP conversion. Simply enter the image names or URLs you want to exclude, or select the menu items or components from the provided lists.

3. What Quality Should I Set for WebP Images?

The "WebP Quality" setting in the "General Settings" section allows you to choose the desired quality level for the converted images, ranging from 70 to 90. A higher quality setting may result in larger file sizes but better visual quality. You can experiment with this setting to find the optimal balance for your site.

4. How Do I Delete Generated WebP Images?

If you need to delete all generated WebP images created by the plugin, go to the "Manage Settings" section and click the "Delete Generated WebP Images" button. This will revert all conversions and remove the WebP files, allowing you to start fresh or disable the plugin without leaving behind unnecessary files.

5. I've Installed the Plugin, but It's Not Working. What Should I Do?

First, ensure that the plugin is enabled by going to Extensions > Plugins and checking the status of the "WebP Converter" plugin. If it's still not working, double-check your configuration settings to ensure they are set up correctly. If you continue to experience issues, consult the plugin's official documentation or contact the support team for assistance.