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



>> 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 
   Image.class.php file to cope with a v1.x version.

>> INSTALL

   This software is in development. Version 0.3.3 is pre-alpha. You are most 
   definately looking at a work in progress. Do not expect much!

   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 prefic 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>", but remember to also 
      update the server_config file db_prefic var to reflect your changes.

   3. Edit the /config/config_server.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 in the database and change the 'level_id' column to the 
      admin priv value found in the aroundme config file: (default is 128)
      $c_node['user_level_id']['node_administrator']
   

>> 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)
	

   3. IMAGE HANDLING
   
	There are FTP vars in the config. We FTP to create a directory for user and 
	group images. If you are playing you do not need to configure these, however 
	you will get errors (no directory) when trying to upload images.
      	
>> 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.


>> Support

   See the http://www.barnraiser.org/aroundme/ .





