No description or website provided.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



The base package ``opencore`` provides "site-level content" directly
in templates. This is simple -- the built-in i18n mechanisms can be
used to provide translated content, and you don't have to worry about
filling in any text when you're installing a new site.

However, a site will often want to replace these blocks of content
with their own custom text.

Also, a site will often want to let those blocks of content be created
or edited by certain non-technical users.  In these cases, the text
should be treated as managed content within the site's database,
instead of static text in a template on the filesystem.

The plugin ``opencore_contentviews`` addresses these needs, providing a
mechanism for overriding any view (or registering a new view) to pull
its content from a designated wiki page within the site.


This plugin implicitly makes distinctions between four types of
people, based on their responsibilities and levels of trust:

 * System admin: a person with server access who is installing the
   site and knows how to install plugins, register overrides, etc, to
   customize the behavior of the OpenCore installation.

 * Site admin: a person who has full admin/manager privileges on the
   site,  but does not have direct filesystem access to the server.

 * Site content manager: a person who the site admin trusts to write
   and maintain the content that will appear in sitewide blurbs such
   as the "About" page or the "Becoming a member" widget -- but does
   not have full manager privileges on the site.

 * Regular user: any other user of the site.

These roles are not formally defined by this plugin -- they are the
roles that are assumed to exist between the humans running the site.

This plugin provides a ZCML directive <opencore:contentView> which
will register a new "ContentView", a view that pulls in its content
from a wiki page on the site.


The system admin will register the set of ContentViews, and assign a
key to each ContentView.

The site admin will associate each key with a wiki page on the site.

The site content manager will edit the wiki pages associated with the

For simplicity, there is a (light) assumption that all the wiki pages
associated with ContentViews are within the same project.  This lets
the site administrators create a single "Site Content Development"
project whose team members are all site content managers.

If this assumption is incorrect, it is possible to overrule it by
using the ZMI instead of the management view provided by this plugin.
This would be used if, for instance, you want one set of users able to
edit the About page text, but another set of users able to edit the
"Becoming a Member" text.