Welcome to Silva CMS

Posted in Uncategorized | Leave a comment

Zope Level Management

This document describes the workings of Silva from the point of view of a Silva site Manager role. This role has the same rights as a Zope manager.

Assumptions
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”.

Nomenclature
ZMI refers to the Zope Management Interface
SMI refers to the Silva Management Interface (where Silva Authors, Editors and Chief Editors work).
ZPT is a Zope Page Template.
To 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’.
General
Let’s start with a few tips which are good to know.

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 not normally a 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
Silva Root icon
What follows is a quick listing, with links to more information, of the objects found in a Silva root. Most of these items have code that resides on the file system.

In the ZMI, at “/silva/manage” or “/silva/manage_main”, you’ll see a number of Zope and Silva objects. Silva objects are Publications, Folders, Documents, etc.

Note that if Silva content objects are present in the root publication, those items will be mingled in the ZMI contents listing as well.

Members
This folder contains 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.

Silva Services
All Silva Services are found in the Silva root in the ZMI, some services can also be found in Site Preferences (Site configuration) via the user meny drop-down.

Click on the Services tab in the ZMI to see the full list of Service options or select Site Preferences from the user menu drop-down in the SMI. Most services have settings that can be modified.

The Silva Extension Service (Silva Extensions management)
This service allows configuration of Silva core and extension products. Your own and third party extensions can be activated and deactivated here. Silva News is an example of an extension – it’s not part of the Silva core – that must be installed on the file system. Depending on what’s been installed the listing will change.

Following are several other default services:
service_files (Silva Files Service)
Controls storage of Silva File objects
service_members (Silva Membership Service)
Controls membership / subscription issues.
service_message (Silva Message Service)
Set up email address for workflow support.

Simple Silva backup
acl_users in listing
Fig. 1. View of the Silva (Literature) root in the ZMI.

To make a simple Silva backup:
Place a check in the checkbox by the Silva root.
Choose Export at the base of the listings and Export your site.
A pop up dialog will allow you to save a .zexp file.
To import a Silva site place a zexp file in the import directory of your Zope instance
Choose Import at the base of the listings.
Select the zexp of the Silva site.

Troubleshooting
Read Troubleshooting.txt inside the Silva product download.

Posted in Uncategorized | Leave a comment

Manager login

A Silva Manager has access to both the Silva Management Interface (SMI) and the Zope Management Interface (ZMI).

Login To the Zope Management Interface
To Login to the ZMI (Zope Management Interface) type “/manage” or “/manage_main” at the end of your Silva site URL, e.g. http://www.mysilvasite.com/manage. A password prompt will appear.
Fill in the dialog box with your username and password (Fig. 1.).
Click the “Log in” button.
After this you will be taken to the ZMI (Fig. 2.).

Windows Login dialog
Fig. 1. Login form.

When accessing the ZMI with “manage” a frameset loads. Most managers enter “manage_main” after the site URL because this goes directly to a page, without the ZMI frameset. It’s also possible to go to manage_main directly from the SMI using the “Manage” button at the bottom of the navigation sidebar.

Accessing the Silva Management Interface (SMI) from the ZMI
To access the Silva Management Interface from the ZMI, click on the Silva icon of the desired Silva root. In Fig. 2. Here it’s called “literary” but in your case it will be the id of your site root.

acl_users in ZMI root listing
Fig. 2. Zope Management Interface (ZMI) with a Silva root “literary”.

This will take you to the Zope Management area for Silva (Fig. 3).

The Zope Management area for Silva has the following tabs: Contents, Services, Silva/edit, View, Properties, Security, Undo, Ownership, Interfaces and Find.

Click the Silva/edit… tab in Fig. 3.

ZMI Services tab
Fig. 3. Top navigation tabs of the Zope management area for Silva.

You can always return to the Silva Management Interface by clicking the “Silva /edit…” tab.

To go to the ZMI from within Silva, click on the User menu at the top right of the screen. The “Manage…” option goes to “manage_main”, without the ZMI frameset. Remove “_main” if you want the frameset.

Posted in Uncategorized | Leave a comment

Silva Documentation for users

Guides
These guides are for people with an Author, Editor, Chief Editor or Manager role in a Silva site. The guides show you how to author and manage content and roles in Silva. The quickest way to learn Silva is to read Getting started and then look at the section for your Silva role. The Authors section is divided into ‘basic’ and ‘advanced’. The basic section answers the most often asked questions. The advanced authors section presumes a knowledge of the basic section.

Latest Silva version documentation
What’s new in Silva 3.0
Getting started
Author – basic
Author – advanced
Editor
Chief Editor
Manager
Silva tips
Silva extensions

Posted in Uncategorized | Leave a comment