raptus.article.default 2.0b5

Default configuration of the raptus.article package.

Introduction

The new and easy way to create a site with the necessary features in a good style. With this add-on you install default configuration of the raptus.article package. All you need for a smart page in one step. But that’s not all. If you need more just have a look at the list of extensions and add the desired ones to your buildout.cfg. The rest is handled by the raptus.article.default package.

For developers

Have a look at our developer documentation

http://pypi.python.org/pypi/raptus.article.core.

The following features for raptus.article are provided by this package:

Packages

• raptus.article.listings

• raptus.article.gallery

• raptus.article.links

• raptus.article.files

• raptus.article.teaser

• raptus.article.reference

Dependencies

• raptus.article.listings

• raptus.article.gallery

• raptus.article.links

• raptus.article.files

• raptus.article.teaser

• raptus.article.reference

Installation

To install raptus.article.default into your Plone instance, locate the file buildout.cfg in the root of your Plone instance directory on the file system, and open it in a text editor.

Add the actual raptus.article.default add-on to the “eggs” section of buildout.cfg. Look for the section that looks like this:

eggs =
    Plone

This section might have additional lines if you have other add-ons already installed. Just add the raptus.article.default on a separate line, like this:

eggs =
    Plone
    raptus.article.core

Next step is to add the zcml files to the “zcml” section of buildout.cfg. Look for the section that looks like this:

eggs =
    Plone

This section might have additional lines if you have other zmcl’s already installed. Just add the raptus.article.default* on separate lines, like this:

eggs =
    Plone
    raptus.article.default
    raptus.article.default-overrides

Note that there are two zcml files you have to register. This because any of these register to different times, which is necassary for the product.

Once you have added these lines to your configuration file it is time to run buildout so the system can add and set up raptus.article.default for you. Go to the command line, and from the root of your Plone instance (same directory as buildout.cfg is located in), run buildout like this:

$ bin/buildout

If everything went according to plan you now have raptus.article.default installed in your Zope instance.

Next, start up Zope, e.g with:

$ bin/instance fg

Next go to the “Add-ons” control panel in Plone as an administrator and install the “raptus.article.default” product. You should then be able to add a new content type called Article.

Usage

1.) Add a new Article from the “Add new” menu.

• Provide a title for the new article.

• Provide a description for the article.

• Provide body text for the article.

In this page one can now add the following page elements:

• Article

• File

• Image

To change the presentation of your Article select the Tab “Components”. There you will get a list of installed layout parts (components).

Note that you have to select a component otherwise it’s possible you won’t see your (for example) file in your view.

Additional components

raptus.article.default depends on the following packages and will install them accordingly:

• raptus.article.files

• raptus.article.gallery

• raptus.article.images

• raptus.article.links

• raptus.article.listings

• raptus.article.reference

• raptus.article.teaser

The following additional packages are currently available for raptus.article and their zcml will be included by raptus.article.default and they will be installed if present.

• raptus.article.additionalwysiwyg

• raptus.article.contentfader

• raptus.article.contentflow

• raptus.article.fader

• raptus.article.flash

• raptus.article.form

• raptus.article.header

• raptus.article.hidecolumns

• raptus.article.lightbox

• raptus.article.lightboxgallery

• raptus.article.maps

• raptus.article.media

• raptus.article.multilanguagefields

• raptus.article.nesting

• raptus.article.randomcontent

• raptus.article.randomimage

• raptus.article.table

• raptus.article.upload

• raptus.article.contentswitcher

Extend your article

The raptus.article is so easy to extend. Just add the desired raptus.article packages to the “eggs” list in your buildout.cfg. The whole rest is handled by raptus.article.default.

Note that it’s not necessary to add the zcml files for raptus.article extensions in your buildout.cfg if you are using raptus.article.default.

Copyright and credits

raptus.article is copyrighted by Raptus AG and licensed under the GPL. See LICENSE.txt for details.

Developer Manual

Note: You find a developer manual for raptus.article at raptus.article.core. Please have look there if you need more information.

plone.article.default is a package, which provides a list of useful plone.article features by default. So you just have to install this package with your buildout and the rest is provided by the package.

Changelog

2.0b5 (2010-11-10)

• Added raptus.article.contentswitcher optional dependency

2.0b4 (2010-10-24)

• Set zip_safe flag to False

2.0b3 (2010-10-21)

• Updated readme and manual

2.0b2 (2010-10-20)

• First public release