Table of Contents

If you are currently running AutoRank Pro on one of your sites and would like to import it's data into a ToplistX installation, you can use the included arp-convert.php script to do just that. This document will outline the steps necessary to convert your AutoRank Pro data.


To convert your AutoRank Pro data you will need to be using any version in the 5.0.x series of AutoRank Pro. If you are not using one of these versions, follow the instructions in the AutoRank Pro software manual to upgrade your installation.

Converted Data

The conversion script will convert and import the following data from your AutoRank Pro installation: The conversion script will attempt to convert your ranking page templates to the new ToplistX format, however some template directives cannot be converted or may need some tweaking after the conversion is complete. Here are the known limitations of template conversion: Running From The Command Line

You will need shell access (through telnet or SSH) to your server to run the conversion script from the command line

The conversion script can be run from the command line of your server, and this is the recommended method if you have a large number of accounts and/or pages to convert (5,000+). The conversion process is the same as listed below, however instead of accessing the conversion script through your browser you will run it from the command line of your server using the PHP CLI executable. The command you will use will be something like this:

/usr/local/bin/php arp-convert.php /full/path/to/arp

Where /usr/local/bin/php is the full path to the PHP CLI executable on your server and /full/path/to/arp is the full path to the AutoRank Pro installation on your server.

Conversion Process

Follow the steps below to convert your AutoRank Pro data:

The conversion process will not affect your AutoRank Pro installation. The AutoRank Pro data will be left unchanged and you will be able to continue using AutoRank Pro as normal after the conversion has been completed.

Before you start the conversion you should process all pending and edited accounts in AutoRank Pro. Pending and edited account data will not be copied over to ToplistX, but if you process them first in AutoRank Pro the changes that you make will be imported.
  1. Install a clean copy of ToplistX on your server using the standard installation instructions. Do not add any accounts, categories, or setup any pages before you convert your AutoRank Pro data. Anything that you configure in ToplistX will be deleted during the conversion process. You will need to setup the ToplistX settings through the General Settings interface, however.

  2. When configuring the ToplistX settings, make sure you use a different Banner URL setting than what your AutoRank Pro installation is currently configured for. The ToplistX installation should not point to the same Banner URL as your AutoRank Pro installation.

  3. Once ToplistX is installed and has had it's initial settings configured through the General Settings interface, upload the arp-convert.php file from the utilities directory of the ToplistX distribution to the admin directory of your ToplistX installation on your server.

  4. Point your web browser to the arp-convert.php script that you uploaded to the admin directory of your ToplistX installation. This will load a page where you will need to enter the full directory path to the location of the AutoRank Pro installation on your server. This should point to the directory where the and files are located.

  5. Once you have filled in the directory path to your AutoRank Pro installation, you can press the Convert Data button. You will be asked to confirm that you do want to convert this data.

  6. The conversion script will run a few tests to make sure you have entered a valid directory path to your AutoRank Pro installation and that you have the correct version of AutoRank Pro installed. If any errors are encountered, it will display them and terminate the conversion process.

  7. If all of the pre-conversion tests pass, the script will begin converting your AutoRank Pro data. The conversion process can take anywhere from a few seconds to several minutes depending on the size of your member database. During the conversion process, the script will output some text to let you know what it is doing. Don't be alarmed if you don't see any text, as some web servers will wait for the script to complete before outputting the information it is generating. You can also check the convert.log file which will be located in the data directory of your ToplistX installation.

  8. When the conversion process is complete you will see a message that says "Data conversion complete!" (check the convert.log file in the data directory of your ToplistX installation if you don't get output in your browser). You can login to your ToplistX control panel to check that all of the data has been properly imported.

  9. Run the Ranking Pages > Recompile Page Templates function to force the software to recompile all of the imported ranking page templates.
Once you have completed these steps, the coversion process is complete. You should remove the arp-convert.php file from your server to prevent it from being accidentally run again.

Forwarding Surfers

The above steps will import your members into ToplistX, however your member sites will still have their old links to AutoRank Pro on their sites. To deal with this, ToplistX includes a custom in.cgi script that you can use to forward surfers automatically to the new ToplistX URL. This is a drop in replacement for the AutoRank Pro in.cgi script, but will need to be configured before you upload it to your server. You can find the in.cgi script in the utilities directory of the ToplistX distribution. Open this file in a text editor and set the two variables at the top of the file - each variable has a comment above it that explains how it should be set.

Once the variables have been set, upload the in.cgi script to your server in ASCII mode replacing the AutoRank Pro in.cgi script. Be sure it's permissions are set to 755.