vBulletin 3.0.0 BETA 5 to Invision Power Board v1.2

Using the convertor

This document is designed to help you through the easy installation of our vBulletin convertor.
If you require any further help, please visit our forums.
Although this convertor has been tested thoroughly, it's always wise to back up your source files and vBulletin database before commencing with the conversion. If you wish to report a bug, please do so in our bug reports forum

Uploading the convertor files

This document assumes that you already have an Invision Power Board installed and working. You do not need to use the same mySQL database for Invision Power Board that your vBulletin uses - although you may if you wish.
Using your FTP client, navigate into the root Invision Power Board directory on your server.
This is the directory that holds the IPB index.php file.

From the convertor folder freshly unzipped onto your hard drive, move into the folder called "for_root_ipb_folder".
Upload the file 'conv_vb3.php' into the root IPB directory on your server.

Upload the directory 'conv_api' and it's contents (api_functions.php, api_mysql.php, api_template.php api_vb3.php, post_parser.php) into the root IPB directory so you have the following structure:
  • /forums/
  • /forums/conv_vb3.php
  • /forums/conv_api
  • /forums/conv_api/api_functions.php
  • ...etc

    Move into the folder called "for_ipb_sources" and upload "Login.php" to your Invision Power Board "sources" directory. This will enable your vB3 members to log in successfully.

    Running the convertor for the first time

    Access the convertor by typing in the URL to 'conv_vb3.php' in your web browser (eg: www.domain.com/forums/conv_vb3.php)
    When it loads, it will inform you that you have to configure the convertor before use.
    Click on the "configure" link.

    Configuring the convertor

    The configuration screen should hold little surprise. It requires that you input your vB mySQL information. If you're unsure of what it is, check in your 'vb/admin/conf.php' file for the information.

    You also need to input the amount of database rows converted per meta-refresh page. The amounts largely depend on your database size and server power. You can re-configure the convertor at any time, so if you find that the script times out or lags badly during a conversion, you may go back and change these values.

    Using the convertor

    The convertor is designed to be non-linear. This means that you can convert as many, or as few sections as you wish, you can also go back and re-convert at a later time if desired. Please note however, that each time you start converting a section, that sections tables will be emptied (eg, if converting forums, the DB table ibf_forums will be emptied).

    To convert a section, simply click on the "Convert" link

    Once all sections have been converted

    Please remember to remove the file 'vb2ibf.php' after the conversion has completed. Leaving public access to that file will allow anyone to convert again at will and get your vB DB log in details.

    YOU HAVE BEEN WARNED.

    Other Notes

    After converting forums, your board will be switched offline to protect your private forums. To turn the board back online, simply log into the Admin CP, Expand the "Board Settings" menu and click on "Board on/off".

    Take care in the uploading of the files and make sure it's uploaded into the root IPB directory on your server. When reporting bugs, please prefix the title with "vB" so our team knows what to do with the report.