VirtualHostFolder
-----------------
version 0.0.1

  Copyright &copy; 1999 Adam Feuer <adamf@pobox.com>

  This is alpha-quality, experimental software. Use at your own risk! 


What It Does
------------
  VirtualHostFolder allows you to have multiple virtual web sites on
the same Zope server, similar to Apache's VirtualHost feature. You can
create multiple VirtualHostFolders anywhere in Zope's object
hierarchy, set the IP address or the Site Name for the
VirtualHostFolder, and from then on, the Document Root for that IP
address or Site Name will be the VirtualHostFolder.
  In all other respects, VirtualHostFolders should be just like other
folders. They can contain any other Zope object.


Installing
----------
  This Product is made for Zope-2.0.1; it may not work on earlier
versions of Zope!

  Unzip the tar.gz file into a temporary directory. this tar.gz file
contains a patchfile and the tar.gz file that contains the
VirtualHostFolder-0.0.1 product. 
  Extract the product tar.gz file to your Zope install directory. You
will then need to patch Zope. The patchfile assumes your Zope
directory is called Zope-2.0.0-src. Change direcories to the parent
directory of Zope-2.0.1, and then use the following command:

% patch -p0 <VHF-patch00-Zope-2.0.1

  After applying the patch, restart Zope. 



How To Use It
-------------
  The VirtualHostFolder Product should show up on the regular
Available Objects drop down list in the management interface.
  You can add a VirtualHostFolder object anywhere in the folder
hierarchy. You should set the IP address or Site Name of the
VirtualHostFolder at creation time; you can change it later using the
Options tab.
  The IP address should be address should already be set up on the
system by the system administrator.
  The Site Name is the name of the site that will be found in the
HTTP/1.1 Host header.
  Both these items are optional.


Issues
------
VirtualHostFolder's dictionary of IP addresses or Site Name and Zope
path prefixes is stored in a private database, which lives in a
FileStorage file in Zope's data directory (usually var/ under the Zope
install directory). This is a huge kludge; the dictionary should be
stored in the Zope database. Hopefully this will be fixed in a future
release of VirtualHostFolder.

No validation is performed on the IP address or the Site Name. At
least some minimal validation should be done, if only to strip out
whitespace.

You should be able to have a list of IP addresses or Site Names in
each Virtual Host folder, not just a single one. 


Bugs
----
If you find any bugs or problems, let me know! Help is greatly
appreciated, too.


License
-------
  Since VirtualHostFolder contains code from Zope, and is meant to be
used with Zope, it is released under the the Zope Public License (ZPL)
1.0. This is an OpenSource-style license.
  For more information, see the file 'COPYING'.


cheers
adam

Adam Feuer
adamf at pobox.com (replace the 'at' with '@' to contact me via email)
http://www.pobox.com/~adamf/
