Reliable chunked migrations powered by custom .wpbkp archives.

<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>
</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>


Alternatives to MksDdn Migrate Content

Top alternatives