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


>> UPGRADING
   Please see 'doc/upgrade.txt'.
   

>> PRE-INSTALL
   Please check you have a PHP4.x or PHP5.x version installed with GDLib 2.x 
   and FreeType.
   
   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 note 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

   If you are not using MySQL and you want to use your standard charsets then the 
   fastest change is to edit aroundme.sql; search for 
   ") ENGINE=InnoDB DEFAULT CHARSET=utf8;" and replace with ");".
   
   
   
>> WHO SHOULD INSTALL
   This is a web site and should be installed by a web site systems 
   administrator (webmaster). An understanding of FTP, changing directory 
   privileges and web servers is required. We cannot support you if you are 
   not able to understand these things.
   
   
>> EASY INSTALL
   Please read the terms of the license prior to install. 3rd party classes 
   are included for ease. Please note, these are under separate licenses.
   
   This build has an included installer. Point your browser to the 
   install/installer/ directory and follow the instructions.
   
   
>> MANUAL INSTALL  
   
   1. Copy the files to a directory in your web server. CHMOD to 770 the 
      assets, cache and log directories. When uploading the fonts directory 
      please ensure that you transfer in binary mode.
	  
   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_prefix var to reflect your changes.

   3. Edit the aroundme/componenets/core/config/aroundme_core.config.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"
   

>> 6 STEP SETUP
   1. Register as a user. You will receive an email. COMPLETE STEP 2 BEFORE 
      READING THE EMAIL.
	  
   2. The user_id you have been assigned will be "1". This is insecure. We 
      recommend that you change the user_id to be a random number between 1 
	  and 100000 by running the following SQL statement:
	  
	  UPDATE am_user set user_id=<random_number> where user_id=1;
      
      If you do this you will also need to update the auto increment value set 
	  against the table:
	  
	  ALTER TABLE am_user AUTO_INCREMENT =<random_number+1>
	  
   3. Following the instructions in the email complete the registration process.
      Once complete in the 'am_user' table edit your 'user_core_permission' 
      and change it to '63' (which will give you access to all areas). 
	  
	  UPDATE am_user set user_core_permission=63 where user_id=<random_number>;
	  
   4. Logoff and log in again.
	  
   5. start playing.
   
   
>> CRON
      send_announcement.php
	  When a user sends an annoucement send_announcement.php will send out X
	  announcements every time cron activates the script until there are no
	  more announcements to send.

	  The number of announcements send each time is defined by the
	  $batch_config['nr_per_batch'] config variable. As default
	  this is set to 25 per script excecution:

	  $batch_config['nr_per_batch'] = "25";

	  Setup a crontab that will send X announcements every Y times
	  per day. You should consider the number of projected users, the number of 
	  projected announcements, the number of mail servers and the processing
	  speed of your server when doing this. If you are unsure and you just 
	  want to get up and running set this to execute every 15 minutes:

	  10,25,40,55 * * * * /usr/local/bin/php -q /<your_path>/aroundme/batch/send_announcement.php

	  This will run at 10,25,40 and 55 minutes past each hour.

	  pending_user_cleanup.php
	  This file remove anyone who registered but did not complete setup more than 
	  24 hours ago.
	  
	  * 1 * * * /usr/local/bin/php -q /<your_path>/aroundme/batch/pending_user_cleanup.php
	  
	  This script will run at 01:00 daily.

	  bookmark_notification.php
	  This file sends an email to users who are tracking items. When an item 
	  has a comment added anyone tracking it will receive an email, thus this 
	  script should run frequently (example for send every 2 minutes).
	  
	  */2 * * * * /usr/local/bin/php -q /<your_path>/aroundme/batch/bookmark_notification.php
      
	  (the */2 is a special shortcut for 0,2,4,6,8...)

	

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





