{"id":5016,"date":"2025-09-18T16:25:50","date_gmt":"2025-09-18T14:25:50","guid":{"rendered":"https:\/\/wpmastertoolkit.com\/module\/media-replacement\/"},"modified":"2025-09-18T16:37:24","modified_gmt":"2025-09-18T14:37:24","slug":"media-replacement","status":"publish","type":"module","link":"https:\/\/wpmastertoolkit.com\/en\/module\/5016-autosave-v1\/","title":{"rendered":"Media Replacement"},"content":{"rendered":"

Media Replacement - Replace WordPress media without breaking your links<\/h1>\n\n\n\n

Introduction<\/h2>\n\n\n\n

We've all been there: a badly retouched image, an obsolete PDF, a video compressed too hard... but already inserted all over the site. Deleting then re-importing breaks URLs, leaves pages with dead links, and changes the media ID.
The module Media Replacement<\/strong> of WPMasterToolKit solves this problem: it replaces the source file<\/strong> media without changing its ID, file name or publication date<\/strong>. Result : all URLs and integrations remain valid<\/strong>.<\/p>\n\n\n\n

Which plugins can this module replace?<\/h2>\n\n\n\n

Relevant if you use a dedicated plugin such as \"Enable Media Replace\". This module offers the same logic<\/strong> (in-place replacement) but integrated natively into WPMasterToolKit, with no additional plug-ins required.<\/p>\n\n\n\n

Exactly what the module does<\/h2>\n\n\n\n
    \n
  • In-place replacement<\/strong> copy your new file over the existing file<\/strong> on the disc.<\/li>\n\n\n\n
  • Identity preserved<\/strong> : ID, slug\/filename and date<\/strong> remain the same - so no URL changes<\/strong>.<\/li>\n\n\n\n
  • Regenerated miniatures<\/strong> After replacement, the module restarts wp_generate_attachment_metadata()<\/code> for recreate all undersizes<\/strong> (thumbnails).<\/li>\n\n\n\n
  • Strict type checking<\/strong> the new file must have the same MIME type<\/strong> (e.g. JPG \u2192 JPG, PDF \u2192 PDF). This avoids inconsistencies and integration problems.<\/li>\n\n\n\n
  • Visual overview<\/strong> an admin-side interface for viewing information \"Current<\/strong> vs. \"New<\/strong> (type, size, width\/height for images) before validation.<\/li>\n\n\n\n
  • Reliable cleaning of old files<\/strong> deletion of existing files and sub-sizes, including images -scaled<\/code><\/strong>. If a plugin (e.g. multilingual) blocks deletion, a \"hard delete<\/strong> makes sure to wipe off any leftovers.<\/li>\n\n\n\n
  • Natural integration into the admin<\/strong> :\n
      \n
    • Button \"Replace media<\/strong> in the line actions of the Media library<\/strong> (list).<\/li>\n\n\n\n
    • Button in the editing mode<\/strong> media.<\/li>\n\n\n\n
    • Button in the Publish box<\/strong> (attachment editing screen).<\/li>\n\n\n\n
    • An internal page (under Media<\/strong>) handles upload and confirmation - it is hidden from the menu<\/strong> to remain accessible only via action buttons.<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n\n\n\n

      UX details on the administration side<\/h2>\n\n\n\n
        \n
      • Clear interface with two columns: Current<\/strong> vs. New<\/strong>.<\/li>\n\n\n\n
      • Drag & drop or click to select file.<\/li>\n\n\n\n
      • Immediate validation on the JS side<\/strong> (max site weight, same type), with localized messages.<\/li>\n\n\n\n
      • Replace\" button<\/strong> disabled until validations are completed.<\/li>\n<\/ul>\n\n\n\n

        Scenarios and limits to be aware of<\/h2>\n\n\n\n
          \n
        • Same type required<\/strong> : you can't<\/strong> replace a PNG with a JPG. Keeping the same format guarantees 0 case.<\/li>\n\n\n\n
        • File name retained<\/strong> : it's designed to keep exactly the same URL<\/strong>.<\/li>\n\n\n\n
        • CDN \/ cache<\/strong> After replacement, remember to purge cache<\/strong> if you use a CDN or aggressive caching.<\/li>\n\n\n\n
        • Dimensions<\/strong> if you import a larger\/smaller image, the thumbnails will be regenerated accordingly (depending on your WordPress image sizes\/theme).<\/li>\n\n\n\n
        • Permissions<\/strong> accessible to roles with upload_files<\/code>.<\/li>\n\n\n\n
        • Security<\/strong> everything is protected by nonce<\/strong> and controls on the uploaded file (is_uploaded_file<\/code>authorized types, max WordPress size).<\/li>\n<\/ul>\n\n\n\n

          How to use this module<\/h2>\n\n\n\n
            \n
          1. Go to Media<\/strong> \u2192 Library<\/strong>.<\/li>\n\n\n\n
          2. On the media line to be replaced, click Replace media<\/strong> (or open the media file and click the same button).
            \"\"<\/figure><\/li>\n\n\n\n
          3. Drag and drop the new file<\/strong> (same type as the original).
            \"\"<\/figure><\/li>\n\n\n\n
          4. Check info in preview \"New\"<\/strong>.<\/li>\n\n\n\n
          5. Click Replace<\/strong>.
            That's all there is to it: URL does not change<\/strong>the site continues to point to the same ID, but with the updated file<\/strong>.
            \"\"<\/figure><\/li>\n<\/ol>\n\n\n\n

            Our technical choices (and why)<\/h2>\n\n\n\n
              \n
            • Keep ID\/path<\/strong> copy the new file on the original path<\/strong> (copy()<\/code> \u2192 same name, same location). This is the only way to ensure that all links remain valid<\/strong>.<\/li>\n\n\n\n
            • Strict MIME validation<\/strong> comparison between the original MIME and that of the new file via wp_check_filetype_and_ext()<\/code> and get_post_mime_type()<\/code> to avoid surprises (embed, players, HTML tags, etc.).<\/li>\n\n\n\n
            • Robust cleaning<\/strong> we use wp_delete_attachment_files()<\/code> with metadata and backup sizes, then a fallback<\/strong> physical deletion if necessary (in the case of images -scaled<\/code> or multilingual plugins).<\/li>\n\n\n\n
            • Metadata regeneration<\/strong> : wp_generate_attachment_metadata()<\/code> + wp_update_attachment_metadata()<\/code> to recreate all sub-sizes immediately after replacement - no need for third-party tools.<\/li>\n\n\n\n
            • Experience admin<\/strong> buttons added via :\n
                \n
              • media_row_actions<\/code><\/li>\n\n\n\n
              • attachment_fields_to_edit<\/code> (for the modal)<\/li>\n\n\n\n
              • attachment_submitbox_misc_actions<\/code> (edit screen)
                A sub-menu page hidden<\/strong> is loaded on demand to display the replacement UI, with dedicated assets (CSS\/JS) and localized strings.<\/li>\n<\/ul>\n<\/li>\n\n\n\n
              • Safety & capacity<\/strong> :\n
                  \n
                • Restricted access via upload_files<\/code>.<\/li>\n\n\n\n
                • Nonce<\/strong> for all URLs and forms.<\/li>\n\n\n\n
                • Controls is_uploaded_file<\/code>management of upload errors, and respect for wp_max_upload_size()<\/code> (via localized JS).<\/li>\n<\/ul>\n<\/li>\n\n\n\n
                • Performance<\/strong> conditional asset loading only<\/strong> on the replacement page. If the module is not activated, nothing is loaded<\/strong>.<\/li>\n<\/ul>\n\n\n\n

                  Conclusion<\/h2>\n\n\n\n

                  The module Media Replacement<\/strong> of WPMasterToolKit makes media replacement a simple safe, fast and without side effects<\/strong> : same ID, same URL, same date<\/strong>but updated file<\/strong> and regenerated miniatures<\/strong>. No more broken links or the hassle of re-importing. It's the ideal tool for keeping media libraries clean and up-to-date, with complete confidence.<\/p>\n\n\n\n

                  <\/p>","protected":false},"excerpt":{"rendered":"

                  The WPMasterToolKit plugin for WordPress offers a practical solution with its \"Media Replacement\" module, allowing you to replace media files without breaking existing links. More integrated and effective than similar plugins such as \"Enable Media Replace\", this function aims to reduce the number of active plugins to improve site performance. It integrates seamlessly into the WordPress administration interface, enabling transparent and secure file replacement while maintaining link integrity. It's the ideal solution for simplified, optimized media management.<\/p>","protected":false},"featured_media":0,"parent":0,"template":"","meta":{"_acf_changed":true,"_seopress_robots_primary_cat":"","_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","_surecart_dashboard_logo_width":"180px","_surecart_dashboard_show_logo":true,"_surecart_dashboard_navigation_orders":true,"_surecart_dashboard_navigation_invoices":true,"_surecart_dashboard_navigation_subscriptions":true,"_surecart_dashboard_navigation_downloads":true,"_surecart_dashboard_navigation_billing":true,"_surecart_dashboard_navigation_account":true},"class_list":["post-5016","module","type-module","status-publish","hentry"],"acf":[],"_links":{"self":[{"href":"https:\/\/wpmastertoolkit.com\/en\/wp-json\/wp\/v2\/module\/5016","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpmastertoolkit.com\/en\/wp-json\/wp\/v2\/module"}],"about":[{"href":"https:\/\/wpmastertoolkit.com\/en\/wp-json\/wp\/v2\/types\/module"}],"wp:attachment":[{"href":"https:\/\/wpmastertoolkit.com\/en\/wp-json\/wp\/v2\/media?parent=5016"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}