MksDdn Migrate Content

What is inside a `.wpbkp` archive?

Each archive stores a manifest (checksums, metadata, timestamps), JSON payloads for selected entities, optional filesystem slices (uploads/plugins/themes), media binaries, and user-merge selections. Imports verify the manifest before processing.

How is `.wpbkp` different from `.json` exports?

.json exports are lightweight (content only) and convenient for quick edits. .wpbkp adds media, filesystem slices, and checksums. Use .wpbkp for full fidelity.

Does it support ACF and custom post types?

Yes. Any public post type plus Advanced Custom Fields metadata is exported/imported. Taxonomies, menus, widgets, and serialized options are also covered.

How do chunked uploads resume?

The JS client splits files into 5–10 MB chunks (auto-tuned by server limits). Each chunk is hashed and acknowledged via REST API endpoints (mksddn/v1/chunk/*). If the browser reloads, the resume token restarts from the last confirmed chunk.

How do I import a backup file from the server?

You can import backup files directly from the server without uploading them through the browser. Place your .wpbkp or .json archive files in the wp-content/uploads/mksddn-mc/imports/ directory (the plugin will create this directory automatically if it doesn’t exist). Then, in the import form, toggle the “Select from server” option instead of “Upload file”. The plugin will scan the imports directory and display available files with their size and modification date. Select the desired file and proceed with the import. This method is especially useful for large files or when you have direct server access via FTP/SFTP.

What is cleaned up when the plugin is deactivated?

Chunk upload state under wp-content/uploads/mksddn-mc/jobs/, theme replace backups under wp-content/mksddn-mc/theme-backups/, the import lock transient, server-backup list cache, user/theme preview transients, optional mksddn_mc_storage_path, and theme preview index data. Files in wp-content/uploads/mksddn-mc/imports/ are not removed by default; set the mksddn_mc_deactivation_clear_imports filter to true if you want that directory emptied on deactivation.

Can I merge users without overwriting existing accounts?

Yes. The user merge dialog shows archive/current rows with conflict indicators. You can keep current roles, replace metadata, or skip entire accounts.

Does it touch production files directly?

Filesystem operations run through WP_Filesystem, honor capability checks, and avoid .git, .svn, and OS temp files. Full-site imports back up theme directories before replace and restore them if extraction fails.

Hide FAQ

2.1.7

• Added: On plugin deactivation, DeactivationCleanup removes chunk job files, theme import backups under wp-content/mksddn-mc/theme-backups/, import lock and related transients, and clears theme preview data; optional filter mksddn_mc_deactivation_clear_imports may empty the server imports directory; action mksddn_mc_deactivation_cleanup runs after the default steps.
• Fixed: Selected content import — Polylang translation links when the bundle includes every post in a group (_pll_translations remapped, pll_save_post_translations()).

2.1.6

• Rollback: Codebase restored to the 2.1.4 state; supersedes 2.1.5.

2.1.5

• Enhanced: Full-site export — time-sliced runner, incremental database reads, resumable chunked download, clearer errors for missing/unreadable files.
• Changed: Export step time budget in settings; removed deprecated helpers.

2.1.4

• Fixed: User merge replace mode — resolve_remote_user_login() uses loose sanitize_user() first; force_wp_users_login_and_password() updates wp_users after wp_update_user() so archive login and password hash stay paired (avoids old username + new password).

2.1.3

• Added: Export memory management (ExportMemoryHelper) with configurable min/max export memory limits in PluginConfig for more stable full-site exports.
• Enhanced: Full site export/import now includes wp-content/mu-plugins alongside uploads, plugins, and themes.
• Fixed: User merge — when updating existing users, login is adjusted to stay unique if the archive login collides with another account.

2.1.2

• Fixed: UnifiedImportOrchestrator constructor now receives ThemePreviewStoreInterface as 5th argument (fixes full-site import error when wrong service was passed).
• Enhanced: AdminServiceProvider – explicit use of ThemePreviewStoreInterface for UnifiedImportOrchestrator and related registrations.

2.1.1

• Added: Theme import preview – preview theme changes before applying.
• Added: Russian translation (ru_RU).
• Enhanced: Theme import – full theme replacement, improved error handling and validation.
• Enhanced: ChunkJobRepository – improved directory handling and cleanup for chunked transfers.
• Enhanced: FullSiteImportService – WooCommerce maintenance and plugin reactivation after import.
• Enhanced: Theme export section descriptions for clarity.

2.1.0

• Added: Theme export and import functionality – users can now export and import WordPress themes with merge and replace mode options.
• Enhanced: Export and Import Handlers for improved data handling – added local dates, modified dates, menu order, comment status, and parent page slug to exports. Import now sorts items by parent-child relationships.
• Enhanced: Taxonomy handling in Export and Import Handlers – preloads taxonomy terms for all post types including Polylang language taxonomy, improving export accuracy and import consistency.
• Enhanced: DomainReplacer for improved URL normalization – prevents port duplication in URLs during domain replacements.
• Enhanced: Import locking mechanism with improved error handling and automatic lock release on fatal errors, ensuring only one import can run at a time.
• Enhanced: Admin styles with new flexbox layout classes for better organization and responsiveness of selection elements.
• Enhanced: Theme import and export with improved logging, optimized theme retrieval, and validation to prevent deletion of active or parent themes.
• Refactored: Removed deprecated import templates and sections from admin interface for cleaner codebase.

2.0.3

• Fixed: Media files are now properly linked to pages/posts during wpbkp import. ACF Image fields correctly receive new attachment IDs for all return formats.

2.0.2

• Fixed: Partial export material selection now displays items from all languages when Polylang is installed.

2.0.1

• Enhanced: FullDatabaseImporter type safety with integer casting for batch offsets.
• Enhanced: UserMergeApplier recursive validation for incomplete objects in user meta, preventing import errors.

2.0.0

• Added: Unified import feature with automatic type detection – single import form automatically detects and routes full site or selected content imports.
• Added: Import locking mechanism to prevent concurrent import operations and ensure data integrity.
• Added: AJAX search functionality for post selection, improving usability when selecting content for export.
• Enhanced: Download progress handling in chunked transfers for better user experience.
• Enhanced: Security with improved nonce verification in unified import orchestrator.
• Refactored: Import handling architecture with unified orchestrator for cleaner code organization.

1.4.0

• Added: Post-import maintenance tasks (cache flushing, WooCommerce maintenance, plugin reactivation hooks).
• Enhanced: SQL safety with improved sanitization and escaping for database operations.
• Enhanced: Memory management with adaptive strategies to prevent exhaustion during large imports.
• Enhanced: Error handling and logging throughout import processes.
• Added: RedirectTrait for streamlined HTTP redirect handling during background imports.
• Refactored: Database row insertion logic for improved performance.

1.3.2

• Enhanced: Improved memory management in FullArchivePayload – original memory limit is now stored and restored during JSON decoding for large files, ensuring efficient resource handling.
• Enhanced: Enhanced domain signature collection in DomainReplacer to include port and scheme information, improving URL replacement accuracy during migrations.

1.3.1

• Fixed: Improved compliance with WordPress.org plugin guidelines – all scripts/styles now properly enqueued, conditional loading for admin files, removed inline code.
• Enhanced: Real-time import progress tracking via REST API polling without page refresh.
• Enhanced: Improved background import execution with fastcgi_finish_request() support for uninterrupted processing.

1.3.0

• Added MKSDDN_MC_BASENAME constant for plugin path management.
• Introduced dedicated CSS file for import progress styling.
• Added user warnings to prevent accidental lockouts when deselecting all users.
• Enhanced user selection handling to preserve current admin user during imports.
• Improved data sanitization across handlers.
• Added import completion notices in NotificationService.
• Implemented backup and restore of critical options during full database imports.
• Enhanced file verification in FullContentImporter.
• Refactored FilesystemHelper to initialize permissions dynamically.
• Enhanced ImportProgressPage with static CSS/JS generation methods.

1.2.5

• Refactored BatchLoader to enhance database query efficiency by replacing placeholder-based queries with sanitized ID strings, improving security and performance.
• Implemented dedicated admin styles and scripts with separate CSS and JavaScript files for better code organization and maintainability.
• Added CSS for progress bars, sections, grids, and cards to enhance the admin interface.
• Introduced JavaScript for progress bar functionality with dynamic updates during content migration.
• Refactored code to remove deprecated inline styles and scripts, promoting better separation of concerns.
• Updated comments for clarity on caching and sanitization practices.
• Added PHPCS ignore comments for specific cases to address coding standards compliance.

1.2.4

• Enhanced ACF field export and import support for groups and repeaters.
• Improved ACF field handling in BatchLoader by using get_fields() directly for better efficiency.
• Enhanced link field processing in repeaters and groups during import operations.
• Refactored ACF field retrieval in WpFunctionsWrapper to ensure consistent array return types.
• Improved data integrity during ACF imports with better field value handling and recursive media remapping.

1.2.3

• Enhanced FilesystemHelper with dynamic definition of FS_CHMOD_FILE and FS_CHMOD_DIR based on existing WordPress file permissions, improving filesystem operations compatibility.
• Added ensure_directory() method to FilesystemHelper for consistent directory creation with proper error handling.
• Refactored directory creation logic in ChunkJobRepository, ChunkRestController, and FullContentExporter to utilize FilesystemHelper for improved error handling and consistency.
• Improved file permissions handling in put_stream() method to ensure proper chmod after streaming operations.

1.2.2

1.2.1

• Updated PHPCS ignore comments for set_time_limit and ini_set to current standards.

1.2.0

• Added real-time progress tracking for import operations with visual progress bar.
• Implemented incremental database import to optimize memory usage for large backups.
• Enhanced memory and time limit management based on file size to prevent failures.
• Added output flushing for better responsiveness during import.
• Improved error handling and logging for large file imports.
• Removed unused auto-increment key handling code for cleaner codebase.

1.1.0

• Added server file import feature – users can now select backup files directly from the server imports directory.
• Introduced ServerBackupScanner service for scanning and validating backup files on the server.
• Added JavaScript module (server-file-selector.js) for dynamic file selection with AJAX loading.
• Updated import forms (full site and selected content) with source toggle (upload vs server).
• Enhanced FullSiteImportService and SelectedContentImportService to support server file imports.
• Added AJAX endpoint (mksddn_mc_get_server_backups) for retrieving available backup files.
• Implemented file caching via WordPress transients to improve performance.
• Added path traversal protection for secure server file access.
• Server file selector displays file size and modification date for better user experience.

1.0.1

• Fixed duplicate PRIMARY KEY errors during full site import (wp_postmeta, wp_actionscheduler_actions).
• Auto-increment PRIMARY KEY fields are now excluded from inserts to let database generate new values.
• Added INSERT IGNORE fallback for handling duplicate key conflicts during import.

1.0.0

• Clean-room .wpbkp archive format with manifest + checksum validator.
• Full-site export/import (database + uploads/plugins/themes) with streaming chunked transfer.
• Selected content export with multi-select CPT picker, media toggle, and JSON fallback.
• Media collector/restorer for featured images, galleries, and inline attachments.
• Chunked upload/download pipeline with resume tokens, progress UI, and safe fallbacks.
• User merge matrix covering new, conflicting, and existing accounts with role/metasync choices.
• Refactored architecture following SOLID principles with Service Container and Dependency Injection.
• All components use interfaces (Contracts) for improved testability and maintainability.
• Separated concerns: Request Handlers, Services, and Views are clearly divided.
• Specialized exception handling for better error management.
• Optimized database queries using BatchLoader to prevent N+1 problems.