silva.app.news

HomePage: https://github.com/silvacms/silva.app.news

Author: Infrae

Download: https://pypi.python.org/packages/source/s/silva.app.news/silva.app.news-3.0.4.tar.gz

        ==============
silva.app.news
==============

``silva.app.news`` is an extension to `Silva`_ 3 to allow authors to
add news articles and agenda items in Silva.

For older versions of Silva, please use an older version of
``Products.SilvaNews``.

Using Silva News
================

The first thing to do is add subjects and target audiences to the
service_news object in the Silva root in the ZMI. This object is used
only to manage those lists (subjects and target audiences), these will
function as criteria for the newsfilters (more on these later in this
document) to search on. It would be best to add as much subjects and
target audiences as currently available to the service when setting up
News, since the lists are the basis of the filtering system and one
has to dive into the ZMI to add items (therefore it requires
appropriate rights to edit stuff in the ZMI).  Managing these lists is
quite straightforward: you can add an item by filling in a string into
one of the textfields and pressing on the corresponding 'add' button,
and remove them by checking the checkbox in front of an item and
clicking the corresponding 'remove' button.

Adding a News Publication
-------------------------

Newsitems can only be added to newspublication. To add one, go to the
SMI and choose 'Silva News Publication' from the menu of addables
(upper left corner of the edit tab in folders, publications and the
Silva root). Enter an id and a title and choose 'Add and edit', you
will then be taken to the edit tab of the newspublication.  This tab
looks a lot like the edit tab of other containers (folders,
publications) in Silva, except it doesn't have a default document or
view and can not contain anything other then news items (articles and
agenda items), folders and publications (thus allowing a more
structured setup of the newspublication).You can add newsitems by
choosing a specific type from the addables menu in this tab.

Properties tab
~~~~~~~~~~~~~~

In the properties tab of newspublication there is a checkbox called
'restrict access'. When this is checked, the folder can only be found
by news- and agendafilters in the same folder the folder is on and
each subfolder of that folder. This can be used to make the
newspublication 'private', making it available only to for example 1
department.

Adding news items
-----------------

Now authors can add newsitems. As stated before, there are two types
of newsitems: articles and agendaitems. The main differences are that
agendaitems must contain a date/time on which the event described in
them takes place, and contain a location on which the event takes
place. The start date/time is necessary to show the items in
agendaviewers, since they show the items for a particular period
(e.g. a month). Therefore agendaviewers can show only
agendaitems. Newsviewers are capable of showing both articles and
agendaitems. Other datafields required for the system to work
correctly are 'subjects' and 'target audiences', which the author can
use to classify the newsitem. These fields will later be used by the
newsfilters as criteria for routing the items to newsviewers. When
editing an article or agenda item, keep in mind that the first heading
placed in the content editor is considered to be the subheader of the
newsitem, and the first paragraph as the lead (both will show up in
the preview on the viewers).

Adding news filters
-------------------

The next thing to do to make the system work is adding one or more
news- and agendafilters. These are objects used by editors or chief-
editors to filter a stream of newsitems. The items can be filtered on
subject and target audience (so for instance a newsfilter can route
only newsitems with a specific subject or meant for a specific target
audience to the viewers) and/or individually (per newsitem). Another
feature of the filters is the ability to 'stick to the current path',
when set this makes the filters pick up items only if they're in a
subdirectory of the filter's container.

The Filters' edit tab
~~~~~~~~~~~~~~~~~~~~~

The contents tab of a newsfilter shows a list