Getting Started


Download, Unzip
After downloading the LiteRadius archive, to a convenient place on your computer, just extract it with an unzip tool of your choice. You should get a folder that is named the same as the release you downloaded, and that folder should contain the following:

1. lrx_x_x – The LiteRadius application folder
2. golf_graphics - LiteRadius demo folder
3. golf_locator.htm - LiteRadius demo page
4. sample data – Example location data files
5. readme.htm - Read me file

Specify the Database Connection Settings
Before copying LiteRadius to your website you must first manually edit the script database.php and specify the database connection settings.

With Notepad, or another program that can edit php files, open the file database.php found in the following directory:

lr_v32/warpcore/admin/config/database.php

In database.php you will find several database configuration variables, but only concern yourself with the following:


$db['default']['hostname'] = "localhost";
$db['default']['username'] = "your_db_username";
$db['default']['password'] = "your_db_password";
$db['default']['database'] = "your_db_name";
$db['default']['dbdriver'] = "mysql";

Change the variables to the right of the equal sign (=) to match your particular database settings, where:

• 'hostname' – For most Apache/MySql installations the database hostname name is typically “localhost”. Other systems may identify the local server domain by URL.
• 'username' - The database username.
• 'password' - The database password.
• 'database' - The name of your database.
• 'dbdriver' - The type of database installed on your server.

MySql is the recommended database to use.

1. 'mysql' => 'MySQL'

Additional database drivers will be tested and announced at a later date.

FTP to Your Server
Use any FTP client to upload all the LiteRadius folders and files to your web server. Uploading the sample data folder is not necessary. To a large degree, the location of the lrXX folder on your server will be determined by the structure and layout of your web site.

LiteRadius Setup
Once all the files have been uploaded to your server you will need to run the setup script and initialize the LiteRadius database. With your web browser access setup.php in the root of your installation directory. Typically this will be something like:

http://www.mywebsite.com/lr_v32/setup.php

There are three (3) steps in this initialization procedure and if you supplied the correct database connection settings in database.php (above), STEP 1 & STEP 2 should just verify everything is working. If there is a problem connecting to the database use STEP 1 & STEP 2 to help diagnose the problem.

STEP 3 will initialize the LiteRadius database and permit you to login to the admin control panel. Click "Create All Tables" button to initialize the database. Once the database tables are created the Records column should change from -- to a number and the button below should read "Drop All Tables". You should also see a link at the top of the page inviting you to login to the LiteRadius admin control panel.

Securing the Administration Interface
The administration interface to LiteRadius is password protected.

The default login is:

• username: admin
• password: search

It is advisable that you change the default login settings to a username and password of your choice. Login settings are under the menu: "Resources->Account Settings"

Enter Your Google API Key
In order to access the Google Maps website you must enter your API key in the Map Preferences section of the Configuration page. When you click the "Update Map Preferences" button your API key will be saved and passed to all LiteRadius operations that communicate with the Google Maps server.

You will also need to manually insert the following script in any page that will display a Google Map.

<script src="http://maps.google.com/maps?file=api&v=2&key=INSERT_YOUR_API_KEY_HERE" type="text/javascript"></script>

INSERT_YOUR_API_KEY_HERE must be replaced with the key generated in your Google user account (more on Google API keys...).

If you open the golf_locator.htm page you will see the above noted code. By replacing the INSERT_YOUR_API_KEY_HERE with your API key you will be able to run the demo locator.

Adding Location Data
You may add location data to LiteRadius by two methods:

1. individually adding locations one at a time in manual edit mode
2. uploading an entire file of locations all at once

For information on creating and importing location data please see Importing Location Data.

To help you in constructing your location data file and to test LiteRadius, immediately, there are several sample location data files. To test the default configuration of LiteRadius, upload the us_filter.txt or ca_filter.txt data file found in the data/sample_data directory.

The xx_filter.txt data files also illustrate Active Filtering and the files are designed to work with the sample Golf Course Locator web pages, supplied with LiteRadius.

Geocoding Data
Geocoding is a process that assigns latitude and longitude coordinates to an address. Once assigned, the address can be displayed on a map and used in to find locations near another location. LiteRadius provides an interface utility that sends your addresses to Google™'s geocoder.

To geocode your location addresses select "Batch Geocode" from the "Location Data" menu. Then select a region to geocode (US, Canada, etc.) and click the "Geocode Region" button.

When finished, the page will display a list of addresses which could not be geocoded. For more information about the geocoding process, please see Geocoding Addresses.

Preview Data
After geocoding the location data you may Preview the Golf Course Locator by selecting "LiteRadius -> Show Demo golf_locator.htm" from the main admin menu.