Content rules

by Mikko Ohtamaa — last modified Aug 06, 2009 07:03 PM

This document briefly introduces you to content rules. Content rules allows you to associate automatic actions to site editing events.

Purpose

Content rules are combinations of triggers, conditions and actions to be executed when users does something on your site.

Example

Your website sends email to a site editor email list when the workflow of the object is changed, for example, the object is published or submitted to a review.

Possible conditions:

  • Content is created
  • Content is edited
  • Content is deleted
  • Workflow transition is trigged

Example actions:

  • Send email
  • Move content
  • Copy content
  • Notify user (information box)
  • Create a log entry

Usage

Go to site setup -> Content Rules.

  1. Create a condition (trigger) when the rule is executed.
  2. Set what happens when the condition happens (actions).
  3. Assign the content rule to a particular section of the site. This can be done on rules tab on any folder or site root.

Other

Add-on products exist that allow you to add more content rules to Plone:

  • Easy template: Rich template facilities for outgoing emails
  • collective.contentrules.mail This package provides an extended content rule "mail" action with many more variable substitutions available, including the name and email address of the content owner, making it possible to email the owner of a piece of content.

Content rule coding guide.