Documentation

Installation

Step 1: Purchase and Download

1. Purchase a license from our website
2. Download the plugin ZIP file
3. You’ll receive your license key via email

Step 2: Install the Plugin

1. Log in to your WordPress admin
2. Navigate to Plugins → Add New
3. Click Upload Plugin
4. Choose the downloaded ZIP file
5. Click Install Now
6. Click Activate Plugin

Step 3: Activate Your License

1. Navigate to Tools → WebP Converter
2. Enter your license key
3. Click Activate License
4. Your license will be validated automatically

Getting Started

First-Time Setup

1. Go to Tools → WebP Converter
2. Review the default settings:

• Quality: 80 (recommended starting point)
• Delete Originals: Unchecked (keep originals initially)

1. Click Convert Images to WebP Now
2. Wait for the conversion to complete
3. Review the summary report

Recommended Settings

For Best Quality:

• Quality: 85-95
• Keep original files: Yes

For Maximum Compression:

• Quality: 60-75
• Keep original files: No (after testing)

For Balanced Results:

• Quality: 80
• Keep original files: Yes (initially)

Usage Guide

Converting Existing Images

1. Navigate to Tools → WebP Converter
2. Set your desired quality (10-100)
3. Choose whether to delete original files
4. Click Convert Images to WebP Now
5. Monitor progress in the browser
6. Review the conversion summary

Automatic Conversion

New images uploaded to your Media Library are automatically converted using your saved settings:

1. Upload an image through WordPress Media Library
2. The plugin automatically converts it to WebP
3. The WebP version is used throughout your site
4. Original file is kept or deleted based on your settings

Quality Settings Explained

• 10-30: Maximum compression, lower quality (not recommended)
• 40-60: High compression, acceptable quality for thumbnails
• 70-85: Balanced compression and quality (recommended)
• 86-100: Higher quality, less compression (best for photos)

Managing Converted Images

• View Conversion Status: Check the Media Library for WebP indicators
• Revert Conversion: If you kept originals, you can restore them
• Re-convert: Run the converter again with different settings

Troubleshooting

Images Not Converting

Problem: Conversion fails or images are skipped

Solutions:

• Check that your server has GD or Imagick installed
• Verify WebP support is enabled (contact your host)
• Check file permissions on uploads directory
• Review error messages in the conversion summary

Quality Issues

Problem: Converted images look poor quality

Solutions:

• Increase quality setting (try 85-90)
• Keep original files enabled
• Test with a few images first
• Check your server’s image processing capabilities

Missing Images

Problem: Images not displaying after conversion

Solutions:

• Check that database updates completed
• Verify file permissions
• Clear your browser cache
• Check if original files were accidentally deleted

License Activation Issues

Problem: License key won’t activate

Solutions:

• Verify you’re using the correct license key
• Check your internet connection
• Ensure your site can reach our license server
• Contact support if issues persist

Advanced Usage

Custom Quality Per Image Type

While the plugin uses global settings, you can:

1. Convert images in batches with different quality settings
2. Use the “Skip already converted” option
3. Re-convert specific images by deleting their WebP versions

Integration with Other Plugins

The plugin works with:

• Image optimization plugins: Use WebP Converter first, then optimize
• CDN services: WebP files work with all major CDNs
• Caching plugins: Clear cache after conversion for best results

Performance Tips

1. Convert during off-peak hours for large Media Libraries
2. Start with higher quality and reduce if needed
3. Keep originals initially until you’re satisfied
4. Test on staging site before production conversion
5. Monitor server resources during batch conversion

Support

Getting Help

• Email Support: support@ebtech.com
• Documentation: This page
• License Holders: Priority support available

Before Contacting Support

Please provide:

• WordPress version
• PHP version
• Plugin version
• Error messages (if any)
• Steps to reproduce the issue

FAQ

Q: Can I convert images back to original format?
A: Only if you kept the original files. Otherwise, conversion is permanent.

Q: Will this slow down my site?
A: No, WebP images actually speed up your site due to smaller file sizes.

Q: Do all browsers support WebP?
A: Modern browsers support WebP. The plugin handles fallbacks automatically.

Q: Can I use this with WooCommerce?
A: Yes, the plugin works with all WordPress plugins including WooCommerce.

Q: How often should I run the converter?
A: Only once for existing images. New uploads convert automatically.

Changelog

Version 1.0.0

• Initial release
• Batch conversion functionality
• Automatic new upload conversion
• Quality control settings
• Database URL updates
• License management

License Terms

• Single Site License: Use on 1 WordPress site
• Multi-Site License: Use on up to 5 WordPress sites
• Developer License: Unlimited sites, commercial distribution allowed
• All licenses include 1 year of updates and support