Scriptalicious PageRank Script Manual v1.4

^ Back to Documentation

This manual contains installation, configuration and usage information for the Scriptalicious PageRank Checker script.

  1. Installing PageRank Script
    1. Downloading PageRank Script
    2. Preparing Configuration Files
    3. Uploading PageRank Script to your server
  2. Updating PageRank Script
  3. Configuring Your Site
  4. Customizing Your Site
    1. Customizing styles
    2. Installing templates
    3. Customizing templates
  5. Troubleshooting

Installing PageRank Script

Installing the script requires a PHP 4.x enabled server. Basic knowledge of FTP and an FTP client will be needed to upload the software to your server. If you are upgrading to a new version of the script, you should follow the steps in Updating.

Downloading PageRank Script

Once you have successfully purchased the script, you will receive an email containing download instructions. Follow those instructions to download the latest version of PR Checker to your computer in .ZIP format. Unzip the file on your desktop or somewhere easy to remember. You should now have a folder named tprc-x.x.zip (where `x.x` is the version number).

Preparing Configuration Files

Before uploading the script to your Web server, you will need to edit the file `config.php` and configure your site settings. At a minimum you need to set the values for DIR_BASE, PATH_BASE, and site_url. See the configuration section for details on config.php.

Once complete, save the changes to config.php and continue to uploading the script.

Uploading PageRank Script to your server

Using your favorite FTP client, upload the contents of the new folder to your Web server. Make sure you upload all files to the folder you want the site to run on. Usually this will be `public_html` or `htdocs`, but you can also upload the files to a subfolder or subdomain on your site.

Once all of your files have been uploaded, head to www.yourdomain.com in your favorite browser and your site should be up and running!

Upgrading PageRank Script

IMPORTANT: You should always backup your files before updating!

`tprc-x.x.zip` contains the files needed for a full installation. If you are running a heavily modified version of PageRank Script or have custom templates you may wish to download the changed files only. `tprc-x.x_changed-files.zip` contains the changed files only from releases previous to `x.x`.

Upgrading is easy and similar to the installation process. Download the full installation or changed files only to your computer in .ZIP format. Unzip the file on your desktop or somewhere easy to remember. You should now have a folder named tprc-x.x (where `x.x` is the version number).

Some updates include changes to the `config.php` file. If this file is included in the update, then before uploading the script to your Web server you will need to edit the file `config.php` and configure your site settings. At a minimum you need to set the values for DIR_BASE, PATH_BASE, and site_url. See the configuration section for details on config.php.

Using your favorite FTP client, you can now upload the contents of the folder to your Web server where you have installed PageRank Script. If you are upgrading and using the full download, upload all files in the `tprc-x.x` folder. If you are using changed files only to upgrade, upload the files from the appropriate folder for your installed version.

Make sure you upload all files, and make sure that you overwrite any existing files.

Important: If you are upgrading from v1.2 to v1.4 with the changed files only, you must add the following lines to the end of your config.php (before the closing PHP tag ?>):

// Set site META tags
$cfg->setVar('meta_keywords', '');
$cfg->setVar('meta_description', '');

// Set CAPTCHA for PageRank tool forms (1 = active, 0 = disabled)
$cfg->setVar('f_captcha', 0);

// Set CAPTCHA for Contact form (1 = active, 0 = disabled)
$cfg->setVar('contact_captcha', 1);

The above lines are required to use the new CAPTCHA controls. You can set the values as you see fit.

^ Back to top

Configuring Your Site

PageRank Checker Script uses one file for it's configuration settings: `config.php`. At a minimum you need to set the values for DIR_BASE, PATH_BASE, and site_url for your site to function properly. There are additional settings that you should configure for your site title, preferences, etc.

Below you can find all of the configuration settings available in config.php with descriptions and usage examples.

Setting Name Description Usage
DIR_BASE Relative path of your site, usually `/` define('DIR_BASE', '/');
PATH_BASE Full absolute path to the script folder define('PATH_BASE', '/path/to/home/');
site_url Full URL of your Web site including the trailing slash $cfg->setVar('site_url', 'http://www.yoursite.com/');
site_name Short site name $cfg->setVar('site_name', 'Site Name');
site_title Site title used in browser $cfg->setVar('site_title', 'Site Title');
contact_email Contact email address for site owner $cfg->setVar('contact_email', 'webmaster@yoursite.com');
template The active template name $cfg->setVar('template', 'default');
pr_maxhosts Max # of Google DCs you want to search $cfg->setVar('pr_maxhosts', 99);
pr_checklimit Max # of sites allowed in multiple PR checker $cfg->setVar('pr_checklimit', 25);
pr_image_default The default PR button image, and the image used in PR tools $cfg->setVar('pr_image_default', 'Google');
meta_keywords The META keywords field in your <HEAD> tag $cfg->setVar('meta_keywords', 'this,that');
meta_description The META description field in your <HEAD> tag $cfg->setVar('meta_description', 'My site.');
f_captcha Set CAPTCHA for PageRank tool forms (1 = active, 0 = disabled) $cfg->setVar('f_captcha', 1);
contact_captcha Set CAPTCHA for contact form (1 = active, 0 = disabled) $cfg->setVar('contact_captcha', 1);

^ Back to top

Customizing Your Site

Scriptalicious PageRank Script uses a custom template system that separates the HTML and CSS of your site from the PHP code. Templates are basically collections of HTML files with the .tpl extension, stylesheet files and image files.

Templates reside in the tpl/ folder in your script installation directory. Files for each template are stored in their own folder, and the folder name is used as the template name and identifier in PageRank checker script. The active template can be set in config.php.

Customizing styles

The easiest way to start customizing is to edit the style.css file residing in your template folder. The default location of this file is SCRIPT_PATH/tpl/default/style.css, where SCRIPT_PATH is the path to your installation of PageRank Script.

Installing templates

If you have downloaded a new template and unzipped it on your computer, you should have a folder containing all of the template files with the name templatename (replace with whatever the template happens to be named).

To install the template, upload the folder and it's contents to SCRIPT_PATH/tpl/, where SCRIPT_PATH is the path to your installation of PageRank Script. You can edit config.php to set this as your active default template.

Customizing templates

You may wish to customize some things that cannot be controlled with the CSS file, which means editing the template files. You can edit individual template files and save to see changes immediately.

It is recommended to make a copy of the default template folder default and work on the new template, so you can always revert back to the old template or refer to the old template files. Make a copy of the default folder and name it something short and easy to read - no spaces or special characters. For example, mytheme or bluesky. You can edit config.php to set this as your active default template.

You can now edit any template file, image or stylesheet you choose. Do not change the names of any template files or you risk breaking your site. The file structure of a template must remain intact.

Templates use template variables to access common settings and variables from PageRank Script. Template variables are identified in a template file with surrounding curly brackets. For example, adding { site_title } to a template will display the title of your site as set in Site Configuration. See the template variables list below for all available global template variables.

^ Back to top

Troubleshooting

For technical problems, bug reports and additional support please visit the Support Center. To discuss PageRank Script or find additional help please visit the Scriptalicious Forums.

^ Back to top


77 powerful SEO scripts for under $100.

Real-time Backlink Rank Checker script.


Scriptalicious is in no way affiliated with myspace.com® or Google®. Google, PageRank™ and MySpace are the trademarks of their owners.