$Id: INSTALL.txt,v 1.6.4.6 2008-09-23 04:53:40 boombatower Exp $

INSTALLATION
------------
1. Add the following code to the bottom of your sites settings.php file. Make
   sure you remove the white-space from the left so that the module will
   confirm that you have installed the code correctly. If you are running
   Windows make sure you encode the file with the UNIX standard or the
   code will not be detected.

   $GLOBALS['simpletest_installed'] = TRUE;
   if (preg_match("/^simpletest\d+$/", $_SERVER['HTTP_USER_AGENT'])) {
     $db_prefix = $_SERVER['HTTP_USER_AGENT'];
   }
2. It is hightly recommonded, but not neccessary, that you add the following
   code to install.php at the beginning of install_main(). Should look like
   7.x branch of Drupal core.

   // The user agent header is used to pass a database prefix in the request when
   // running tests.  However, for security reasons, it is imperative that no
   // installation be permitted using such a prefix.
   if (preg_match("/^simpletest\d+$/", $_SERVER['HTTP_USER_AGENT'])) {
     header('HTTP/1.1 403 Forbidden');
     exit;
   }
3. If there are any test modules they will be displayed on the admin modules
   page (admin/build/modules) unless the following code is added to
   modules/system/system.admin.inc in system_modules() just after:
   "$files = module_rebuild_cache();".

   // Remove hidden modules from display list.
   foreach ($files as $filename => $file) {
     if (!empty($file->info['hidden'])) {
       unset($files[$filename]);
     }
   }

3. Go to Administer >> Site building >> Modules (admin/build/modules) and
   enable the SimpleTest module.
4. Go to Administer >> Site building >> Testing (admin/build/testing) to
   begin using the module.
5. (Optional) Go to Administer >> Help >> SimpleTest (admin/help/simpletest)
   for more information on how to use the SimpleTest module.
6. (Optional) Go to Administer >> Site configuration >> SimpleTest settings
   (admin/settings/simpletest) to configure advanced settings.