[Zope-CVS] CVS: Products/CompositePage - README.txt:1.1

[Shane Hathaway]

Update of /cvs-repository/Products/CompositePage
In directory cvs.zope.org:/tmp/cvs-serv19957

Added Files:
	README.txt 
Log Message:
Added partial README

=== Added File Products/CompositePage/README.txt ===


Introduction
============

CompositePage is a new way to assemble pages for the World Wide Web.
Through the use of Zope technology, browser-based drag and drop, and
custom context menus, CompositePage makes it easy to visually combine
page fragments into complete pages.

CompositePage supercedes the PageDesign product and makes use of
PDLib, a Javascript library.  CompositePage is designed for browsers
that support the DOM (Document Object Model) and CSS (Cascading Style
Sheets) level 2: Mozilla, Internet Explorer 5+, Opera, Konqueror, etc.


How to use CompositePage
========================

Follow these steps:

- Install the CompositePage product in Zope by unpacking the archive
into your Products directory.  I've tested only with a current Zope
checkout, which is something like Zope 2.7.

- Create a Composite Tool instance in a central location, possibly the
root folder.

- Create a Composite object.  Turn on the "create a default template"
checkbox.

- Visit the Composite object and select the "Design" tab.  You should
see a three-column layout with blue dotted lines in the places where
you are allowed to insert content.

- Click just beneath one of the blue lines.  A context menu will pop
up.  Select "Add...".

- You will be directed to a slot (a folderish object.)  Using the
standard "Add" drop-down menu, add something that will generate an
HTML fragment (but not a whole HTML page) such as a script or
template.  Don't put too much effort into this, since you'll delete
the object later.

- Find the composite created earlier and select the "Design" tab
again.  Your new object should now show up in the slot.

- Move the object to a different slot using drag and drop.  When the
mouse cursor is hovering over a permitted target (the blue dotted
lines are targets), the target will be highlighted.  Let go and watch
your object appear in its new place.

- Right-click over your object and select "Delete" from the context
menu.


How it works
============




Scope
=====




Developer Notes
===============

CompositePage is currently completely insecure.  Anonymous users can
change composites.  Must fix. ;-)

CompositePage is only loosely tied into the ZMI (Zope Management
Interface).  The product has a way to plug into other user interfaces
like Zope4Intranets, CMF, and Plone.  Take a look at transformers.py
and the "zmi" and "common" subdirectories to see how this is done.

I would like CompositePage to work reliably with as many browsers as
possible, but Mozilla 1.4 is the current reference browser.  Try it in
your preferred browser.  If it acts strangely, try the same thing in
Mozilla 1.4 and send an email describing the differences.

Also, if anyone would like to volunteer some Zope Web space, I'd like
to post a public working demo of CompositePage.  Contact me if you
have room for it.