WordPress XML Importer
This tool lets you import contents from an XML file. The format is compatible with WordPress exports.
In order to import a WordPress blog into b2evolution, you must first:
- Export your WordPress database to an XML file by using WordPress’ export tool. Let’s assume your export file is named
Your database does not include the media elements such as images, videos, PDFs, etc. that you uploaded to your WordPress blog. These are stored separately in one or more folders of your WordPress hosting space. You need to gather all such media files from the appropriate WordPress directory(ies) and save them in a folder, let’s call this folder
This folder should include all the images (PNG, GIF, JPG…) or videos (MPG, M4V…) or documents (DOC, PDF…) that you have uploaded and attached to your WordPress posts.
Note: these are the files you have uploaded to your blog, not the resources you have linked to. If you one of your posts references an image on another site, you do not need to worry about that image.
Optionally, you may make a ZIP file of
wpblog_files. This ZIP file could be called
wpblog.zip.Note: You don’t have to make this ZIP file but it might make the upload process easier when you transfer your export to b2evolution.
You must upload your files into b2evolution’s
You can do this using your usual FTP client, by using b2evolution’s file manager, or even by clicking Upload/Manage import files on the screen shown above.
If you made a ZIP file, upload it into
If you didn’t make a ZIP file, make sure you upload both your
wpblog.xml and your
wpblog_files folder into
Note: accepted names for the "files" sub-folder are:
- Assuming the xml file is named
- Generic names:
You should see a screen similar to the one depicted above. If you just uploaded your files and don’t see them, make sure to refresh the page.
You can see 3 different types of XML files listed:
- "Basic export (no attachments folder found)" : This means that b2evolution did not find any sub-folder containing attachments.
- "Complete export (attachments folder: xxx)" : This means that b2evolution did find a sub-folder containing attachments, as explained above.
- "Compressed Archive" : This means b2evolution found a ZIP archive that may or may not contain an appropriate XML file and attachments sub-folder. If you select such a ZIP file, b2evolution will attempt to decompress it into a sub-folder and use its contents.
To continue with the import process:
- Select the file you want to import.
- Select a Collection for import. New posts will be created in this collection. If you need a new collection, create it prior to launching the import tool.
- Select the Import mode
Replace: all the contents of the selected collection will be replaced by the contents of the imported file. This means that ALL the original content will be deleted (posts, comments, categories and tags).WARNING: Be very careful with this option – it could cause severe data loss.
- Append : all the contents of the imported XML file will be append to the existing contents of the destination collection. This allows to merge blogs. But this could also create many duplicates if you try the import process several times in a row.
- Click "Continue!"
The import process will run. If it encounters errors, especially missing image files, it will display those errors on screen. In such a case, it typically means you did not properly gather all your media files and/or did not upload them in a suitable location prior to running the import tool.
Created by • Last edit by on Sep 11, 2019