$Id: INSTALL.txt,v 1.6.4.4 2008-08-14 22:16:17 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 (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.