Hendridev

<p>HDEV Import / Export Post lets you move posts between WordPress sites without losing their images. Export a post type to a single portable JSON file, then import that file on a local server or another production site.</p>
<p>During import, every featured image, in-content image and post attachment is downloaded from the source site into the destination site’s own media library, and the image URLs inside the post content are rewritten to point at the newly downloaded copies. Nothing keeps pointing back at the old site.</p>
<p>Re-importing the same file is safe: existing posts are updated in place instead of duplicated, and media that was already downloaded is reused instead of downloaded again.</p>
<p>Both export and import run in small batches with a live progress bar, so large jobs do not time out and you always see what is happening.</p>
<p><strong>Export features:</strong></p>
<ul>
<li>Export any public post type (Posts, Pages and custom post types)</li>
<li>Filter by post status (published, draft, pending, private, scheduled or all)</li>
<li>Filter by date range — the month list is detected automatically from the existing content of the selected post type and refreshes when you switch post types</li>
<li>Filter by author — the dropdown lists only users who have actually authored content on the site</li>
<li>Optionally include the media attached to each post</li>
<li>Single portable JSON file — easy to move between sites</li>
<li>Live progress bar while the export runs, then the file downloads automatically</li>
</ul>
<p><strong>Import features:</strong></p>
<ul>
<li>Featured images, in-content images and post attachments are downloaded into the destination site’s media library</li>
<li>In-content image URLs are automatically rewritten to the new local URLs</li>
<li>Update existing posts instead of creating duplicates — posts are matched by slug and post type, so the same file can be imported again safely</li>
<li>Already-downloaded media is detected and reused, so re-imports never fill the media library with copies</li>
<li>Works between local development sites (Local, <code>.local</code> / <code>.test</code> domains) as well as production domains</li>
<li>Taxonomy terms (categories, tags and custom taxonomies) and post meta are preserved</li>
<li>Missing categories are created automatically, including the full parent/child hierarchy</li>
<li>Assign every imported post to a user of your choice, or keep the original author when a matching username exists</li>
<li>Optional: import all posts as drafts</li>
<li>Live progress bar with a per-post log — successful posts, reused/downloaded media counts, and clear warnings when a media download fails</li>
</ul>
<p><strong>General:</strong></p>
<ul>
<li>No new database tables — uses the standard WordPress APIs</li>
<li>Admin-only: every action requires the <code>manage_options</code> capability and is protected by nonces</li>
</ul>


HDEV Import / Export Post

Export posts to a JSON file and import them elsewhere, downloading featured images, content images and attachments to the destination site.

