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


>> UPGRADING
   Please see 'doc/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.
   
   Spell checking
   You can enable spell checking support (recommended) if your server supports
   Aspell. To Install Aspell follow the instructions at 
   http://aspell.sourceforge.net/ [Windows users please not the link 'Windows 
   Port' on the page. Follow that and install the 'Full installer']. After 
   you have installed please follow the link to 'Dictionaries' and install the 
   dictionionaries you require.
   
   Database
   The standard SQL statements we supply create InnoDB, a MySQL transaction-safe 
   storage engine. It has been designed for maximum performance when processing 
   large data volumes. Its CPU efficiency is probably not matched by any other 
   disk-based relational database engine. It has been proven to handle an average 
   load of 800 inserts/updates per second. You may wish to change this prior to 
   installation by editting the /install/aroundme.sql file.
   
   For more information: http://dev.mysql.com/doc/mysql/en/innodb-overview.html
   
   CHARACTER SETS
   Unicode provides a unique number for every character, no matter what the 
   platform, no matter what the program, no matter what the language. The Unicode 
   Standard has been adopted by such industry leaders including Apple, HP, IBM, 
   Microsoft, Oracle, SAP, Sun, Sybase and Unisys. Unicode is required by modern 
   standards such as XML, Java, ECMAScript (JavaScript), LDAP, CORBA 3.0, WML, 
   etc., and is the official way to implement ISO/IEC 10646. It is supported 
   in many operating systems, all modern browsers, and many other products.

   Unicode enables a single software product or a single website to be targeted 
   across multiple platforms, languages and countries without re-engineering 
   and allows data to be transported through many different systems without 
   corruption.
   
   We have adopted UNICODE for aroundme. In /install/aroundme.sql we create our 
   database tables using "CHARACTER SET utf8". We recommend that you use this.
   
   For more information:
   http://www.unicode.org/
   http://dev.mysql.com/doc/mysql/en/charset-unicode.html
   
   
>> 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
   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.

	  FTP note: When uploading a font to your website you have to set the 
	  transfer mode to binary.
	  
   2. Use the included install/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. [optional] If you require spell checking and you have Aspell installed 
      update the $c_node['node']['language']['aspell']['command'] variable to 
      include the path to you Aspell installation. Standard aspell installs 
      are:
        
        WINDOWS          '"C:\Program Files\Aspell\bin\aspell.exe"'
        GNU/Linux        "/usr/local/bin/aspell"

   5. 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.
   
   
>> CRON
   1. Set the $c_node['cron']['bulk_email'] config var to zero and then just 
      schedule the script send_newsletter.php
   

>> COMMON ERRORS
   1. No GDLIB Installed (Windows only)

	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 only)
	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
   See our community at http://build.barnraiser.org/ for support. If in doubt 
   contact Barnraiser and we will try to help you - http://www.barnraiser.org/





