transmogrify.ploneremote 1.2

Transmogrifier blueprints for uploading content via xmlrpc to a plone site

• Introduction

• Usage

  • Common Options

  • transmogrify.ploneremote.constructor

  • transmogrify.ploneremote.remoteschemaupdater

  • transmogrify.ploneremote.remoteworkflowupdater

  • transmogrify.ploneremote.remoteredirector

  • transmogrify.ploneremote.remoteprune

  • transmogrify.ploneremote.remotenavigationexcluder

• Authors

• 1.2 (2012-04-28)

• 1.1 (2012-04-19)

• 1.0b5 (2011-10-13)

• 1.0b4 (2011-06-29)

• 1.0b3 (2011-02-06)

• 1.0b2 (2010-12-13)

• 1.0b1 (2010-11-08)

• 1.0a1 (2010-03-22)

Introduction

transmogrifier.ploneremote is package of transmogrifier blueprints for uploading content via Zope XML-RPC API to a Plone site.

Plone site does not need any modifications, but vanilla Zope XML-RPC is used.

Usage

Five different blueprints are provided.

Common Options

target

Url of Plone folder to upload content. You will need to include the username and password using the url syntax. e.g. http://user:[e-mail]/folder. If you’d prefer not to hardcode your password in a pipeline.cfg you can use mr.migrator which lets you override your pipeline using the commandline.

path-key

Which blueprint item dictionary key is used to extract the remote path information or the item. Default value path .

transmogrify.ploneremote.constructor

Drop in replacement for constructor that will use xmlprc calls to construct content on a remote plone site

Options:

target:

see Common Options

path-key:

see Common Options

type-key:

Key of the field with item type to create. Defaults to ‘type’,’portal_type’, ‘Type’,’_type’

creation-key:

Key of the field to determine if item should be created. Defaults to ‘_creation_flag’

create-condition:

TAL expression to determine if item should be added. Defaults to ‘python:True’

move-condition:

If the content has already been uploaded and then moved this TAL expression will determine if the content should be moved back. Default is ‘python:True’

remove-condition:

If the content has already been uploaded and is of a different type this TAL expression will determine if the item can be removed and recreated.

transmogrify.ploneremote.remoteschemaupdater

This will use XML-RPC to call Archetypes setXXX() mutator methods remotely to set field values.

TODO: How to input schema fields

Options:

target:

see Common Options

path-key:

see Common Options

condition:

TAL Expression to determine to use this blueprint

skip-existing:

Default is ‘False’

transmogrify.ploneremote.remoteworkflowupdater

Triggers the state transition of the remote item workflow i.e. publishes the item if it is not public.

Options:

target:

see Common Options

path-key:

see Common Options

transitions-key:

which blueprint item dictionary key is used as the transition name for the item.

transmogrify.ploneremote.remoteredirector

This blueprint adds redirection aliases to those content items that have changed it’s paths during tranmogrification process. It takes into account item’s _orig_path key set by webcrawler blueprint. Redirection uses Products.RedirectionTool Aliases form to add appropriate redirections. So this is required to install that addon in order to make transmogrify.ploneremote.redirector blueprint work.

If path is not equal to orig_path then appropriate aliases is being added to local Plone utility (IRedirectionStorage) using Aliases form.

Example:

#
# Add content aliases for content that changed it's paths
#
[redirector]
blueprint = transmogrify.ploneremote.remoteredirector

Options:

target:

see Common Options

path-key:

see Common Options

transmogrify.ploneremote.remoteprune

Removes any items from a folder if it’s not an item in the pipeline.

Options:

target:

see Common Options

path-key:

see Common Options

prune-folder-key:

which transmogrifier field is read to check if the prune folder is run against the remote folder. The default value os “_prune-folder”

transmogrify.ploneremote.remotenavigationexcluder

Set “Exclude from Navigation” setting for remote Plone content items.

Options:

target:

see Common Options

path-key:

see Common Options

exclude-from-navigation-key:

Which key we use to read navigation exclusion hint. Default is ‘exclude-from-navigation’

Authors

In the order of apperance

• Dylan Jay, [e-mail]

• Mikko Ohtamaa, [e-mail], http://mfabrik.com

• Vitaliy Podoba, [e-mail]

1.2 (2012-04-28)

• fix import of pathsorter after its move

1.1 (2012-04-19)

• remoteconstructor: handle uploading with moved content or content thats changed type [djay]

• ploneprune: ignore items with no path [djay]

• handle Protocol errors in schemaupdater [djay]

• handle some xmlrpc errors better [djay]

• add conditions so can skip existing [djay]

• improve documentation [djay]

1.0b5 (2011-10-13)

• Various bug fixes [aclark]

• Depend on transmogrify.pathsorter [aclark]

1.0b4 (2011-06-29)

• fix uploading html in plone 4.1 by setContentType

• log errors to logger and continue

• simplify update code

• better logging

• close files so don’t run out of file handles

1.0b3 (2011-02-06)

• handle uploading files using less memory

• fix bug in debug output

1.0b2 (2010-12-13)

• better logging

1.0b1 (2010-11-08)

• Added remote folder pruning [“Mikko Ohtamaa”]

• skips if there are no target [“Dylan Jay”]

• add remoteredirector blueprint [“Vitaliy Podoba”]

• Added exclude_from_nav remote setting [“Mikko Ohtamaa”]

• added remote workflow updater [“Mikko Ohtamaa”]

1.0a1 (2010-03-22)

• split from pretaweb.funnelweb and released [“Dylan Jay”]