{"id":311227,"date":"2026-05-16T17:16:49","date_gmt":"2026-05-16T17:16:49","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/petro-seo-images-to-webp\/"},"modified":"2026-05-16T17:15:46","modified_gmt":"2026-05-16T17:15:46","slug":"petro-seo-images-to-webp","status":"publish","type":"plugin","link":"https:\/\/br.wordpress.org\/plugins\/petro-seo-images-to-webp\/","author":23497127,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.1.2","stable_tag":"1.1.2","tested":"6.9.4","requires":"5.8","requires_php":"7.1","requires_plugins":null,"header_name":"Petro SEO Images to WebP","header_author":"Diego Petroncari","header_description":"Bulk-convert media library JPG\/PNG to WebP siblings and serve them via the <picture> tag.","assets_banners_color":"0b3f58","last_updated":"2026-05-16 17:15:46","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/profiles.wordpress.org\/diegopetroncari\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":90,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.1.2":{"tag":"1.1.2","author":"diegopetroncari","date":"2026-05-16 17:15:46"}},"upgrade_notice":{"1.1.2":"

Cosmetic admin UI refresh \u2014 ASCII header and author credit on the plugin's settings page. Safe drop-in upgrade with no behavior changes.<\/p>","1.1.1":"

Plugin Check \/ wordpress.org compliance pass. No user-facing behavior change beyond the removal of an opportunistic chmod 0755<\/code> self-heal \u2014 read-only upload directories now have to be fixed manually (which was already the documented path).<\/p>","1.1.0":"

Rebrand to Petro SEO Images to WebP. A one-time auto-migration forwards all existing conversion state from the previous siw_*<\/code> \/ plugin_images_*<\/code> namespaces, so no manual action is required.<\/p>","1.0.4":"

Internal refactor for wordpress.org compliance with a one-time storage-key migration. No user-facing changes.<\/p>","1.0.3":"

Adds permission-skip handling, a quality ramp-down for oversized WebPs, and full responsive srcset preservation.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3533935,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3533935,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3533935,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3533935,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.2"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3533935,"resolution":"1","location":"assets","locale":"","width":1836,"height":1162}},"screenshots":{"1":"Admin page under Media \u2192 Petro SEO Images to WebP<\/strong> \u2014 settings, bulk-conversion counters, and Convert \/ Revert \/ Retry controls."}},"plugin_section":[],"plugin_tags":[163,247,216,186,15376],"plugin_category":[50,54,55],"plugin_contributors":[263182],"plugin_business_model":[],"class_list":["post-311227","plugin","type-plugin","status-publish","hentry","plugin_tags-images","plugin_tags-performance","plugin_tags-picture","plugin_tags-seo","plugin_tags-webp","plugin_category-media","plugin_category-security-and-spam-protection","plugin_category-seo-and-marketing","plugin_contributors-diegopetroncari","plugin_committers-diegopetroncari"],"banners":{"banner":"https:\/\/ps.w.org\/petro-seo-images-to-webp\/assets\/banner-772x250.png?rev=3533935","banner_2x":"https:\/\/ps.w.org\/petro-seo-images-to-webp\/assets\/banner-1544x500.png?rev=3533935","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/petro-seo-images-to-webp\/assets\/icon-128x128.png?rev=3533935","icon_2x":"https:\/\/ps.w.org\/petro-seo-images-to-webp\/assets\/icon-256x256.png?rev=3533935","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/petro-seo-images-to-webp\/assets\/screenshot-1.png?rev=3533935","caption":"Admin page under Media \u2192 Petro SEO Images to WebP<\/strong> \u2014 settings, bulk-conversion counters, and Convert \/ Revert \/ Retry controls."}],"raw_content":"\n

Petro SEO Images to WebP<\/strong> converts your existing JPEG and PNG attachments to WebP in bulk, then serves them on the front-end through the standard <picture><\/code> element with a full responsive srcset<\/code>. The original files stay untouched on disk, so reverting is as simple as flipping a switch.<\/p>\n\n

Designed to be small, dependency-free and predictable. No external services, no images uploaded anywhere, no opaque queue.<\/p>\n\n

What it does<\/h4>\n\n
    \n
  • Converts every registered image size (full + thumbnails) to .webp<\/code> next to the original (e.g. photo.jpg<\/code> \u2192 photo.jpg.webp<\/code>).<\/li>\n
  • Wraps <img><\/code> tags from wp_get_attachment_image()<\/code> and the_content<\/code> in <picture><source type=\"image\/webp\">\u2026<\/picture><\/code>, preserving full srcset<\/code> and sizes<\/code>.<\/li>\n
  • Skips images automatically if a previous run failed because of filesystem permissions, so you can retry on demand without reprocessing the whole library.<\/li>\n
  • Ramps the WebP quality down (75 \u2192 60 \u2192 45 \u2192 40) when the encoded file ends up larger than the original, so you never ship a \"WebP\" that is heavier than the JPEG.<\/li>\n
  • Idempotent: re-running the bulk job only touches new or updated images.<\/li>\n<\/ul>\n\n

    What it does NOT do<\/h4>\n\n
      \n
    • It does not delete or modify your original JPG\/PNG files.<\/li>\n
    • It does not require Imagick or a specific image library beyond what WordPress already uses (wp_get_image_editor()<\/code>).<\/li>\n
    • It does not phone home, register endpoints, or load remote scripts.<\/li>\n<\/ul>\n\n

      Privacy<\/h4>\n\n

      The plugin processes images locally using WordPress's built-in image editor. No data is sent to third-party services.<\/p>\n\n\n

        \n
      1. Upload the petro-seo-images-to-webp<\/code> folder to \/wp-content\/plugins\/<\/code>, or install via the Plugins screen.<\/li>\n
      2. Activate the plugin through the Plugins<\/strong> screen.<\/li>\n
      3. Go to Media \u2192 Petro SEO Images to WebP<\/strong>.<\/li>\n
      4. Click Convert all<\/strong> to process the existing library.<\/li>\n
      5. Make sure Serve WebP<\/strong> is enabled to wrap front-end images in <picture><\/code>.<\/li>\n<\/ol>\n\n\n
        \n

        Will this overwrite my original images?<\/h3><\/dt>\n

        No. Originals stay on disk. The plugin writes a sibling file with the .webp<\/code> extension (e.g. photo.jpg<\/code> and photo.jpg.webp<\/code>).<\/p><\/dd>\n

        How can I undo the conversion?<\/h3><\/dt>\n

        On Media \u2192 Petro SEO Images to WebP<\/strong>, click Revert all<\/strong>. Every generated .webp<\/code> file is removed and the tracking metadata is cleared.<\/p><\/dd>\n

        Some images were skipped. Why?<\/h3><\/dt>\n

        The most common cause is a write-permission issue on the uploads folder. Fix the directory permissions (e.g. chown www-data:www-data<\/code> on Linux) and click Retry skipped<\/strong> to reprocess only those.<\/p><\/dd>\n

        Does it work with responsive images \/ srcset?<\/h3><\/dt>\n

        Yes. The <source><\/code> element inside <picture><\/code> carries the full srcset<\/code> and sizes<\/code>, with each URL pointing to its .webp<\/code> counterpart. URLs whose .webp<\/code> is missing on disk are silently dropped from the WebP srcset<\/code> so the browser falls back to the original <img><\/code>.<\/p><\/dd>\n

        Can I serve `.webp` files without using the `` tag?<\/h3><\/dt>\n

        If you uncheck Serve WebP<\/strong> the files stay on disk but the plugin will not wrap your <img><\/code> markup. You can then serve them yourself (e.g. via Nginx Accept negotiation or a CDN rule).<\/p><\/dd>\n

        What if the WebP version ends up larger than the original?<\/h3><\/dt>\n

        The plugin retries with progressively lower quality (down to 40). If even at the lowest quality the WebP is still bigger than the source, it logs a diagnostic line and uses what it has \u2014 most browsers will still benefit from the format.<\/p><\/dd>\n\n<\/dl>\n\n\n

        1.1.2<\/h4>\n\n
          \n
        • Admin UI polish: ASCII-art header on Media \u2192 Petro SEO Images to WebP<\/strong> and a discreet author credit linking to the wordpress.org profile. No functional changes \u2014 purely cosmetic.<\/li>\n<\/ul>\n\n

          1.1.1<\/h4>\n\n
            \n
          • Plugin Check pass: drop empty .gitkeep<\/code> placeholders from includes\/<\/code> and assets\/<\/code> (they no longer make it into the release zip).<\/li>\n
          • Replace direct is_writable()<\/code> \/ chmod()<\/code> filesystem calls with wp_is_writable()<\/code>; the opportunistic chmod 0755<\/code> self-heal is gone \u2014 read-only directories now surface a clean permission error instead of being silently patched.<\/li>\n
          • Drop the load_plugin_textdomain()<\/code> call; wordpress.org auto-loads translations since WP 4.6.<\/li>\n
          • Wrap uninstall.php<\/code> logic in a psitw_uninstall()<\/code> function so locals stay out of the file scope.<\/li>\n
          • Annotate the unavoidable direct $wpdb<\/code> queries (uninstall sweep, namespace migration, skipped-meta cleanup) and meta_query<\/code> \/ post__not_in<\/code> calls with justified phpcs:ignore<\/code> comments.<\/li>\n<\/ul>\n\n

            1.1.0<\/h4>\n\n
              \n
            • Rebrand to Petro SEO Images to WebP<\/strong>: new plugin slug petro-seo-images-to-webp<\/code>, new internal prefix Psitw_*<\/code> \/ psitw_*<\/code> (5-letter prefix per WordPress plugin guidelines). A one-time auto-migration on first load forwards every legacy storage key (siw_*<\/code> and plugin_images_*<\/code>) into the new namespace, so existing conversion state is preserved.<\/li>\n
            • The admin page moved to Media \u2192 Petro SEO Images to WebP<\/strong>.<\/li>\n<\/ul>\n\n

              1.0.4<\/h4>\n\n
                \n
              • Rename internal class prefix and storage keys to siw_*<\/code> for unique namespacing \u2014 a one-time auto-migration runs on first load and copies legacy data forward.<\/li>\n
              • Replace @unlink<\/code> with wp_delete_file()<\/code> and add Plugin URI<\/code>, Author URI<\/code>, Requires at least<\/code> headers for wordpress.org compliance.<\/li>\n
              • Trim readme tags to 5, bump tested-up-to, exclude dev-only docs from the release zip.<\/li>\n<\/ul>\n\n

                1.0.3<\/h4>\n\n
                  \n
                • Skip attachments that fail because of filesystem permissions and offer a one-click retry flow.<\/li>\n
                • Ramp quality down when the resulting WebP is larger than the original.<\/li>\n
                • Keep the bulk loop alive when an entire batch fails by excluding failed IDs.<\/li>\n
                • Preserve full responsive srcset<\/code> inside the generated <picture><source><\/code>.<\/li>\n<\/ul>\n\n

                  1.0.0<\/h4>\n\n
                    \n
                  • Initial public release.<\/li>\n<\/ul>","raw_excerpt":"Bulk-convert media library images to WebP for better SEO and Core Web Vitals. Originals stay on disk; the front-end serves WebP via the tag.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/311227","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=311227"}],"author":[{"embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/diegopetroncari"}],"wp:attachment":[{"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=311227"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=311227"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=311227"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=311227"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=311227"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/br.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=311227"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}