=== WordPress Importer === Contributors: wordpressdotorg Donate link: https://wordpressfoundation.org/donate/ Tags: importer, wordpress Requires at least: 5.2 Tested up to: 6.2 Requires PHP: 5.6 Stable tag: 0.8.1 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Import posts, pages, comments, custom fields, categories, tags and more from a WordPress export file. == Description == The WordPress Importer will import the following content from a WordPress export file: * Posts, pages and other custom post types * Comments and comment meta * Custom fields and post meta * Categories, tags and terms from custom taxonomies and term meta * Authors For further information and instructions please see the [documention on Importing Content](https://wordpress.org/support/article/importing-content/#wordpress). == Installation == The quickest method for installing the importer is: 1. Visit Tools -> Import in the WordPress dashboard 1. Click on the WordPress link in the list of importers 1. Click "Install Now" 1. Finally click "Activate Plugin & Run Importer" If you would prefer to do things manually then follow these instructions: 1. Upload the `wordpress-importer` folder to the `/wp-content/plugins/` directory 1. Activate the plugin through the 'Plugins' menu in WordPress 1. Go to the Tools -> Import screen, click on WordPress == Changelog == = 0.8.1 = * Update compatibility tested-up-to to WordPress 6.2. * Update paths to build status badges. = 0.8 = * Update minimum WordPress requirement to 5.2. * Update minimum PHP requirement to 5.6. * Update compatibility tested-up-to to WordPress 6.1. * PHP 8.0, 8.1, and 8.2 compatibility fixes. * Fix a bug causing blank lines in content to be ignored when using the Regex Parser. * Fix a bug resulting in a PHP fatal error when IMPORT_DEBUG is enabled and a category creation error occurs. * Improved Unit testing & automated testing. = 0.7 = * Update minimum WordPress requirement to 3.7 and ensure compatibility with PHP 7.4. * Fix bug that caused not importing term meta. * Fix bug that caused slashes to be stripped from imported meta data. * Fix bug that prevented import of serialized meta data. * Fix file size check after download of remote files with HTTP compression enabled. * Improve accessibility of form fields by adding missing labels. * Improve imports for remote file URLs without name and/or extension. * Add support for `wp:base_blog_url` field to allow importing multiple files with WP-CLI. * Add support for term meta parsing when using the regular expressions or XML parser. * Developers: All PHP classes have been moved into their own files. * Developers: Allow to change `IMPORT_DEBUG` via `wp-config.php` and change default value to the value of `WP_DEBUG`. = 0.6.4 = * Improve PHP7 compatibility. * Fix bug that caused slashes to be stripped from imported comments. * Fix for various deprecation notices including `wp_get_http()` and `screen_icon()`. * Fix for importing export files with multiline term meta data. = 0.6.3 = * Add support for import term metadata. * Fix bug that caused slashes to be stripped from imported content. * Fix bug that caused characters to be stripped inside of CDATA in some cases. * Fix PHP notices. = 0.6.2 = * Add `wp_import_existing_post` filter, see [Trac ticket #33721](https://core.trac.wordpress.org/ticket/33721). = 0.6 = * Support for WXR 1.2 and multiple CDATA sections * Post aren't duplicates if their post_type's are different = 0.5.2 = * Double check that the uploaded export file exists before processing it. This prevents incorrect error messages when an export file is uploaded to a server with bad permissions and WordPress 3.3 or 3.3.1 is being used. = 0.5 = * Import comment meta (requires export from WordPress 3.2) * Minor bugfixes and enhancements = 0.4 = * Map comment user_id where possible * Import attachments from `wp:attachment_url` * Upload attachments to correct directory * Remap resized image URLs correctly = 0.3 = * Use an XML Parser if possible * Proper import support for nav menus * ... and much more, see [Trac ticket #15197](https://core.trac.wordpress.org/ticket/15197) = 0.1 = * Initial release == Frequently Asked Questions == = Help! I'm getting out of memory errors or a blank screen. = If your exported file is very large, the import script may run into your host's configured memory limit for PHP. A message like "Fatal error: Allowed memory size of 8388608 bytes exhausted" indicates that the script can't successfully import your XML file under the current PHP memory limit. If you have access to the php.ini file, you can manually increase the limit; if you do not (your WordPress installation is hosted on a shared server, for instance), you might have to break your exported XML file into several smaller pieces and run the import script one at a time. For those with shared hosting, the best alternative may be to consult hosting support to determine the safest approach for running the import. A host may be willing to temporarily lift the memory limit and/or run the process directly from their end. -- [Support Article: Importing Content](https://wordpress.org/support/article/importing-content/#before-importing) == Filters == The importer has a couple of filters to allow you to completely enable/block certain features: * `import_allow_create_users`: return false if you only want to allow mapping to existing users * `import_allow_fetch_attachments`: return false if you do not wish to allow importing and downloading of attachments * `import_attachment_size_limit`: return an integer value for the maximum file size in bytes to save (default is 0, which is unlimited) There are also a few actions available to hook into: * `import_start`: occurs after the export file has been uploaded and author import settings have been chosen * `import_end`: called after the last output from the importer { "No queue item ID provided": "No queue item ID provided", "The provided queue item id not found": "The provided queue item id not found", "Log file not found or not readable": "Log file not found or not readable", "Invalid destination id \"%s\" provided": "Invalid destination id \"%s\" provided", "You can't create\/modify %s destination without a license": "You can't create\/modify %s destination without a license", "Success": "Success", "Please enter a valid 6-digit MFA code": "Please enter a valid 6-digit MFA code", "Invalid code": "Invalid code", "QR Code validated successfully": "QR Code validated successfully", "No backup id provided": "No backup id provided", "Invalid backup id provided": "Invalid backup id provided", "Snapshot is marked for deletion": "Snapshot is marked for deletion", "Backup snapshot ": "Backup snapshot ", "Not enough privileges to access this action": "Not enough privileges to access this action", "You must be a network admin to access this action": "You must be a network admin to access this action", "User created successfully!": "User created successfully!", "Snapshot is locked": "Snapshot is locked", "No destination id provided": "No destination id provided", "Invalid destination id provided": "Invalid destination id provided", "Saved Successfully": "Saved Successfully", "Destination ": "Destination ", "Invalid showcase type": "Invalid showcase type", "Saved successfully": "Saved successfully", "Invalid snapshot id provided": "Invalid snapshot id provided", "This feature is only supported for JetBackup Linux snapshots": "This feature is only supported for JetBackup Linux snapshots", "This feature is only supported for account backups": "This feature is only supported for account backups", "This feature is only supported for backups containing the home directory": "This feature is only supported for backups containing the home directory", "This backup doesn't contain homedir item": "This backup doesn't contain homedir item", "Unable to fetch linux user homedir": "Unable to fetch linux user homedir", "The WP public dir doesn't start with the account homedir": "The WP public dir doesn't start with the account homedir", "Backup notes modified successfully! Reloading...": "Backup notes modified successfully! Reloading...", "Cannot change data folder with active running queue items": "Cannot change data folder with active running queue items", "No queue id provided": "No queue id provided", "Invalid queue id provided": "Invalid queue id provided", "Queue Item set back to pending": "Queue Item set back to pending", "No schedule id provided": "No schedule id provided", "Invalid schedule id provided": "Invalid schedule id provided", "No snap id provided": "No snap id provided", "Invalid job id \"%s\" provided": "Invalid job id \"%s\" provided", "Backup job ": "Backup job ", "Cannot delete default destination": "Cannot delete default destination", "We have to keep at least 1 Local destination": "We have to keep at least 1 Local destination", "Cannot delete a destination with assigned backup jobs": "Cannot delete a destination with assigned backup jobs", "Destination Deleted successfully! Reloading...": "Destination Deleted successfully! Reloading...", "No download id provided": "No download id provided", "Invalid download id provided": "Invalid download id provided", "Deleted Successfully": "Deleted Successfully", "No job id provided": "No job id provided", "Invalid job id provided": "Invalid job id provided", "Cannot edit internal system job": "Cannot edit internal system job", "Job ": "Job ", "No backup job id provided": "No backup job id provided", "Invalid backup job id provided": "Invalid backup job id provided", "Queue Item Aborted successfully!": "Queue Item Aborted successfully!", "Email System is disabled": "Email System is disabled", "Email from ($recipient) invalid!": "Email from ($recipient) invalid!", "Email sent!": "Email sent!", "Invalid schedule id \"%s\" provided": "Invalid schedule id \"%s\" provided", "Destination validated successfully": "Destination validated successfully", "Cannot delete a schedule with jobs assigned": "Cannot delete a schedule with jobs assigned", "Cannot delete a system default schedule": "Cannot delete a system default schedule", "Schedule Deleted successfully! Reloading...": "Schedule Deleted successfully! Reloading...", "Job Duplicated successfully! Reloading...": "Job Duplicated successfully! Reloading...", "QueueCleared successfully!": "QueueCleared successfully!", "Can only execute through wp cli": "Can only execute through wp cli", "Invalid queue type specified: %s": "Invalid queue type specified: %s", "Failed adding to queue. Error: %s": "Failed adding to queue. Error: %s", "No valid destinations provided.": "No valid destinations provided.", "No valid destination found.": "No valid destination found.", "No backup job id was provided": "No backup job id was provided", "Can only restore account backups": "Can only restore account backups", "This restore feature is not supported": "This restore feature is not supported", "Added to queue!": "Added to queue!", "No upload file was provided": "No upload file was provided", "No upload file size was provided": "No upload file size was provided", "Invalid filename: ": "Invalid filename: ", "Invalid upload id was provided": "Invalid upload id was provided", "Failed writing chunk to upload file. Error: %s": "Failed writing chunk to upload file. Error: %s", "Invalid backup file provided. Only .tar or .tar.gz files are allowed.": "Invalid backup file provided. Only .tar or .tar.gz files are allowed.", "Waiting for next file chunk": "Waiting for next file chunk", "No snapshot id, path of file was provided": "No snapshot id, path of file was provided", "JetBackup Linux integration is disabled": "JetBackup Linux integration is disabled", "JetBackup Linux integration is not installed": "JetBackup Linux integration is not installed", "Added to reindex queue": "Added to reindex queue", "No destination id was provided": "No destination id was provided", "Destination '": "Destination '", "No snapshot id was provided": "No snapshot id was provided", "This feature is not supported with legacy SGB backups": "This feature is not supported with legacy SGB backups", "Can only export account backups": "Can only export account backups", "Can only export full backups": "Can only export full backups", "Can only download account backups": "Can only download account backups", "Download limit of $allowedDownloads reached. Please clear an existing download before starting a new one.": "Download limit of $allowedDownloads reached. Please clear an existing download before starting a new one.", "Can only extract account backups": "Can only extract account backups", "Destination export config ": "Destination export config ", "No queue item id provided": "No queue item id provided", "Invalid queue item id provided": "Invalid queue item id provided", "Cannot delete default job": "Cannot delete default job", "Job Deleted successfully!": "Job Deleted successfully!", "Alerts cleared successfully!": "Alerts cleared successfully!" } File