=== WorkflowDone - WebP Converter ===
Contributors:      workflowdone
Tags:              webp, webp convert, image optimization, performance, convert
Requires at least: 6.0
Tested up to:      7.0.2
Requires PHP:      7.4
Stable tag:        1.0.0
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Converts JPEG and PNG images to WebP on upload, serves them through picture
elements, and bulk-converts your existing media library.

== Description ==

WorkflowDone WebP Converter is the simplest plug-and-play WebP solution for
WordPress. No configuration required — just activate and go. The plugin
automatically detects your server's capabilities and starts converting images
right away.

Most image optimization plugins try to do everything: CDN integration, lazy
loading, AVIF, cloud processing, dashboard analytics. This one does exactly one
thing — **converts your JPEG and PNG images to WebP** — and does it reliably
with zero setup friction.

**Why this plugin?**

* **True plug-and-play** — activate, and it works. No API keys, no cloud
  accounts, no mandatory configuration. Sensible defaults are already set.
* **Universal server compatibility** — automatically detects and uses whichever
  conversion engine your host provides: the PHP GD or Imagick extension. The
  active backend is shown on the settings page so you always know what's running
  under the hood.
* **Safe by design** — your original files are never touched. The plugin creates
  `.webp` sidecar files alongside the originals. If the WebP version would be
  *larger* than the source (it happens with some PNGs), the conversion is
  silently discarded so you never serve a bigger file by accident.
* **Lightweight and focused** — no bloat, no upsells, no external service
  dependencies. One small settings page, a handful of options, and a bulk
  converter. That's it.

**Features**

* **Convert on upload** — generates a `.webp` sidecar alongside every uploaded
  JPEG/PNG, including all registered thumbnail sizes.
* **Automatic HTML rewriting** — wraps `<img>` tags in `<picture>` elements so
  WebP-capable browsers receive the smaller file while older browsers fall back
  to the original transparently.
* **Bulk converter** — converts all existing JPEG/PNG images in your media
  library in batches with a live progress bar and per-result counters
  (converted / already had WebP / failed).
* **Dual-backend detection** — automatically selects the GD or Imagick PHP
  extension, whichever is available on your server. Works on shared hosting,
  VPS, and dedicated servers alike.
* **Smart skipping** — skips images that already have an up-to-date WebP
  sidecar, and skips conversions where the WebP would be larger than the
  original.
* **Configurable quality** — choose a quality level between 1 and 100
  (default: 80).

== Installation ==

1. Upload the `workflowdone-webp-converter` folder to the `/wp-content/plugins/` directory,
   or install it via **Plugins → Add New** in the WordPress admin.
2. Activate the plugin through the **Plugins** menu.
3. Go to **Settings → WorkflowDone WebP** and configure your preferences.
4. Optionally click **Convert Existing Images** to process your current media library.

== Frequently Asked Questions ==

= Which conversion method does the plugin use? =

The plugin checks for GD (with WebP support) and Imagick in that order, and uses
the first one it finds. The active method is displayed at the top of the settings
page.

= Will my original images be deleted or overwritten? =

No. The plugin only *adds* `.webp` sidecar files alongside your originals. Your
JPEG and PNG files are never modified or removed.

= What happens if the WebP file would be larger than the original? =

The plugin automatically discards the conversion result and skips the file, so you
will never end up serving a larger file as a "WebP".

= Does it work with images already in the media library? =

Yes. Use the **Bulk Convert Existing Images** tool on the settings page to process
your entire media library. It runs in small batches, and each batch stops early if
it approaches your server's PHP time limit, so large libraries convert without
timing out. The progress bar shows the real percentage of your library completed.

= Is the HTML rewrite compatible with page builders? =

The HTML rewrite is skipped automatically in the WordPress admin, AJAX requests,
REST API responses, WP-Cron, and Elementor preview mode, so it should not
interfere with editing workflows.

== Screenshots ==

1. Settings page showing server capability status and conversion options.
2. Bulk converter with live progress bar and result counters.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release — no upgrade steps required.
