Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

An action for the contentrules framework to run a script on the object that triggered the rule

Project Description


Content rules are a powerfull feature in Plone 3. But create a filesystem product for every single little action we’d like to perform seems a little overkill. To help those integrators and administrators out there, RunScript brings the ability to register a condition that once matched will perform whatever the action you state in a script configured in the Rule configuration form.

Just to meet a few use cases, the product brings a some sample scripts that might come in handy:


Adds the parent’s title as a tag to the item (appends to the subject field). E.g.:

Given the structure: Plone/Folder1/Folder2/Folder3/object
>> object.Subject()
After Plone/Folder1/Folder2/Folder3/object/tag_after_parent
>> object.Subject()

Conditionally adds parent’s title as tags to the item (appends to the subject field). Recursively tests whether title_as_tag property is set on each part of the object’s parent’s path and adds that part’s title as a tag on the object. E.g.:

Given the structure: Plone/Folder1/Folder2/Folder3/object
Plone.title_as_tag is undefined
Folder1.title_as_tag is False
Folder2.title_as_tag is True
Folder3.title_as_tag is True
>> object.Subject()
After Plone/Folder1/Folder2/Folder3/object/tag_after_parents
>> object.Subject()

Adds a new property to the context object or just sets an existing one. Types must be the same in the latter case. Parameters are name,value,type. E.g.:

Given the structure: Plone/Folder1/Folder2/Folder3
After Plone/Folder1/Folder2/Folder3/set_property?name=title_as_tag&value=True&type=boolean
>> Plone.Folder1.Folder2.Folder3.getProperty('title_as_tag') == True


You can give your suggestions.

One could easily write a new script that just needs to be traversable from the object that will trigger the condition.


Add collective.contentrules.runscript to your buildout as an egg or from source. No (generic setup) installation is necessary, the action is registered using ZCML. So do add the package to the zcml slug list of your [instance] section.

If you’d like to use any of the available sample scripts then you should install the product by the Addons configlet.


Go to the Plone Control Panel, select Content Rules and add a new Rule. Under ‘actions’ you now have a new option: Run Script.

In the ‘Configure element’ form, point to a script that knows how to perform the desired action upon the object that will trigger the rule.

If you installed the sample scripts, you could use the ‘tag_after_parent’ script and have every object matching the rule’s condition categorized by their parent’s title.

If the script you inform at the configuration form is not traversable from the object that triggered the rule an exception will or will not be thrown depending on the state of the ‘Fail on script not found’ flag.

If you set the rule to an ‘add to container’ event, not finding the script means not fullfilling the add.


This package has been highly based on collective.contentrules.mailtolocalrole.


0.4 (2011-02-22)

  • Added z3c.autoinclude.plugin entry point
  • Fixed reference to .runscript.RunscriptAction factory in configure.zcml (thanks to Sascha Gresk)

0.3 (2009-07-27)

  • Added option to pass parameters to scripts
  • Added tag_after_parents and set_property sample scripts

0.2 (2009-07-23)

  • Added restricted/unrestricted traversal option
  • Fixed packaging problems

0.1.1 (2009-07-23)

  • Fixed packaging problems

0.1 (xxxx-xx-xx)

  • Initial release
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
collective.contentrules.runscript-0.4.tar.gz (10.7 kB) Copy SHA256 Checksum SHA256 Source Feb 23, 2011

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting