AutoRank PHP v2.0.x Installation

Unix/Linux Installation Instructions

If you need assistance with this software you must use the resources in the JMB Software owners lounge. See the bottom of this file for more details on obtaining technical support.

Unless otherwise noted, you are licensed to use the software on a single domain. If you would like to use the software on more than one domain, you will need to purchase additional licenses. Additional licenses may be purchased though the My Account interface in the owners lounge at a discounted rate.
  1. At this point it is assumed you have extracted the archive containing AutoRank PHP. If you have not yet done so, you should do that now. You should also have the following information on hand:

    - The name of the MySQL database which you will be using to store the data*
    - The username which you use to access the MySQL database
    - The password which you use to access the MySQL database

    If you do not have this information, contact your server administrator to get it.

    * In most cases, this name is not something you can just make up. The database must be created by you or your server administrator in order for you to use it. If you don't know the name of a database which you are allowed to use, contact your server administrator to get that information or to have them create a database for you.

  2. You will now need to login to your server and create some directories for AutoRank PHP. First off, decide where you want the software installed. Most servers do not allow PHP scripts inside the cgi-bin directory. Once you have decided where you want the software installed, change into that directory. Inside that directory you will need to create 5 subdirectories; name them cache, include, templates, data, and admin. Note: The only files you should place in these directories are the ones indicated in this documentation. Uploading other files can and will cause problems.

    Example Directory Structure:

    /home/username/htdocs/toplist
    /home/username/htdocs/toplist/admin
    /home/username/htdocs/toplist/data
    /home/username/htdocs/toplist/templates
    /home/username/htdocs/toplist/include
    /home/username/htdocs/toplist/cache


  3. Now you are ready to begin uploading the files to your server. It is recommended that you upload the files in ASCII mode, however on most servers it is not a requirement.

    Below is a table of where each file should be uploaded, using the example directory structure above:

    /toplist
    accounts.php
    arphp.php
    comments.php
    common.php
    http.php
    image.php
    in.php
    index.php
    init.php
    mysql.php
    new.php
    out.php
    quick.php
    random.php
    rate.php
    search.php
    sort.php

    /toplist/admin
    admin.php
    mail.php
    setup.php

    /toplist/data
    def.php
    errors.php
    lang.php
    tables.php

    /toplist/templates
    All files from the templates directory of the software distribution

    /toplist/include
    All files from the include directory of the software distribution

  4. Next, you will need to set permissions on the directories and files that AutoRank PHP will be using. If you are not sure how to set permissions, consult the documentation for your FTP client and/or contact your server administrator for more information. Below is a table containing the permissions you will need to set on each directory or file. If you do not see a file or directory listed, you do not need to change the permissions on it.

    File or Directory Permissions
    index.php, in.php, out.php 666
    lang.php 666
    errors.php 666
    All files in templates directory 666
    data directory 777
    admin directory 777
    include directory 777
    cache directory 777
    images directory 777

    These are only the recommended file permissions, and may need to be altered depending on your server configuration. Once you have all permissions set, continue to the next step.

  5. You are now ready to begin the web based portion of the setup. In your browser, type in the full URL to the init.php file on your server. A page will be brought up where you will need to enter your MySQL information. Once you have done so, press the button at the bottom of the page and the software will initialize itself. If any errors are encountered, a message will be displayed and you will need to correct them before continuing. Once you get a message that indicates the initialization is complete, you will be able to login to the software setup interface with the link provided on that page. The default login info to access the password protected administrative area is:

    Username: admin
    Password: admin

    If you cannot login with the admin/admin username and password or you see a message that your server does not have .htaccess password protection support, please see the htaccess.html documentation file for assistance.

    You will then be presented with a page where you will fill in variables and options for the software. After you have set all of the variables, click the button near the bottom of the page. If everything went well, you will be presented with a page telling you that the variables have been recorded, and some self tests will be done by the script. If all the tests pass, you are ready to go on. If any of them fail, you will need to check file permissions and directory settings. If you get any error messages after you press the button, you most likely have a permissions setting wrong.

  6. You should now be ready to begin using the software. The first thing you will want to do is point your browser to admin.php. Use the same login information as is listed above.

    Once inside the admin script you can start exploring the features, but make sure that you change the username/password combination soon after your initial installation. This can be done by selecting the Change Admin Password function from the first pull down menu. Make sure you use a password that contains a combination of letters, numbers, and symbols so that it is very difficult to guess.

  7. Help Prevent Software Piracy

    If you have uploaded the AutoRank PHP zip (or tar or tar.gz) file to your server, remove it now. Leaving it on your server provides a chance for other users to steal it from your web space. Make sure you never leave a copy of the software where other people can access it.

    Never share your software with anyone. The license you purchased is for your use only - you may not give the software to anyone under any circumstances. If you are caught doing this, you will be charged with software piracy and face fines up to $100,000.

    Never share your owners lounge username or password with anyone. Again, that is for your use only. We will never ask for you to send your password to us, so if you ever get an e-mail requesting it you should not send it.

    Do not upload the software documentation to your server or share it with anyone. We keep the documentation in the owners lounge so only legitimate customers can access it. This makes it much more difficult for users of pirated software to figure out how to use it.

    If you ever find a site that is offering our software for download, please contact us immediately so we can have the site shut down. Every time our software is pirated instead of purchased, it means less money for us to continue the development of that and future software.

After Installation is Complete

Once you have completed the installation you will want to get your ranking page setup and ready to accept new members. You should begin reading the overview.html documentation file so you can get an understanding of how the software works. This document includes all of the information you will need to begin working with the software.

Getting Tech Support For Your Software

If you need any assistance with this software, you must use the resources in the JMB Software owners lounge. This is the only way to contact the tech support department. Use the following URL, and the login information you selected when you purchased the software:

http://www.jmbsoft.com/owners/

Important Tech Support Notes:

If you edit the scripts in any way other than described above, you will no longer be eligible for technical support. We absolutely cannot provide support for edited copies of our software.

The only way we provide support for our commercial scripts is through the owners lounge. We do it this way to make sure we are providing support only to those who have paid for the scripts and deserve it. If you post a message at the Freeware Help Board it will be deleted - you must post on the Owners Lounge board. Also, sending a plain e-mail to us will be ignored, you must use the tech support request form in the Owners Lounge.

These methods also help to ensure that we are not wasting our time providing support for illegal copies of our software, and will result in faster responses to legitimate owners questions.

Thank You, and enjoy your new software!