<p>MksDdn Migrate Content is a clean-room migration suite that packages your site into deterministic <code>.wpbkp</code> archives. Each bundle contains a manifest, checksum, database segments, media, selected files, and user decisions, so imports stay predictable.</p>
<h4>Why MksDdn Migrate Content?</h4>
<ul>
<li><strong>Dual export modes</strong> – choose Full Site (database + uploads/plugins/mu-plugins/themes) or Selected Content (multi-select posts/pages/CPTs) with or without referenced media.</li>
<li><strong>Chunked pipeline</strong> – large archives stream through REST API endpoints with resume tokens, so multi‑GB transfers survive flaky networks.</li>
<li><strong>User merge control</strong> – compare archive vs current users and decide how to merge conflicts.</li>
<li><strong>Theme import mode</strong> – when a theme archive is detected, choose replace vs merge before applying changes.</li>
<li><strong>Integrity & safety</strong> – <code>.wpbkp</code> archives ship with manifests and checksums; imports verify capabilities, nonces, and disk space before touching data.</li>
<li><strong>Import preflight</strong> – unified import is a two-step flow: run preflight (read-only report), then start the real import from the report without uploading the file again (browser uploads are staged server-side between steps).</li>
</ul>
<h4>Feature Highlights</h4>
<ul>
<li>Archive format with manifest, checksum, and payload folders (<code>content.json</code>, <code>media/</code>, <code>options/</code>, filesystem slices).</li>
<li>Media scanner that collects featured images, galleries, attachments referenced inside blocks or shortcodes.</li>
<li>File-system coverage for <code>wp-content/uploads</code>, <code>wp-content/plugins</code>, <code>wp-content/mu-plugins</code>, <code>wp-content/themes</code> with filters to skip VCS/system files.</li>
<li>Chunked upload/download JS client with live progress, auto-resume, and graceful fallback to direct transfer.</li>
<li>Server file import – select backup files directly from <code>wp-content/uploads/mksddn-mc/imports/</code> directory without browser uploads.</li>
<li>Custom <code>.wpbkp</code> drag-and-drop uploader with checksum guardrails (UI polish deferred to next milestone, functionality already complete).</li>
</ul>
<h3>Architecture</h3>
<p>The plugin follows SOLID principles and WordPress Coding Standards with a clean, modular architecture:</p>
<h4>Service Container & Dependency Injection</h4>
<ul>
<li>Centralized <code>ServiceContainer</code> manages all dependencies</li>
<li>Service Providers (<code>CoreServiceProvider</code>, <code>AdminServiceProvider</code>, <code>ExportServiceProvider</code>, <code>ImportServiceProvider</code>, <code>ChunkServiceProvider</code>) register services</li>
<li>All dependencies resolved through container, eliminating direct instantiation</li>
<li>Full support for interface-based dependency injection</li>
</ul>
<h4>Request Handlers</h4>
<ul>
<li><code>ExportRequestHandler</code> – handles export requests</li>
<li><code>ImportRequestHandler</code> – delegates to specialized import services (supports unified import via <code>UnifiedImportOrchestrator</code>)</li>
<li><code>UserMergeRequestHandler</code> – processes user merge operations</li>
<li><code>ThemePreviewRequestHandler</code> – handles theme preview cancel operations</li>
<li><code>ChunkRestController</code> – REST API controller for chunked upload/download operations</li>
<li>All handlers implement corresponding interfaces for testability</li>
</ul>
<h4>Service Layer</h4>
<ul>
<li><code>SelectedContentImportService</code> – handles selected content imports</li>
<li><code>FullSiteImportService</code> – manages full site imports</li>
<li><code>ThemeImportService</code> – handles theme archive imports</li>
<li><code>UnifiedImportOrchestrator</code> – orchestrates unified import with automatic type detection; step 1 is always preflight, step 2 runs the real import using a stored file reference</li>
<li><code>ImportPreflightService</code> – read-only analysis for unified import preflight</li>
<li><code>PreflightReportStore</code> – short-lived transient storage for preflight reports and follow-up import handles (staged browser uploads under <code>wp-content/uploads/mksddn-mc/preflight/</code>, or chunk/server identifiers)</li>
<li><code>ImportTypeDetector</code> – detects import type (full site or selected content) from archive file</li>
<li><code>ImportFileValidator</code> – validates uploaded files</li>
<li><code>ImportPayloadPreparer</code> – prepares import payloads</li>
<li><code>ServerBackupScanner</code> – scans and validates backup files on the server</li>
<li><code>ResponseHandler</code> – manages redirects and status messages</li>
<li><code>NotificationService</code> – handles user notifications</li>
<li><code>ProgressService</code> – tracks operation progress</li>
<li><code>ErrorHandler</code> – centralized error handling and logging</li>
<li><code>UserDiffBuilder</code> – builds user difference comparison</li>
<li><code>UserMergeApplier</code> – applies user merge operations</li>
<li><code>ThemePreviewStore</code> – stores pending theme import previews</li>
<li><code>DeactivationCleanup</code> – clears temporary upload state and service directories when the plugin is deactivated</li>
<li><code>PostImportMaintenance</code> – centralizes cache/rewrite cleanup after full import and emergency purge if the database was partially updated; performs global flush plus targeted <code>wp_cache_flush_group()</code> when supported, bumps posts/terms/comments last_changed hooks, exposes <code>mksddn_mc_post_import_object_cache_flush_groups</code> filter, integrates page-cache plugins via best-effort function calls and hooks</li>
<li><code>FullImportMaintenance</code> – file-based runtime lock and early 503 gate while a full-site import is running (admin, CLI, cron exempt; REST blocked unless explicitly allowed)</li>
</ul>
<h4>Contracts (Interfaces)</h4>
<p>All key components implement interfaces:<br />
* <code>ExporterInterface</code>, <code>ImporterInterface</code><br />
* <code>MediaCollectorInterface</code>, <code>ChunkJobRepositoryInterface</code><br />
* <code>UserPreviewStoreInterface</code>, <code>ThemePreviewStoreInterface</code>, <code>UserDiffBuilderInterface</code>, <code>UserMergeApplierInterface</code><br />
* <code>NotificationServiceInterface</code>, <code>ProgressServiceInterface</code><br />
* <code>ArchiveHandlerInterface</code>, <code>ValidatorInterface</code><br />
* Request handler interfaces for all handlers</p>
<h4>Error Handling</h4>
<ul>
<li>Specialized exceptions: <code>ValidationException</code>, <code>FileOperationException</code>, <code>DatabaseOperationException</code>, <code>ImportException</code>, <code>ExportException</code></li>
<li>Centralized <code>ErrorHandler</code> for consistent error processing</li>
<li>Proper logging and user-friendly error messages</li>
<li>Validation classes: <code>ArchiveValidator</code>, <code>ImportDataValidator</code>, <code>ExportDataValidator</code>, <code>FileValidator</code></li>
</ul>
<h4>Performance</h4>
<ul>
<li><code>BatchLoader</code> for optimized database queries (prevents N+1 problems)</li>
<li>Efficient media collection with batch processing (<code>AttachmentCollector</code>)</li>
<li>Chunked transfer for large files via REST API (<code>ChunkRestController</code>)</li>
<li>Memory-efficient streaming for large archives</li>
<li><code>FullArchivePayload</code> for efficient archive payload handling</li>
<li><code>ContentCollector</code> for filesystem content collection</li>
</ul>
<h4>Security</h4>
<ul>
<li>All admin operations check <code>current_user_can('manage_options')</code></li>
<li>Nonce verification for all forms and AJAX requests</li>
<li>REST API endpoints protected with permission callbacks</li>
<li>Input sanitization using WordPress sanitization functions</li>
<li>Output escaping with <code>esc_html()</code>, <code>esc_attr()</code>, <code>esc_url()</code></li>
<li>File upload validation with MIME type checking</li>
<li>Path traversal protection for server file access (<code>ServerBackupScanner</code>)</li>
<li>Path traversal protection for archive extraction (full site + theme import)</li>
<li><code>SiteUrlGuard</code> prevents accidental site URL changes during import</li>
<li><code>ImportLock</code> prevents concurrent import operations</li>
<li><code>DomainReplacer</code> safely handles URL replacement during migrations</li>
</ul>


MksDdn Migrate Content

Reliable chunked migrations powered by custom .wpbkp archives.

HDEV Import / Export Post vs MksDdn Migrate Content