Copyright (c) 2003-2005 Barnraiser. All rights reserved.
http://www.barnraiser.org/


>> UPGRADING
   Please see 'upgrade.txt'.
   

>> PRE-INSTALL
   Please check you have a PHP4.x version installed. We have not tested on 
   PHP5.x yet. You are welcome to try. GDLib 2.x needs to be installed. You 
   will see errors on a 1.x version. You are welcome to modify the 
   File.class.php file to cope with a v1.x version.


>> WHO SHOULD INSTALL
   This is a web site and should be installed by a web site systems 
   administrator (webmaster). Any understanding of FTP, changing directory 
   privileges and web servers is required. We cannot support you if you are 
   not able to understand these things.
   
   
>> INSTALL

   This software is in development. Version 0.4.2 is alpha. Expect bugs! 

   1. Please read the terms of the license prior to install. 3rd party classes 
      are included for ease. Please note, these are under separate license.

   2. Use the included aroundme.sql file to populate a database (you will need 
      to manually create a new database first). For development we recommend 
      using MySQL, however ADOdb supports many database types. Please note, we 
      have only tested this software with MySQL. No support for other databases 
      can be given at this time.

      You can edit the aroundme.sql file to change the prefix of the database 
      name´. By default this is "am_<database_table_name>", but if you wish 
      to have multiple instances of aroundme under one account you can edit this 
      to anything such as "am_dev_<database_table_name>" - remember to update 
	  the server_config file db_prefic var to reflect your changes.

   3. Edit the /config/config_aroundme.inc.php with your server and database 
      connection variables.

   4. Edit the .htaccess file and replace the 404 error URL with your own.
   

>> SETUP
   1. Register as a user and complete the registration process. Once complete 
      select the user from the am_user table in the database and change the 
	  'role_id' column to the $c_acs['arr_acs']['resource']['administration'] 
	  (admin privilege) value found in the config_acs.inc.php config file: 
	  (default is 101)
      
   2. Setup the administrator privileges. Insert the 'allow_access' privilege 
      into the am_acs_permission table. Default is:

      INSERT INTO `am_acs_permission` VALUES (1, 101, 1, 101);
	  
   3. Logoff and log in again. You will now see a "node admin" button appear at 
      the top of the page. Press that and select "acs". Check the boxes for the 
	  permissions for the administrator to grant yourself permissions throughout 
	  the system (recommended that you check all boxes in first column) and 
	  press "update permissions".
	  
   4. start playing.
   

>> Common Errors
   1. NO GDLIB INSTALLED (WINDOWS)

	You will need GDLib support active for uploading images. Php4.3.x and up 
	has this built in, but not activated:

	Now you should have a file named php.ini.dist (for this document we will 
	assume it to be in in this path "c:\php\"). Rename that to php.ini and copy 
	it to the root of you Windows directory, C:/WINDOWS/ (be sure to back up 
	the one that is there).
	
	change:
		extension_dir = ":/"
	to:
		extension_dir= " C:\php\extensions"

	uncomment to extension:
	
	change:
		;extension=php_gd2.dll
	to:
		extension=php_gd2.dll
		
	You must restart to see the changes take effect.
	
   2. SESSION ERRORS (WINDOWS)
	You will need to set up a session save path in php.ini. Edit php.ini:
	
	change
		session.save_path = "/tmp"
	to:
		session.save_path = "C:\tmp\"
	
	(C:\tmp\ used as example - you can change the directory path to suit you)

      	
>> UNSUPPORTED LANGUAGES
   You can add a language by translating the language files, adding an ID to the 
   config file and by updating set_locale function in the User.class.php file, but 
   we would be happier if you worked with us so that we add it and everyone gets it.


>> TECHNICAL SUPPORT

   Members and supporters can obtain direct support from Barnraiser. Other parties 
   should see the Savannah site for support. If in doubt contact Barnraiser and we will 
   try to help you - http://www.barnraiser.org/





