Skip to content

hexagonit/raptus.article.core

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Introduction

This package provides a configurable article content type, which replaces the default Page content type.

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

  • Content
    • Article - Page Type - folderish
  • Components
    • Related Items - Component - Component showing related Items.
  • Other
    • zcml namespace (article) - used to initialize new components.

Installation

Standard range raptus.article

Important:

  • Note that it is recommended to use the raptus.article.default package which depends on the base components of raptus.article for more details have a look at the install documentation of raptus.article.default. This installation only installs the core package.
  • Note as well that it does not make sense to only install raptus.article.core if you don't develop your own add-ons or install other packages of raptus.article as it provides more or less the same functionality as the default Page content type.

Install raptus.article.core

To install raptus.article.core 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.core 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.core 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 zcml's already registered. Just add the raptus.article.core* on separate lines like this:

eggs =
    Plone
    raptus.article.core-meta
    raptus.article.core
    raptus.article.core-overrides

Once you have added these lines to your configuration file, it's time to run buildout, so the system can add and set up raptus.article.core 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.core installed in your Zope instance.

Next, start up Zope using:

$ bin/instance fg

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

Usage

Add article

If you add a new article you will get the standard plone form to add content.

Components

By navigating to the "Components" tab you may select the components you would like to have displayed by this article.

Note if you only installed the raptus.article.core package there is just the component "Related Items" available. To add other components like image, files or links visit the pypi-site or install the package raptus.article.default.

Additional components

If you install the default package like the core package, you will get automatically the usual types like link, image, etc.. Besides if you install the article with default, you will not have to register all packages in buildout.cfg. The default package find automatically all component packages of raptus.article. For details read the doc of default package.

If you decide to group your components by yourself, here is a list of all currently available components. Install the selected packages like ratpus.article.core. Just be careful not all packages have an overrides.zcml and meta.zcml:

Copyright and credits

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

Releases

No releases published

Packages

No packages published