<html>
<head>
<title>Chapter 2: Using Zope</title>
</head>
<body bgcolor="#FFFFFF">
<h1>Chapter 2: Using Zope</h1>
<p> This chapter gets you up and running with Zope. It guides you
through installing and running Zope. This chapter covers the most
important Zope concepts. By the end of this chapter you should be
able to use Zope to create and manage simple yet powerful web
applications.</p><h2> Downloading Zope</h2>
<p> The first steps to using Zope are to download and install it. Zope is
available for free from the <a href="http://www.zope.org">Zope.org</a> web site.
The most recent stable version is always available from the
<a href="http://www.zope.org/Products">Download</a> section of Zope.org.</p><p> Zope is currently available as a binary for Windows, Linux and Solaris.
This means that you can just download and install it without having to
compile any programs. For other platforms you must download the source
and compile Zope. Zope can be compiled and run on almost any Unix-like
operating system. As a general rule of thumb, if
<a href="http://www.python.org">Python</a> is available for your operating system
and you have a C compiler, then you can probably use Zope.</p><h2> Installing Zope</h2>
<p> You will install Zope differently depending on your platform. If
you are running a recent version of Linux, you may already have
Zope installed. You can get Zope in both binary and source
forms. There are also several different binary formats available.</p><h3> Installing Zope for Windows</h3>
<p> Zope for Windows comes as a self-installing <em>.exe</em> file. To install
Zope, double click on the installer. The installer walks you through
the installation process. Pick a name for your Zope installation and
a directory to install it in. Click <em>Next</em> and create a new Zope user
account. This account is called the <em>initial user</em>. This creates an
account that you can use to log into Zope for the first time. You can
change this user name and password later if you wish.</p><p> If you are using Windows NT or Windows 2000, you can choose to
run Zope as a service. Running Zope as a service is a good idea
for a public server. If you are just running Zope for personal
use don't bother running it as a service. Keep in mind that if
you are running Windows 95, Windows 98, or Windows ME (Millenium
Edition), you cannot run Zope as a service.</p><p> If you decide to uninstall Zope later you can use the
<em>Unwise.exe</em> program in your Zope directory.</p><h3> Downloading Linux and Solaris Binaries</h3>
<p> Download the binary for your platform and extract the tarball:<pre> $ tar xvfz Zope-2.4.0-linux2-x86.tgz</pre>
</p><p> In this example, you are downloading version 2.4.0. This may
not be the most recent version of Zope when you read this, so be
sure and get the latest <em>stable</em> version of Zope for your platform.</p><p> This will unpack Zope into a new directory. Enter the
Zope directory and run the Zope installer script:<pre> $ cd Zope-2.4.0-linux2-x86
$ ./install</pre>
</p><p> The installer will print information as it installs Zope. Among
other things, it will create a initial user account. You can
change the initial user name and password later with the
<em>zpasswd.py</em> script (see Chapter 7, "Users and Security").</p><p> The installer will configure Zope to run as your UNIX userid. If
you prefer to run Zope as another userid, you can use the <code>-u</code>
command line switch and specify the user you want to configure
Zope to run as. There are many books out there with more
information on userids and UNIX administration in general you
should check out if you want to do anything fancy. For now
things will work fine if you just install Zope to runs as your
userid by not specifying any extra command line options.</p><p> For more information on installing Zope see the installation
instructions in <em>doc/INSTALL.txt</em> and find out more about the
installer script by running it with the <code>-h</code> help switch:<pre> $ ./install -h</pre>
</p><h3> Getting Zope in <em>RPM</em> and <em>deb</em> format</h3>
<p> Zope Corporation doesn't make Zope available in RPM format, but
other people do. Jeff Rush regularly packages Zope as RPMs. For
more information check out his <a href="http://www.taupro.com/Downloads/Zope/">web page
(http://www.taupro.com/Downloads/Zope/)</a>.
Zope is also available in the Debian Linux <em>deb</em> package
format. You can find Zope deb packages at the <a href="http://packages.debian.org/zope">Debian web
site</a> site. Generally the latest
Zope releases are found in the <em>unstable</em> distribution.</p><h3> Compiling Zope from Source Code</h3>
<p> If binaries aren't available for your platform, then chances are
you can compile Zope from the source. To do this, install
Python from the sources for your platform and make sure you have
a C compiler. You can get Python from the
<a href="http://www.python.org">Python.org</a> web site. Although we try
and use the most recent Python for Zope, often the latest Python
version is more recent than the version we "officially" support
for Zope. For information on which version of Python you need
to compile Zope with, see the release notes on the Web page for
each version. Zope 2.4 requires Python 2.1. Zope 2.3 and earlier
versions used Python 1.5.2.</p><p> Download the Zope source distribution and extract the
tarball:<pre> $ tar xvfz Zope-2.4.0-src.tgz</pre>
</p><p> This unpacks Zope into a new directory. Enter the Zope directory and
run the Zope installer script:<pre> $ cd Zope-2.4.0-src
$ python wo_pcgi.py</pre>
</p><p> The installer compiles Zope and sets up your installation. The
installer prints information as it runs, including the initial
user name and password. It's important to <em>write down</em> that
information so you can log into Zope. For more information see
the installation instructions in the file <em>doc/INSTALL.txt</em>. You
can change the initial user account later with the <em>zpasswd.py</em>
script (see Chapter 7, "Users and Security").</p><h2> Starting Zope</h2>
<p> Depending on your platform, you run Zope with different
commands. Whatever your platform, you can either run Zope
manually, or automatically. When running Zope manually, you simply
tell Zope when to start and when to stop. When running Zope
automatically, Zope will start and stop when your computer starts
and stops.</p><h3> Starting Zope On Windows</h3>
<p> The installer creates a Zope directory with a batch file called
<em>start.bat</em>. Double click the <em>start.bat</em> icon. This will open
a window that includes logging information. On this window you
find out what port Zope is listening on. You can now log into
Zope with a web browser.</p><p> If you are running Zope as a service, you can start and stop
Zope via the Services control panel. Zope will write events to
the event log so that you can keep track of when your service
starts and stops. If you run Zope as a service you must know
what port Zope is running on, since you will not have direct
access to its detailed logging information.</p><p> Zope comes with its own web server. When you start Zope, its web
server starts. If you wish you can connect Zope to your existing
web server such as IIS, but this is beyond the scope of this
book. The <a href="http://www.zope.org/DocProjects/AdminGuide">Zope Administrator's
Guide</a> covers this
kind of material.</p><h3> Starting Zope on UNIX</h3>
<p> Run the <em>start</em> script:<pre> $ ./start &</pre>
</p><p> Zope will start running and will print logging information to
the console. You should see information telling you what port
Zope is listening on. You can now log into Zope with a web
browser.</p><p> Zope comes with its own web server. When you start Zope, its web
server starts. If you wish you can connect Zope to your existing
web server such as Apache, but this is beyond the scope of this
book. The <a href="http://www.zope.org/DocProjects/AdminGuide">Zope Administrator's
Guide</a> covers this
kind of material.</p><p> The <em>start</em> script can also be edited to start Zope with many
different options. How to customize your Zope startup is also
described in the Administrator's Guide.</p><h2> Logging In</h2>
<p> To log into Zope you need a web browser. Zope's interface is written
entirely in HTML, therefore any browser that understands modern HTML
works. Mozilla, and any 3.0+ version of Microsoft Internet Explorer or
Netscape Navigator will do.</p><p> To log into the management interface point your web browser to
Zope's management URL. The management URL for Zope is Zope's base
URL with <em>/manage</em> appended. Assuming you have Zope installed on
your local machine serving on the default port 8080, the
management URL is:<pre> http://localhost:8080/manage</pre>
</p><p> This URL usually works, but you may need to login to a different
machine than the one we show you here. To find out exactly which
URL to use, look at the logging information Zope prints as it
starts up. For example:<pre> ------
2000-08-07T23:00:53 INFO(0) ZServer Medusa (V1.18) started at Mon Aug 7 16:00:53 2000
Hostname: peanut
Port:8080
------
2000-08-07T23:00:53 INFO(0) ZServer FTP server started at Mon Aug 7 16:00:53 2000
Authorizer:None
Hostname: peanut
Port: 8021
------
2000-08-07T23:00:53 INFO(0) ZServer Monitor Server (V1.9) started on port 8099 </pre>
</p><p> The first log entry indicates Zope is running on a machine named
<em>peanut</em> and that the web server is listening on port
8080. This means that the management URL is
<em>http://peanut:8080/manage</em>. Later in the book we'll look at the other
servers referred to in the logging information.</p><p> After you enter Zope's management URL in your browser, your
browser will prompt you to log into Zope by providing a user name
and password. Type in the initial user name and password created
during the install process. If you don't know the initial user
name and password, then shut Zope down by closing its window, and
change the initial user password with the <em>zpasswd.py</em> script and
restart Zope. See Chapter 7, "Users and Security" for more
information about configuring the initial user account.</p><h2> Controlling Zope with Management Interface</h2>
<p> After you successfully login you see a web page of the Zope management
interface, as shown in <a href="#2-1">Figure 2-1</a>.</p><p> <a name="2-1"></a>
<img src="Figures/2-1.png" alt="The Zope management interface.">
<p><b>Figure 2-1</b> The Zope management interface.</p>
</p><p> The Zope management interface lets you control Zope within your web
browser.</p><h2> Using the Navigator</h2>
<p> The Zope management interface is broken into three frames. With
the left frame you navigate around Zope much like you would
navigate around a file system with a file manager like Windows
Explorer. This frame is called the <em>Navigator</em>, and is shown in
the left frame of <a href="#2-1">Figure 2-1</a>. In this frame you see the root folder
and all of its subfolders. The root folder is in the upper left
corner of the tree. The root folder is the "top" of
Zope. Everything in Zope lives inside the root folder.</p><p> Some of the folders have plus marks to the left of them. These
plus marks let you expand the folders to see the sub-folders
that are inside.</p><p> Above the folder tree Zope shows you login information in a
frame. In this screen shot you can see that you are currently
logged in as "manager". When you log in to Zope you will use the
initial user account and you will see the name of this account in
place of "manager".</p><p> To manage a folder, click on it and it will appear in the right-hand
frame of the browser window. This frame is called the <em>workspace</em>.</p><h2> Using The Workspace</h2>
<p> The right-hand frame of the management interface shows the
object you are currently managing. When you first log into Zope
the current object is the root folder, as shown in the right
frame of <a href="#2-1">Figure 2-1</a>. The workspace gives you information
about the current object, and lets you change it.</p><p> Across the top of the screen are a number of tabs. The currently
selected tab is highlighted in a lighter color. Each tab takes you
to a different <em>view</em> of the current object. Each view lets you
perform a different management function on that object.</p><p> In <a href="#2-1">Figure 2-1</a>, you are looking at the <em>Contents</em> view of the root
folder object.</p><p> At the top of the workspace, just below the tabs, is a description
of the current object's type and URL. On the left is an icon
representing the current object's type, and to the right of that
is the object's URL.</p><p> In <a href="#2-1">Figure 2-1</a> "Folder at /" tells you that the current object is a
folder and that its URL is <code>/</code>. Note that this URL is the object's
URL relative to Zope's base URL. So if the URL or your Zope site was
<em>http://mysite.example.com:8080</em>, then the URL of the "Folder at
/myFolder" would be <em>http://mysite.example.com:8080/myFolder</em>.</p><p> As you explore different Zope objects, you find that the URLs (as
displayed in the management screen), can be used to navigate between
objects.</p><p> For example, if you are managing a folder at <em>/Zoo/Reptiles/Snakes</em>
you can return to the folder at <em>/Zoo</em> by clicking on the word <em>Zoo</em>
in the folder's URL.</p><p> In the frame at the top of the management interface, your current
login name is displayed, along with a pull-down box that lets you
select:<dl>
<dt> Preferences</dt>
<dd>Here, you can set default preferences for your
Zope session, you can even set to hide the top frame.</dd>
<dt> Logout</dt>
<dd>Selecting this menu item will log you out of Zope.</dd>
<dt> Quick Start Links</dt>
<dd>These are quick links out to Zope
documentation and community resources.</dd>
</dl>
</p><h2> Understanding Users in Zope</h2>
<p> Zope is a multi-user system. You've already seen how you can log
into Zope via the management interface with the initial user name and
password. Zope supports other kinds of users:</p><dl>
<dt> Emergency User</dt>
<dd>The emergency user is rarely used in Zope. This
account is used for creating other user accounts and fixing things if
you accidently lock yourself out.<p> The emergency user is both very powerful and very weak. It is
not restricted by most security controls. However, the
emergency user can only create one type of object: Users. Using
the Emergency User to repair your Zope system in the case of
accidental lock-out is discussed in the <a href="http://www.zope.org/DocProjects/AdminGuide">Administrator's
Guide</a>.</p></dd>
<dt> Manager</dt>
<dd>The Manager is the Zope workhorse. You will need to log in
with the Manager account to do most of the work involved with
building Zope web sites. The initial user is a Manager, and you can
create as many Manager accounts as you need.</dd>
<dt> Others</dt>
<dd>You can create your own kind of users that fit into
groups, or are responsible for carrying out a role that you
define. This is explained more in Chapter 7, "Users and Security",
which discusses Zope security and users.</dd>
</dl>
<h2> Creating Users</h2>
<p> Managers can create Zope users in a unique kind
of folder called a <em>User Folder</em>.</p><p> User folder icons look like folders with a person on them. User
folders always have the name <em>acl_users</em>, as shown in <a href="#2-1">Figure 2-1</a>.</p><p> Click on the acl_users folder in the root folder to enter it. User
folders contain User objects. You can create new users and edit
existing users. Click the <em>Add</em> button to create a new user, as
shown in <a href="#2-2">Figure 2-2</a>.</p><p> <a name="2-2"></a>
<img src="Figures/2-2.png" alt="Adding a new user.">
<p><b>Figure 2-2</b> Adding a new user.</p>
</p><p> Fill out the form to create a new user. In the <em>Name</em> field put
your chosen user name. Choose a password and enter it in the
<em>Password</em> and <em>(Confirm)</em> fields. Leave the <em>Domains</em> field
blank. This an advanced feature and is discussed in Chapter 7,
"Users and Security". Select the <em>Manager</em> role from the <em>Roles</em>
select list. Then click the <em>Add</em> button.</p><p> Congratulations, you've just created a manager account. Zope will
show you this new manager account inside the user folder. Later you
can change or delete this user if you wish.</p><h2> Changing Logins</h2>
<p> To change your login select <em>Logout</em> from the top frame of the
management interface. You will be prompted to login again. To
change logins, enter a new user name and password.</p><p> To logout select <em>Logout</em> from the top frame of the management
interface and cancel the new login. You should see a message
telling you that you are logged out. If you try to access the Zope
management interface after you are logged out, you'll be prompted
to log in again. You can also logout of Zope by quitting your
web browser.</p><h2> Creating Objects</h2>
<p> The Zope management interface represents everything in terms of objects
and folders. When you build web applications with Zope, you spend most
of your time creating and managing objects in folders. For example, to
make a new manager account you create a user object in a user folder.</p><p> Return to the root folder by clicking on the top left folder in the
Navigator frame.</p><p> To add a new object to the current folder select an object from
the pull-down menu in the right frame labeled "Select type to
add...". This pull-down menu is called the <em>product add list</em>.</p><p> For example, to create a folder, select <em>Folder</em> from the product
add list. At this point, you'll be taken to an add form that collects
information about the new folder, as shown in <a href="#2-3">Figure 2-3</a>.</p><p> <a name="2-3"></a>
<img src="Figures/2-3.png" alt="Folder add form.">
<p><b>Figure 2-3</b> Folder add form.</p>
</p><p> Type "zoo" in the <em>Id</em> field, and "Zope Zoo" in the <em>Title</em>
field. Then click the <em>Add</em> button.</p><p> Zope will create a new folder in the current folder. You can
verify this by noting that there is now a new folder named <em>zoo</em>
inside the root folder.</p><p> Click on <em>zoo</em> to enter it. Notice that the URL of the folder is based
on the folder's id. You can create more folders inside your new folder
if you wish. For example, create a folder inside the <em>zoo</em> folder with
an id of <em>arctic</em>. Go to the <em>zoo</em> folder and choose <em>Folder</em> from the
pull-down menu. Then type in "arctic" for the folder id, and "Arctic
Exhibit" for the title. Now click the <em>Add</em> button. You always create
new objects in the same way:<ol>
<li> Go to the folder where you want to add a new object.</li>
<li> Choose the type of object you want to add from the pull-down
menu.</li>
<li> Fill out an add form and submit it.</li>
<li> Zope will create a new object in the current folder.</li>
</ol>
</p><p> Notice that every Zope object has an id that you need to specify in
the add form when you create the object. The id is how Zope names
objects. Objects also use their ids for their URLs.</p><p> Chapter 3, "Using Basic Zope Objects", covers all of the basic
Zope objects and what they can do for you.</p><h2> Moving Objects </h2>
<p> Most computer systems let you move files around in directories
with cut, copy and paste. The Zope management interface has a
similar system that lets you move objects around in folders by
cutting or copying them, and then pasting them to a new location.</p><p> To experiment with copy and paste, create a new folder in the root
folder with an id of <em>bears</em>. Then select <em>bears</em> by checking the
check box just to the left of the folder. Then click the <em>Cut</em>
button. Cut removes the selected objects from the folder and
places them on a clipboard. The object will <em>not</em>, however,
disappear from its location until it is pasted somewhere else.</p><p> Now enter the <em>zoo</em> folder by clicking on it, and then enter the
<em>arctic</em> folder by clicking on it. You could also have used the
Navigator to get to the same place. Now, click the <em>Paste</em> button to
paste cut object(s) into the current folder. You should see the <em>bears</em>
folder appear in its new location. You can verify that the folder has
been moved by going to the root folder and noting that <em>bears</em> is no
longer there.</p><p> Copy works similarly to cut. When you paste copied objects, the
original objects are not changed. Select the object(s) you want to
copy and click the <em>Copy</em> button. Then navigate to another folder and
click the <em>Paste</em> button.</p><p> You can cut and copy folders that contain other objects and move many
objects at one time with a single cut and paste. For example, go to
the <em>zoo</em> folder and copy the <em>arctic</em> folder. Now paste it into the
<em>zoo</em> folder. You will now have two folders inside the <em>zoo</em> folder,
<em>arctic</em> and <em>copy of arctic</em>. If you paste an object into the same
folder where you copied it, Zope will change the id of the pasted
object. This is a necessary step, as you cannot have two objects with
the same id in the same folder.</p><p> To rename the <em>copy of arctic</em> folder, select the folder by checking
the check box to the left of the folder. Then click the <em>Rename</em>
button. This will take you to the rename form as shown in <a href="#2-4">Figure 2-4</a>.</p><p> <a name="2-4"></a>
<img src="Figures/2-4.png" alt="Renaming an Object">
<p><b>Figure 2-4</b> Renaming an Object</p>
</p><p> Type in a new id "mountains" and click <em>OK</em>. Zope ids can consist
of letters, numbers, spaces, dashes underscores and periods, and
are case-sensitive. Here are some legal Zope ids: <em>index.html</em>,
<em>42</em>, and <em>Snake-Pit</em>.</p><p> Now your <em>zoo</em> folder contains an <em>arctic</em> and a <em>mountains</em>
folder. Each of these folders contains a <em>bears</em> folder. This is
because when we made a copy of the <em>arctic</em> folder it also copied the
<em>bears</em> folder that it contained.</p><p> If you want to delete an object, select it and then click the <em>Delete</em>
button. Unlike cut objects, deleted objects are not placed on the
clipboard and cannot be pasted. In the next section we'll see how we
can retrieve deleted objects.</p><p> Zope will not let you cut, delete, or rename a few particular
objects in the root folder. These objects include <em>Control_Panel</em>,
<em>standard_html_header</em>, <em>standard_html_footer</em>, and
<em>standard_error_message</em>. These important objects are necessary
for Zope's operation. Also, these operations don't work in some
cases. For instance, you can't paste a user object into a regular
folder.</p><p> If you are having problems with copy and paste, make sure that
you have enabled cookies in your browser. Zope uses cookies to keep
track of the objects that you cut and copy.</p><h2> Undoing Mistakes</h2>
<p> Any action in Zope that causes objects to change can be undone, via the
<em>Undo</em> tab. You can recover from mistakes by undoing them.</p><p> Select the <em>zoo</em> folder that we created earlier and click
<em>Delete</em>. The folder disappears. You can get it back by undoing the
delete action.</p><p> Click the <em>Undo</em> tab, as shown in <a href="#2-5">Figure 2-5</a>.</p><p> <a name="2-5"></a>
<img src="Figures/2-5.png" alt="The Undo view.">
<p><b>Figure 2-5</b> The Undo view.</p>
</p><p> Select the first transaction labeled <em>/manage_delObjects</em>, and click
the <em>Undo</em> button.</p><p> This action tells Zope to undo the last transaction. You can verify
that the task has been completed by making sure that the <em>Zoo</em> folder
has returned.</p><h2> Undo Details and Gotchas</h2>
<p> Undo works on the object database that Zope uses to store all
Zope objects. Changes to the object database happen in
transactions. You can think of a transaction as any change you
make to Zope, such as creating a folder or pasting a bunch of
objects to a new place. Each transaction describes all of the
changes that happen in the course of performing the action.</p><p> You cannot undo a transaction that a later transaction depends upon.
For example, if you paste an object into a folder and then delete an
object in the same folder you might wonder whether or not you can
undo the earlier paste. Both transactions change the same folder so
you can not simply undo the earlier transaction. The solution is to
undo both transactions. You can undo more than one transaction at a
time by selecting multiple transactions on the <em>Undo</em> tab and then
clicking <em>Undo</em>.</p><p> Another problem to be aware of is that you cannot undo an
undo. Therefore if you add a folder and then undo that particular
action, you cannot get the new folder back by undoing the undo.</p><p> One last note on undo. Only changes to objects stored in Zope's
object database can be undone. If you have integrated data in a
relational database server such as Oracle or MySQL (as discussed
in Chapter 12, "Relational Database Connectivity") changes to data
stored there cannot be undone.</p><h2> Administering and Monitoring Zope</h2>
<p> The Control Panel is an object in the root folder that controls various
aspects of Zope's operation.</p><p> Click on the <em>Control_Panel</em> object in the root folder, as shown in
<a href="#2-6">Figure 2-6</a>.</p><p> <a name="2-6"></a>
<img src="Figures/2-6.png" alt="The Control Panel">
<p><b>Figure 2-6</b> The Control Panel</p>
</p><p> To shutdown Zope, click the <em>Shutdown</em> button. Shutting down Zope will
cause the server to stop handling requests and completely exit from
memory. You will have to manually start Zope to continue using it. Only
shutdown Zope if you are finished using it, and have the ability to
access the server on which Zope is running, so that you can manually
restart it later.</p><p> If you are running Zope on UNIX under daemon control or as a service on
Windows, you can restart Zope from the control panel folder. Clicking
the <em>Restart</em> button will shut down Zope and then immediately start up
a new instance of the Zope server. It may take Zope a few seconds to
come back up and start handling requests.</p><p> On the control panel you will also see several links at the bottom of
the screen, one of which is <em>Database Managment</em>, which controls
Zope's object database.</p><p> Transactions don't go away until you pack the Zope database. This
means that you can undo all transactions except ones that have been
removed by packing the database. When you choose to pack the database
you can specify which transactions to remove so that you can for
example only remove transactions older than a week.</p><h2> Using the Help System</h2>
<p> Zope has a built in help system. Every management screen has a help
button in the upper right-hand corner. This button launches another
browser window and takes you to the Zope Help System.</p><p> Go to the root folder. Click the Help button, and you should see what
is shown in <a href="#2-7">Figure 2-7</a>.</p><p> <a name="2-7"></a>
<img src="Figures/2-7.png" alt="The Help System.">
<p><b>Figure 2-7</b> The Help System.</p>
</p><p> The help system has an organization similiar to the two primary
panes of the Zope management interface, it has one frame for
navigation and one for displaying the current topic.</p><p> Whenever you click the help button from the Zope management screen, the
right frame of the help system displays the help topic for the current
management screen. In this case, you see information about the
<em>Contents</em> view of a folder.</p><h2> Browsing and Searching Help </h2>
<p> Normally you use the help system to get help on a specific
topic. However, you can browse through all of the help content if you
are curious, or simply want to find out about things besides the
management screen you are currently viewing.</p><p> The help system lets you browse all of the help topics in the
<em>Contents</em> tab of the left-hand help frame, as shown in
<a href="#2-7">Figure 2-7</a>. You can expand and collapse help topics. To view a help
topic in the right frame, click on it.</p><p> All help on the Zope management screens is located in the <em>Zope
help</em> folder. Inside you'll find many help topics. You'll also
find a help folder called <em>API Reference</em>. This folder contains
help on scripting Zope, which is explained further in Chapter 9,
"Advanced Zope Scripting".</p><p> When you install third-party components they also include help that
you can browse. Each installed component has its own help folder.</p><p> Search the help system by clicking on the Search tab and entering one
or more search terms. For example, to find all of the help topics
that mention folders, type "folder" into the search form.</p><h2> Starting with the Zope Tutorial </h2>
<p> Zope comes with a built-in tutorial. The tutorial guides you
through all the basics of creating and managing Zope objects. To
launch the tutorial, add a Zope Tutorial to the current folder by
selecting <em>Zope Tutorial</em> from the Product add list. Give it an id
which is unique in the current folder, such as <em>tutorial</em>. The
tutorial comes with several examples that you can change and copy
for your own use.</p><p> If you start the tutorial and want to stop using it before you have
completed all the lessons, you can later return to the tutorial. Just
go to the help system and find the lesson you'd like to continue with
by browsing the <em>Zope Tutorial</em> help folder. There is no need to
re-install the tutorial.</p><p> If you are having problems with the tutorial, make sure to enable
cookies in your browser. The tutorial uses cookies to keep track
of where your example objects are. Also, if you enable Javascript
in your browser, the tutorial will make sure that the Zope
management interface stays in sync with your tutorial lesson.</p><p> Now that you have Zope running, it's time to explore the system
more thoroughly. You've seen how to manage Zope through the web
and have learned a little about Zope objects. In the next chapter
you'll meet many different Zope objects and find out how to build
simple applications with them.</p></body>
</html>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
8b32d38f0094104a5fd847636983daa8
>
files
>
130
