Skip to main content

Provides basic listing components which display articles contained in the article.

Project description


Provides basic listing components which display articles contained in the article.

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


  • Listing columns (List of the contained articles arranged in columns.)
  • Listing left (List of the contained articles with their image on the left side.)
  • Listing right (List of the contained articles with their image on the right side.)


  • raptus.article.nesting


To install raptus.article.listings 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.listings add-on to the “eggs” section of buildout.cfg. Look for the section that looks like this:

eggs =

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

eggs =

Note that you have to run buildout like this:

$ bin/buildout

Then go to the “Add-ons” control panel in Plone as an administrator, and install or reinstall the “raptus.article.default” product.

Note that if you do not use the raptus.article.default package you have to include the zcml of raptus.article.listings either by adding it to the zcml list in your buildout or by including it in another package’s configure.zcml.



Navigate to the “Components” tab of your article and select one of the listing components and press “save and view”. Note that at least one article has to be contained in the article in which this component is active.


Set listings_<component>_titletop property to True to display the title above the image, use False to display it below the teaser-image.

listings_<component>_caption shows the image caption below the image (in case it differs from the article title)

listings_<component>_wysiwyg will show the richtext content of the additional textfield in case raptus.article.additionalwysiwyg is installed.

To use scales simply set the corresponding properties to the name if the image scale.

You’ll need to have raptus.article.teaser installed for having teaser images available on articles.

If present, those will overrule the width and height settings.

Available properties:

  • teaser_listingleft_scale
  • teaser_listingright_scale
  • teaser_listingcolumns_scale

Developer Manual

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

Code overview



  • raptus.article.listing.right
  • raptus.article.listing.left
  • raptus.article.listing.columns


2.0b9 (2014-06-16)

  • Add properties teaser_listingleft_scale, teaser_listingright_scale and teaser_listingcolumns_scale that allow to use

    This allows us to use [fRiSi]


    requires raptus.article.teaser >= 2.0b12

2.0b8 (2013-07-01)

  • Only show hidden articles when in editing mode (introduced in raptus.article.core 2.0b13)
  • Added alternating listing and refactored viewlet class simplify extending

2.0b7 (2010-03-21)

  • Now using the show/hide functionality added in raptus.article.core 2.0b8

2.0b6 (2010-11-10)

  • Added French translations

2.0b5 (2010-10-24)

  • Set zip_safe flag to False

2.0b4 (2010-10-21)

  • Updated readme and manual

2.0b3 (2010-10-20)

  • First public release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for raptus.article.listings, version 2.0b9
Filename, size File type Python version Upload date Hashes
Filename, size (38.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page