[Zope-PTK] Announcement: PTK 0.8.1 Release
Tres Seaver
tseaver@digicool.com
Mon, 7 Aug 2000 19:47:27 -0400 (EDT)
I have made two new snapshot tarballs available for the PTK:
* a "complete version",
http://www.zope.org/Products/PTK/ZopePTK-0.8.1-complete.tar.gz/view,
intended for new users and **most** existing sites;
* an "update version",
http://www.zope.org/Products/PTK/ZopePTK-0.8.1-update.tar.gz/view,
intended for sites which have customized the DemoPortal or Wizard
through-the-web products.
Existing site managers should read the change log and the installation
notes carefully, in order to minimize issues while upgrading.
-----------------------------------------------------------------------
Change Log
0.8.1
* Zope 2.2 compatibility
* Sample content types moved from PTKBase to PTKDemo:
- Document
- File
- Image
- Link
- NewsItem
- Discussion/DiscussionItem
*Note: existing portals will need to run a conversion
script; see the "Installation notes":install for
details.*
* Added DemoPortal and Wizard as "distribution tab"
products (e.g., they are present as directories in
the tarball). This makes installing the PTK for the
first time much simpler (untar, restart, and you're
there), but presents an issue for existing portals
which have customized the DemoPortal or Wizard products
(see the "Installation notes":install for details).
* Added portal/user/item toolbar actions.
* Added support for discussable content types (sample
content is all discussable).
* Separated membership from authenticataion; membership
now defined as a mix-in class on the portal.
* Add ZPL.
* Repair initialization-order dependencies for ZClass
products (build base ZClasses at module import, then
register them with the ProductContext during
'initialize()').
* Remove dependencies on LoginManager / ZPatterns products
(you can use them, but you no longer have to have them
to build a portal).
* Improve Wizards:
- Allow "Back" as well as "Next".
- Hold enough state to perform "preview".
- Extensions to allow use in editing, as well as
for construction.
0.8.0
Internal release only (Zope 2.2 compatibility test)
-----------------------------------------------------------------------
Installation Notes
The primary means of obtaining the PTK is via CVS.
Occasionally, snapshots are made available for those who
don't have the ability to check a copy out with CVS.
Obtaining and installing ZopePTK from a snapshot
PTK >= 0.8, new installation
Snapshots can be downloaded from the
"PTK page":http://www.zope.org/Products/PTK if any are
available.
To install a snapshot, extract it into the root of your
Zope server. For instance::
$ cd /usr/local/Zope2
$ tar xzf ~/downloads/ZopePTK-x.x.tar-complete.gz
Start or restart your Zope server.
PTK >= 0.8, existing, customized PTK installation
*If you have made changes you wish to preserve to the
DemoPortal or Wizard products (we **don't** advise this):*
Snapshots can be downloaded from the
"PTK page":http://www.zope.org/Products/PTK if any are
available.
To install a snapshot, extract it into the root of your
Zope server. For instance::
$ cd /usr/local/Zope2
$ tar xzf ~/downloads/ZopePTK-x.x.tar-update.gz
Start or restart your Zope server.
Migrating existing content objects
Existing instances of the sample content types (Document,
File, Image, Link, NewsItem) must be "reseated" to
fix up their class name in the ZODB. To perform this
operation, first update your PTK (see above), and then
view the following URL::
http://host.your.tld/path/to/portal/manage_migrate_contents
This method recursively walks your portal, finding and
replacing instances of the sample PTK content with
instances whose class is in the new, "blessed" location.
PTK < 0.8 (Zope 2.1.* only)
Snapshots can be downloaded from the
"PTK page":http://www.zope.org/Products/PTK if any are
available.
To install a snapshot, extract it into the root of your
Zope server. For instance::
$ cd /usr/local/Zope2
$ tar xzf ~/downloads/ZopePTK-x.x.tar.gz
Start or restart your Zope server.
Skip down to 'Completing the install'.
Obtaining and installing ZopePTK from the CVS
PTK >= 0.8 (Zope 2.2 only)
See
"Public CVS Access":http://classic.zope.org:8080/Community/CVS_public_access
for directions, substituting 'ZopePTK' for 'Zope2'.
After following the instructions of the Public CVS Access
page, you will end up with a directory called 'ZopePTK',
which will contain subdirectories. Copy the contents
of 'ZopePTK' to the 'Products' directory of your Zope
server.
Restart Zope.
Note that to refresh an existing CVS sandbox, you should
use 'cvs up -d -P' (assuming you want to remove obsolete
directories and retrieve any newly-added ones).
*N.B.: Sites which have customized DemoPortal or Wizard should
**not** copy the new DemoPortal or Wizard folders from
the CVS sandbox to the Products directory -- doing so
will replace you through-the-web changes!*
PTK < 0.8 (Zope 2.1.* only)
See
"Public CVS Access":http://classic.zope.org:8080/Community/CVS_public_access
for directions, substituting 'ZopePTK' for 'Zope2'.
After following the instructions of the Public CVS Access
page, you will end up with a directory called 'ZopePTK',
which will contain subdirectories. Copy the contents
of 'ZopePTK' to the 'Products' directory of your Zope
server.
Copy the file 'ZopePTK/PTKDemo/DemoPortal.zexp' to the 'import'
directory of your Zope server. You will need to create
this folder in the root of your Zope installation if you
have not already done so.
Restart Zope.
Continue with "Completing the Install"
Completing the install (PTK < 0.8)
Use a web browser to view your Zope Management Interface.
View the contents of your 'Products' folder. You should
see the 'PTKBase' and 'PTKDemo' products. Using the
'Import/Export' view, import the file 'DemoPortal.zexp'.
You must restart Zope again to fix the DemoPortal product.
It contains a ZClass instance ('PortalWizard') which is
always 'broken' until the next restart.
Kicking the Tires
If you now go to a suitable location, you should be able
to instantiate a Portal object. This is actually an
instance of the DemoPortal. Take a look at it's ZClasses
and the contents of the DemoApp folder in ZopePTK/PTKDemo
to see how it works.
--
===============================================================
Tres Seaver tseaver@digicool.com
Digital Creations "Zope Dealers" http://www.zope.org