Importing Content

From Habari Project

Need help Restoring a WordPress SQL file? This page is about importing directly from a WordPress database.

Habari currently ships with a plugin to import posts, comments, tags (including Ultimate Tag Warrior Tags) and users from WordPress (current version confirmed to work with 2.3.1, mileage will vary with older versions). Other importers are planned.

You must first activate the plugin before navigating to the admin/import page. After activating the plugin, you will get a select box to choose what type of content you are importing (as mentioned, WordPress is the only importer currently available).

One note about importing, due to the feature of importing users, you can not have the same user name in your Habari install at the time of import (this can easily be changed under admin/users/ ->edit, and change the name. You can change back after importing. Example, if your Habari install uses admin and your WordPress install uses admin, change your Habari name to admin2 for the import, and change it back after importing). For the upcoming .4 release, and as of revision 1319 this issue has been resolved.

You will then be prompted to fill in your WordPress database information, and choose your options for tag importation.

It is suggested you set up a separate database for your Habari install from that of your WordPress installation. The import process will be much faster and less room for error. WordPress pages should import as Habari pages, and everything else either an entry or draft.

Approved and unapproved comments should also be imported.

Note that WordPress permalinks and paths will be lost, and you should explore options with .htaccess if you are concerned with maintaining your previous links. Andrew da Silva's Route 301 plugin may help in some cases. Alternatively, you can set up a custom permalink scheme by adding a rewrite rule to your Habari database. Feel free to post to Habari users if you have any questions or problems with your migration.