Affero MOD for phpBB 2.0.x
    Copyright (C) 2003 Doug Kelly

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA

Doug Kelly <dougk@dougk-ff7.net>

To make this nice and simple, this MOD is distributed in two forms: full and 
patch.  The full distribution includes the regular phpBB 2.0.4 files, inculding 
the changes for the Affero MOD. The patch distribution includes the new Affero 
graphics a patch file, this file, and LICENSE, a copy of the GNU GPL.  
Updates to this package can be found at http://www.dougk-ff7.net.

To use the patch version (you need a copy of patch, as distributed with perl):
cd /path/to/phpBB2/
tar -xzvf affero-patch.tar.gz
patch -p0 < affero-patch-(version).diff

Where (version) is your current phpBB version (example: 2.0.3).  Note
that this process will upgrade you to phpBB 2.0.4, so you will need to
run the update_to_204.php script before anything else (this is done by
loading it in your web browser).

The final step is to load install_affero.php from your web browser, and enter
the requested information.  DELETE THIS FILE ONCE YOU ARE DONE INSTALLING THE
MOD.  This must be done with any version of the MOD to ensure the proper
configuration entries exist.

The steps to finish setting up your board with Affero are as follows:
(newer copies may be found at http://www.affero.net/bbsteps.html)
In order to complete the customization of the Affero services that you just 
integrated into your forums, you need to take the following simple steps: 

1. Join Affero 

2. Send an email to Affero at forumsetup@affero.com that includes the 
   following information: 
	-forum name and location (url) 
	-your affero username 
	-your contact information (email) 
	-your beneficiary information (formal name, address and url)
	 (only applicable if the beneficiaries you want are not already included 
	 in our database) 

3. Affero creates your Join/Hall of Fame page (this page links from your 
   forum Register page) 

4. This is the most involved step.  You must create default profiles for 
   each forum in your bulletin board. This is so when someone clicks on 
   the affero button of a non-affero member, the profile that appears is 
   appropriate for your community. To do this, in your Volunteer Preferences 
   page, you must create pay profiles for each forum that you have in your 
   message board.  The name of the pay profiles MUST follow the following 
   format: 
   forum id (which is the number of the forum and the root name of the forum).
   For example, the name of your pay profiles will look similar to this: 
   3.www.affero.com or 15.www.affero.com -- there must be no spaces in the name. 
   * Note for phpBB only - the root name of the forum may or may not be what you
     can use to access the forum.  The phpBB MOD uses a configuration option
     (which is set at install-time and not able to be changed through the admin
     panel).  If you do not know what it is, look at the phpbb_config table for
     the option "server_name".  A quick SQL query to find this is:
     SELECT * FROM phpbb_config WHERE config_name = 'server_name';
     This assumes your table prefix is "phpbb_". 

5. Send another email to forumsetup@affero.com with all the names of your 
pay profiles.  This will allow Affero to activate the default profiles with 
your forum. EACH TIME you add a new forum, you will also need to create an 
associated pay profile AND this information must be emailed to 
forumsetup@affero.com so we can coordinate the default profiles. 

6. Affero sends you an email letting you know everything is all set up and 
you are ready to go! 

This sounds like a bit of work, but it's quick and easy!  If you ever run 
into problems or questions with any of the steps above, please do not hesitate 
to contact forumsetup@affero.com.  We can walk you through each and every step. 

***IMPORTANT NOTE*** 
If you are using something other than the subSilver template, you must
contact us for proper integration, or look at the diffs, especially what I've
changed in the templates to make the proper changes.

Although I will not provide email support, I will provide a system for bug 
reports and support requests.  Please see http://www.dougk-ff7.net for details.

Thanks for using the Affero MOD for phpBB!
Doug Kelly
dougk@dougk-ff7.net
http://www.dougk-ff7.net