cm4all

<p>ImpEx is a WordPress plugin that allows you to import and export data from and to your WordPress installation.</p>
<p>The primary goal for ImpEx is to provide a <strong>true Open Source WordPress Plugin</strong> for importing/exporting your WordPress data (including data from third-party plugins/themes).</p>
<p><strong>This plugin is in an early (but working) stage.</strong></p>
<p>Impex provides :</p>
<ul>
<li>
<p>WordPress hooks for third-party plugins to expose their own data to ImpEx Import / Export without being dependent on Impex.</p>
</li>
<li>
<p>a (semi) streaming architecture for large data exports/imports.</p>
</li>
<li>
<p>Definition of configurable import/export profiles defining data providers to use and configuration of these data providers</p>
<ul>
<li>A user interface for importing / exporting data via ImpEx WP admin screen</li>
</ul>
</li>
<li>
<p>the ImpEx API is designed to support resumable/cancelable imports and exports.</p>
</li>
<li>
<p>ImpEx provides a REST API integrated into WordPress</p>
</li>
<li>
<p>ImpEx is explicitly designed for use in managed WordPress instances</p>
</li>
<li>
<p>ImpEx development relies heavily on PHP unit testing its feature set to be stable and consistent.</p>
</li>
<li>
<p>a <a href="https://ionos-wordpress.github.io/cm4all-wp-impex/impex-cli.html" rel="nofollow ugc">CLI</a> for importing/exporting data via ImpEx REST interface.<br />
The ImpEx CLI can be used as an alternative to the ImpEx WP admin screen.</p>
</li>
<li>
<p>related NPM package <a href="https://www.npmjs.com/package/@cm4all-wp-impex/generator" rel="nofollow ugc">@cm4all-wp-impex/generator</a> enabling transformation of any content to Impex Export format.</p>
<p>Using this package you’re able to convert any content to WordPress and import it using the ImpEx plugin. See the <a href="https://ionos-wordpress.github.io/cm4all-wp-impex/cm4all-wp-impex-generator/static-website-tutorial.html" rel="nofollow ugc">Tutorial</a><br />
or <a href="https://www.youtube.com/watch?v=pjG69RmULYo" rel="nofollow ugc">watch the walk-trough at YouTube</a>.</p>
</li>
</ul>
<p><strong>Your help is welcome !!</strong></p>


cm4all-wp-impex

ImpEx contributes extendable Import / Export functionality to WordPress

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

cm4all-wp-impex vs MksDdn Migrate Content