WordPress Importer

WordPress importer is a tool for importing content from your WordPress blog to Vivvo CMS. It can import:

• Categories - WordPress importer creates categories if they do not exist in Vivvo system. If a category exists, plug-in will synchronize existing and imported data.

• Tags - All tags that do not already exist in Vivvo CMS will be imported, and those that already exist will be synchronized.

• Articles, Pages and Comments - All articles with comments are imported. WordPress article pages are being imported as Vivvo static pages. Articles are connected to newly created of synchronized categories. If an article from WordPress is added to more than one category, importer will assign only one category to this article.

• Users - The script will import users (with preserved passwords) from WordPress to Vivvo while skipping users whose username or email address exist in Vivvo.

Prior to installing the plug-in itself, you need to install Pages plug-in. It is needed for static content display within Vivvo. For additional information go to Pages plug-in installation page (http://wiki.vivvo.net/user_manual/plugin_manual/pages).

It is presumed that you have fully functional Vivvo CMS v4.5. Copy WordPress Importer plug-in into Vivvo 4.5 plug-in folder.

You need to access the Plug-ins section. Click on the Plug-ins link which is located at upper right corner, near Log out button.

To install Wordpress importer you need to click on the install icon on the right side of the plug-ins name.

This will take you to the page with the installation link: Click here to Install the plug-in

After you run the installation, you will be informed that the plug-in was successfully installed.

You may easily go back to the Plug-ins page, by following the link: Click here to go to Plug-in

To uninstall WordPress importer you need to click on the uninstall icon on the right side of the plug-in name.

This will take you to the page with the link for uninstall: Click here to uninstall the plug-in

You will be informed that the plug-in was successfully uninstalled and you may return to the Plug-ins page by clicking the link: Click here to return to Plug-in home page.

Click on the Plug-ins link (which is located at upper right corner, near Log out button). Choose WordPress importer from the list of all installed plug-ins (on the left side of the screen).

This plug-in can be accessed only by users with administrator-level privileges.

Wordpress does not export users by default. In case you do not need to import WordPress users, you may proceed straight to back-up creation process.

If you'd like to import WordPress users to Vivvo you must install WordPress Export Users plug-in for WordPress first. The plug-in is included in the WordPress importer package in wp_export_users directory.

To install WP Export Users plug-in follow these steps:

1. Copy wp_export_users.php from /wp_export_users directory to your WordPress plug-in directory ({WP_DIR}/wp-content/plugins/)
2. Log-in to WordPress administration panel, go to Plug-ins section and activate WP Export Users plug-in.

Now you can create a backup file of your WordPress data. You should log-in to WordPress administration panel, go to Tools → Export section and click on Download Export File button. The backup should be uploaded then to VIVVO_ROOT/files/wp_importer folder (you need to set permissions for this folder to CHMOD 777 prior to importing actual backup file). You may upload via FTP or use Upload file feature in Vivvo Administration → Plug-ins → Wordpress importer.

Upload WP export file to /files/wp_importer via FTP client or via Upload File admin tool (under files or within WP importer plug-in) and then Import WP content. After that, we recommend you to Clean cache.

Go to the plug-ins page and find a backup listed on the right-hand side of the screen. To import previously created and uploaded backup, click on the Import icon next to its name.

A pop-up notice will appear and you need to confirm this in order to proceed: “This action will restore WordPress backup and will add new data to existing Vivvo database. In case you repeat action your data will be duplicated. Are you sure you want to continue?”

If confirmed, the process will execute and you'll be able to see the progress of the import on the right-hand side of the screen.

WP importer has some limitations:

• If an article from WordPress is added to more than one category, importer will assign only one category to this article.
• If a WordPress export is imported multiple times, there will be multiple instances of same articles.
• User passwords are not preserved. All imported users will be set as inactive and with Subscriber role. Vivvo Administrator must edit imported users to set all needed parameters before they can log-in to Vivvo.
• WordPress multiple menus are not imported.
• Images and files are not imported.

Wordpress Importer is released for Vivvo 4.5 and will not work in older versions.

1. [ENH] Orphan articles are put into Uncategorized category. If a category with such name does not exist, new one is created and set as “not visible”.
2. [CHG] User passwords are NOT preserved. All new user accounts are set as inactive and assigned Subscriber role.