Personal tools
You are here: Home Site Contributors HOWTO: Getting Started With the PCMDI Software Portal
Document Actions

HOWTO: Getting Started With the PCMDI Software Portal

An introduction to the PCMDI Software Portal, including some basic information about the Plone interface and how to accomplish some common tasks.

User Permissions

Before discussing how to go about editing pages, it may be useful to know who can view and edit content, and who has permissions to do various things in this system. We've configured the site such that there are four main user classes (from least to most privilage):
Anonymous User
Has read-only access to a subset of the content in the portal. Is basically restricted to viewing the documentation, message boards, and other public content.
Site Member
Has a portal user account. When logged in, can add comments to the bottom of tutorial pages and post to the message boards. Has a personal folder, but no access to the "Site Contributors" folder.
Site Contributor
Same privileges as Site Member, plus has access to "Site Contributors" folder. This folder contains internal documents, tutorial templates, and other useful information on contributing to the site.
Site Administrator
Access to everything, including the site configuration.

Your Folder

Upon logging in, you will see a link to your folder. Think of this folder as your home directory, where you can create and edit content. You can quickly jump to your folder (when logged-in) via the "my folder" link under the search box.

Editing Content

If you are viewing a page you have permissions to edit, you will see a series of green tabs across the top of the page. The Contents tab presents you with a filesystem-like view. You can add documents and sub-folders, and there is also a set of handy cut-copy-paste buttons for easily moving or duplicating files. The View tab shows you the document or folder as a normal user would see it. The Edit tab (obviously) allows you to edit the content. On the Properties tab, you can modify certain document properties, including a date range for the content to be considered active, a set of associated search keywords, and turning comments on or off for that page (the site default is off). Finally, the Sharing tab associates users with your document, so that you can have fine-grained control over who can view and edit certain content.

Using the Epoz Editor

By default, Plone has three different edit modes: Structured Text, HTML, and Plain Text. A more advanced editor, called Epoz, gives you a WYSIWYG editing interface, as well as allowing you to toggle to view/edit the raw HTML. To use Epoz as your default editor, click the "my preferences" link (under the search bar when logged-in). Choose "Personal Preferences", then select Epoz as your content editor.

File States

A file or folder can be in one of several different states, and that state affects who has access to it. The states we are interested in are Private, Visible, and Published:

Private
Can only be viewed and edited by the owner(s) of that file. You can add owners (in addition to yourself) to grant other users access to that file.
Visible
The default state for new items. Considered hidden because it does not show up in the navigation menu, but still viewable by anyone on the site (even Anonymous Users) if that person knows the URL to access the file or document directly. It will also show up in search results.
Published
Open to the public.

Powered by Plone