Zope Level Management
For the purposes of locating objects, the Silva installation is assumed to be ‘default’, where Silva is installed at the root level of a Zope instance, and named ‘silva’. All paths in this document begin with /silva.
- ZMI refers to the Zope Management Interface
- SMA refers to the Silva Management Anterface (where Silva Authors, Editors and Chief Editors work).
- ZPT is a Zope Page Template.
limit confusion, we rarely use the word ‘user’. Silva has several built
in roles (Author, Editor, Chief Editor, Manager). These are always
spelled with a capital letter.
- A person viewing public pages (anonymously) is a Visitor.
Let’s start with a few tips which are good to know.
If you’re logged in as a Manager, the breadcrumb trail contains an extra link: /manage... that takes you directly to the Zope manage_main in that location. The access key alt-. initiates the action immediately.
In the ZMI of the Silva root, “Silva /edit...” is the third tab. In between comes the “Services” tab, which contains Silva application logic, further detailed below.
In the ZMI on lower levels, there is now Services tab, and the second tab is called “Silva /edit...”. That takes you to the SMI at the current level.
A few key aspects are defined in the Zope properties tab of the Silva root. See the Properties section below (e.g. to change the help location).
Objects in the Silva root
What follows is a quick listing, with links to more information. Some of these items actually reside on the file system.
the ZMI, at /silva/manage or /silva/manage_main, you’ll see a number of
Zope and Silva objects. Silva objects are Publications, Folders,
Note that if Silva objects are present in the root publication, those items will be mingled in the contents listing as well.
Folder containing information about Silva members, i.e. Zope users who have been assigned a Silva specific role. Normally this folder should be left alone; the Member objects are created implicitly on demand. Removing a Member object does not revoke the roles from the corresponding user; it only removes the additional information available via the “user settings” page of the SMI.
ZPT that helps render public pages. See Template design
Cascading Style Sheet that determine the typographical styles in the Preview screen and public pages. See Template design
This folder (silva/globals) resides on the file system. It contains Silva user interface elements, and will be overwritten in an upgrade.
A Silva index document in the Silva root (or Silva ‘top’, as it’s called in the documentation for Author Editor/Chief).
A Python script that handles web requests. See Template design
ZPT macro that renders public pages. See Template design
A Python script that handles Silva previews. Will be covered in the Silva Developer documentation inside the Silva product download.
ZPT that can be used to create custom pages. See Template design
ZPT which displays an error message in Silva style (as opposed to Zope style).
ZPT which displays an unauthorized message in Silva style (as opposed to Zope style).
Silva Services are found in the Silva root in the ZMI. Click on the Services tab to see the list of Service options.
Some services have settings that can be modified. Configurable services have a title following the id, e.g.:
service_messages (Silva Message Service)
Other services have no adjustable settings; these don’t have a title.
If you click the id you’ll get a screen with a description of the
Configuration for Silva core and Extension Products. SilvaNews is an example of an extension – it’s not part of the Silva core – that must be installed separately. Your own and third party extensions can be installed and uninstalled here. See below for installing layout templates.
Controls storage of Silva File objects
Controls membership / subscription issues.
Set up email address for workflow support.
The default Silva layout templates can be reinstalled – e.g.
after an upgrade – with the install default layout button Service Extensions.
It may be that you have modified some of the existing layout
templates, such as the stylesheet frontend.css. Existing
templates won’t be overwritten. Instead the prefix ‘default_’ will
be prepended to the new id, preserving your work yet allowing you
to examine any differences.
On the Zope level, go to the Silva root
Remove or rename existing layout templates, such as:
content.html or custom.html
Note that there are other items, but if they’ve changed, you’ll be notified.
Go to the Services tab of the Silva root.
Click on service_extensions (Silva Product and Extension Configuration).
In the Silva Core box, click the install default layout button. Wait for the result screen.
Click the name of your Silva root in the breadcrumb trail. This returns you to the Contents tab of the root, where you will see the newly installed templates. If old ones exist, the prefix ‘default_’ will be prepended to the id.
Several key aspects are defined in the properties tab of the Silva root.
title: standard Zope title
help_url: defines the URL of the ‘alt-?’ link in the Silva Management Area. This may need adjustment, if the id of the Silva root is not silva, or if you want to provide a customized help page.
comment: a placeholder. In the Silva management area, comments can be entered in the properties screen. This metadata is not acquired by underlying items.
access_restriction: this feature to restricts access to the Silva site to specified IP ranges. This is also edited via the Access Screen in the Silva management area.
Fig. 1. View of the Silva (Shakespeare) portal in the ZMI
make a backup:
Place a check against the Silva root. In Fig. 1 it’s the Silva icon next to Shakespeare.
Choose Export at the base of the listings and Export your site. The file you save is a zexp file.
To import a Silva site choose Import at the base of the listings and upload a .zexp of a Silva site.
Make a backup before you upgrade.
When you upgrade, sometimes the stylesheet ‘frontend.css’ has been
adjusted. If this is the case, it will be noted in UPGRADE.txt (we
know everybody reads it :-) We recommend – especially if you haven’t
changed the stylesheet – that you delete/rename the
old one and install default layout. If
you see red text in the SMI or preview this is a signal
that your frontend.css should be updated, since you’re missing
key selectors for content display.
If you are upgrading Silva between major versions it’s a good idea
to look in the new template layout_macro.html. Often there are
improvements – such as related link references (<link
rel="...) for accessibility – and optimizations in the tal
code. Don’t forget to read the Upgrade.txt inside the Silva product download.
After a Silva upgrade, in the ZMI go to /services/service_extensions to refresh the content.
Read Troubleshooting.txt inside the Silva product download.