**********************************************
*******         Members onTap          *******
**********************************************

COPYRIGHT 2003 S. Isaac Dealey 

For the latest information about 
the onTap framework visit the website at 
http://ontap.riaforge.org 


-----------------------------------------------
= CONTENTS 
----------------------------------------------- 
- LICENSE 
- REQUIREMENTS 
- INSTALLATION 
- KNOWN ISSUES 
- SUPPORT 
- FOOTNOTES 


-----------------------------------------------
= LICENSE 
----------------------------------------------- 

The onTap framework and the Members onTap plugin 
are distributed under the terms of the 
OpenBSD open-source license. 
http://www.openbsd.org/policy.html


-----------------------------------------------
= REQUIREMENTS
----------------------------------------------- 

This plugin requires the onTap framework 
Version 3.0 beta build number 20071203 or later and 
Plugin Manager version 2.2 beta build 20071110 
or later, with at least one configured database. 


-----------------------------------------------
= INSTALLATION
----------------------------------------------- 

To use the Plugin Manager to install this component.

STEP 1: Download and install the onTap framework and 
the Plugin Manager from http://ontap.riaforge.org 
and http://plugtap.riaforge.org respectively 
Obviously skip this step if you've already installed them. 

STEP 2: Navigate to your Plugin Manager index page 
usually located at http://[ontap]/admin/plugins). 
Select the tab labelled "more" and use the provided 
form to upload the zip archive into your application. [1] 

STEP 3: Once the files have been coppied, use the Plugin Manager 
tool to install the Members onTap plugin by navigating to 
http://[ontap]/admin/plugins and selecting the New Plugins tab. 
Locate the Members onTap plugin in the list of plugins waiting 
to be installed and select the install button. 

STEP 4: Accept the licensing agreement. 

STEP 5: You'll be presented with a form to configure the plugin. 
When you submit the configuration form, the installer will begin 
creating database tables and installing files for your application. [2]

STEP 6: You're done! Once the member plugin is installed 
you will be returned to the Plugin Manager index. 
You can then test the installation of your plugin by 
visiting the member directory. By default this is 

http://[ontap]/members/ [3]

You can also view documentation for the plugin in the 
framework documentation site at http://[ontap]/docs 


-----------------------------------------------
= KNOWN ISSUES 
-----------------------------------------------

- Installer - 
The installer for this version has been entirely 
redrafted due to a wide variety of unknowns 
(ColdFusion version/configuration, operating system, 
database configuration, antivirus, etc, etc.) 
adversely affecting the previous installer. 

The new installer is much simpler, however, it 
will *PROBABLY* fail if you have your ColdFusion 
server settings configured to terminate requests 
after 60 seconds or less. This may also apply to 
a large number of shared hosting servers. 

The notebook used to develop the installer executed 
the installation request between 1.5 and 2 minutes. 


- EventLog - 
At time of release it is known that the search 
utility for the event log is not working. 

The EventManager for undo/redo may or may not 
work but has not been tested.

These will be updated and tested in a later release 


-----------------------------------------------
= SUPPORT 
-----------------------------------------------

As an open source project, there is no commercial 
support for the onTap framework. The framework is 
provided as is and without warranty. Time permitting, 
all questions, comments or criticisms of the 
framework will be answered by the author(s) or 
an agent of the author(s). 

For more information about the framework, visit the 
official website at http://ontap.riaforge.org 


=================
=== Footnotes ===
=================

* [1] 
If you have problems with the upload form, you 
can unzip the plugin manually into the Plugin Manager 
source directory. 

By default the source directory is located at 
[ontap]/_tap/admin/plugins/source 

The root /membersontap/ directory in the zip archive should 
be directly underneath the plugin source directory, i.e. 
[ontap]/_tap/admin/plugins/source/membersontap 

* [2] 
In our environment installation took approximately 
1.5 minutes with ColdFusion 8 on a notebook PC with a 
1.2ghz dual core processor and 1gb RAM. Time to install 
in your environment may vary - expect a longer wait 
with ColdFusion 7. 

If the installation stalls it may be hampered by a 
firewall or other software which could mangle the 
javascript in your browser. You can do two things. 

-first- You can check the source directory (see footnote 1) 
for an installationerror.htm file which is created 
when an error occurs during installation. 

-second- you can disable javascript in your browser, and 
attempt the installation again. The installer should 
have removed all the files allowing you to attempt 
the installation again, however, in some cases it may be 
necessary to start over with a clean installation of the 
framework and Plugin Manager. 

* [3] 
This is only the default location! 
You may have changed this path in the configutation form.