MANUAL INSTALLTION GUIDE

This guide will walk you through the process of manually installing Go2! Search: The PHP Edition (henceforth called in this document PHPSearch).

• Create a MySQL table for PHPSearch
  The first thing you need to do is create a MySQL table for PHPSearch to use. You can accomplish this by using a third party program such as MySQLMan from Gossamer Threads or phpMyAdmin from phpWizard or by telnetting directly into your server and manually creating a table. By telnet, first connect to your server using a telnet utility, most Windows machines have a program called “Telnet” in their accessories folder that can be used for this. Using “Telnet”, click “Remote System…” under the “Connect” menu. In the first box type your IP address and click the “Connect” button. You'll be prompted for your username and password, after which you'll be at a prompt. At the prompt type mysql -u username -p database, replacing username with your username and database with your database name. Press <Enter>. You'll be prompted to enter your password, after that you'll be presented with a MySQL prompt. At it copy & paste the text below (it will span several lines, this is okay) and press <Enter>. Your new table will be created.
  
  create table search(id int not null auto_increment,
  searchkey mediumtext,
  category mediumtext,
  email text,
  hits int,
  priority int,
  rating int,
  votes int,
  homepage longtext,
  url longtext,
  title mediumtext,
  description longtext,
  keywords longtext,
  other longtext,
  primary key(id)
  );
  

• Create the directories associated with PHPSearch
  PHPSearch needs four directories to be created. The first one is where the scripts will be placed, the second is where the templates will be uploaded, the third is the temp directory used internally by PHPSearch, and the fourth is the cache directory were the web page snapshots are kept. Here's the recommended directory layout, included are the permissions some of the directories must be set to:
  
  
  
  

• Configure the scripts
  Open config.php3, the main configuration file for PHPSearch. The variables you'll need to be most worried about now are:
  

• $templates
  This is the path to your templates directory, the one you just created.

• $temps
  This is the path to the temps directory you just made.

• $cache_dir
  Enter the path to your cache directory, the one you just created, here.

• $config_file
  This is the path to your config.php3 file, the file you're currently editing.

• $meta_search
  This is the URL to where your meta_search.php3 script will be uploaded (it is recommended that you put it in the phpsearch directory you were suggested to create in the last step)

• $remote_script
  This is the URL to where you will upload your remote_access.php3 script (keep all your scripts together in one place, whether it be in the recommended phpsearch directory or anywhere else you like)

• $results_script
  URL to where you'll put your read_results.php3 script.

• $track_script
  URL to track.php3

• $add_url_script
  URL to add_url.php3

• $spider_script
  URL to spider.php3

• $search_script
  URL to simple_search.php3

• $power_script
  URL to power_search.php3

• $cache_script
  URL to cache.php3

• $rate_script
  URL to rate.php3

• $shaded_radio
  This is the URL to the shaded radio button image you'll upload shortly (put it in the same directory as your scripts)

• $clocks
  URL to the directory in which you'll upload the clock face image.

• $mysql_host
  This is the host on which MySQL is, usually localhost.

• $mysql_user
  Your MySQL username.

• $mysql_password
  Your MySQL password.

• $mysql_database
  Your MySQL database name. If you have several databases, enter the one you created the search table in.

• $mysql_table
  The name of the search table you created in the first step.

Save the script (if you're editing with Notepad or any other similar text editor, be sure to choose “Save As…” and put quotes around the file name, changing it from config.php3 to “config.php3”, this prevents the program from appending its own extension to it).

• Open meta_search.php3, remote_access.php3, read_results.php3, track.php3, add_url.php3, spider.php3, simple_search.php3, power_search.php3, cache.php3, and rate.php3 and edited the require paths
  If you've put all of your scripts in the same directory, you don't need to worry about this step. If you've placed them in various locations, however, you'll need to edit the paths at the tops of the scripts for the required paths. For example, if your config.php3 is in /home/username/config/, change require("./config.php3"); to require("/home/username/config/config.php3");. Save the scripts as was described when editing config.php3.
  

• Upload all of the scripts
  Upload all of the scripts to the locations you said they'd be placed in config.php3. They do not need to be CHMODed, except for config.php3, which needs to be CHMODed 777 (rwxrwxrwx).
  

• Upload count.txt and addurl_count.txt to your temps directory
  Upload the files count.txt and addurl.txt to your temps directory, CHMOD them 777 (rwxrwxrwx).
  

• Upload all the templates to your templates directory
  Upload all the templates (all the files ending in .txt except for count.txt and addurl_count.txt) to your templates directory. They do not need CHMODing.
  

• Upload all the graphics
  Upload the graphics (files ending in .gif) to where you said they'd be in config.php3. If you followed the recommendations, this is your phpsearch directory.

PHPSearch is now installed and operational. To customize the look of your search engine, edit the templates in your templates directory. There are also several variables in config.php3 that will affect the look of your engine. If you're translating PHPSearch into another language, all text output not in the templates can be controlled through the text.php3 file. Your keyword targeted advertising is controlled through ads.php3, several examples are given as to the format, $target_ad['default'] is the default ad that will come up when no targeted ad can be found.

---