WEBP JPEG Fallback

Contributors: skylarktech, Andrzej Skowron Tags: webp, jpeg, fallback, images, conversion, media, compatibility Requires: WordPress 5.0+, PHP 7.4+ Tested up to: WordPress 6.4 Version: 1.0.0

Automatically generates JPEG fallback copies when WEBP images are uploaded to ensure broader browser compatibility.

Description

WEBP JPEG Fallback is a WordPress plugin that addresses the reverse scenario of typical WEBP conversion plugins. Instead of converting JPEG to WEBP, this plugin automatically creates JPEG fallback copies when WEBP images are uploaded to your media library.

This ensures broader browser compatibility while maintaining the benefits of WEBP format for supported browsers. The plugin preserves your original WEBP files and creates additional JPEG versions for maximum compatibility.

Key Features

• Automatic Conversion: Automatically creates JPEG fallbacks when WEBP images are uploaded
• Configurable Quality: Adjustable JPEG quality settings (1-100) with slider interface
• File Size Limits: Configurable maximum file size limits to prevent server overload
• Processing Timeout Protection: Prevents server timeouts with configurable processing limits
• Server Status Display: Shows current server capabilities and WEBP support status
• Media Library Integration: Displays fallback status directly in the media library
• Bulk Actions: Create or delete JPEG fallbacks for existing WEBP files
• Error Logging: Optional error logging for debugging and troubleshooting
• Security Features: Comprehensive input validation and nonce verification

How It Works

1. Upload a WEBP image to your WordPress media library
2. The plugin automatically detects the WEBP upload
3. A JPEG fallback is created with your specified quality settings
4. Both files are stored in your media library
5. The original WEBP file is preserved for optimal performance

Server Requirements

• PHP GD extension with WEBP support
• PHP 7.4 or higher
• WordPress 5.0 or higher

The plugin will check your server capabilities on activation and display warnings if requirements are not met.

Use Cases

• Theme Developers: Ensure your themes work with WEBP images across all browsers
• Content Creators: Upload WEBP images without worrying about compatibility
• Performance Optimization: Maintain WEBP benefits while ensuring fallback support
• Legacy Browser Support: Provide JPEG alternatives for older browsers

Installation

Manual Installation

1. Download the plugin ZIP file from Releases
2. Upload the ZIP file through Plugins > Add New > Upload Plugin
3. Activate the plugin through the Plugins menu

Server Requirements Check

After activation, the plugin will automatically check if your server supports WEBP processing. If requirements are not met, you'll see an admin notice with instructions.

Configuration

Navigate to Settings > WEBP JPEG Fallback to configure the plugin:

Conversion Settings

• Enable Conversion: Toggle automatic WEBP to JPEG conversion
• JPEG Quality: Set the quality level for generated JPEG files (1-100)
• Maximum File Size: Set the maximum file size limit for conversion (MB)
• Processing Timeout: Configure the maximum processing time per file (seconds)

Advanced Settings

• Preserve Metadata: Attempt to preserve EXIF and other metadata
• Enable Error Logging: Log conversion results for debugging

Server Status

View your server's current capabilities:

• GD Extension status
• WEBP Support availability
• Required functions availability
• Overall readiness status

Frequently Asked Questions

Does this plugin convert existing WEBP files?

The plugin automatically converts new WEBP uploads. For existing WEBP files, you can use the bulk actions in the media library to create JPEG fallbacks.

Will this plugin slow down my uploads?

The plugin adds minimal processing time during upload. You can configure file size limits and processing timeouts to prevent any performance issues.

What happens if my server doesn't support WEBP?

The plugin will detect this during activation and show an error message. You'll need to contact your hosting provider to enable GD extension with WEBP support.

Can I adjust the JPEG quality?

Yes, you can set the JPEG quality from 1-100 in the plugin settings. Higher values produce better quality but larger file sizes.

Are the original WEBP files preserved?

Yes, the plugin preserves your original WEBP files and creates additional JPEG copies. You can delete the JPEG fallbacks at any time.

How do I know if a WEBP file has a JPEG fallback?

The media library includes a "JPEG Fallback" column that shows the status of each WEBP file with visual indicators.

Can I disable the conversion temporarily?

Yes, you can disable conversion in the plugin settings without deactivating the plugin. This stops new conversions but preserves existing fallbacks.

What file naming convention is used?

JPEG fallbacks are named with "-fallback" suffix. For example: image.webp becomes image-fallback.jpg

Screenshots

1. Plugin settings page with quality slider and server status
2. Media library showing JPEG fallback status column
3. Bulk actions for creating/deleting JPEG fallbacks
4. Server status display showing capabilities

Changelog

1.0.0

• Initial release
• Automatic WEBP to JPEG conversion on upload
• Configurable quality settings with slider interface
• File size limits and processing timeout protection
• Media library integration with status indicators
• Bulk actions for existing WEBP files
• Comprehensive error logging and validation
• Server capability checking and status display
• WordPress.org compliance and security features

Support Development

If this plugin has been helpful for your website, consider supporting its development!

License

This plugin is released under a custom license. See the plugin files for more details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Support

For support and feature requests, please visit the GitHub repository or contact through the WordPress.org support forums.