Package: collective.blueprint.dancing
IntroductionThis package contains several blueprints for collective.transmogrifier
pipelines, dedicated to the Plone product collective.dancing.ContentsIntroductionCreditscollective.blueprint.dancing InstallationRequirementsDetailed DocumentationImportSubscriber sectionChange History0.2 - (unreleased)0.1 - 2009-02-10DownloadCreditsPlanet Makina CorpusContact uscollective.blueprint.dancing InstallationWhen you’re reading this you have probably already runeasy_install collective.blueprint.dancing. Find out how to install
setuptools (and EasyInstall) here:http://peak.telecommunity.com/DevCenter/EasyInstallCreate a file calledcollective.blueprint.dancing-configure.zcmlin the/path/to/instance/etc/package-includesdirectory.  The file
should only contain this:<include package="collective.blueprint.dancing" />Alternatively, if you are using zc.buildout and the plone.recipe.zope2instance
recipe to manage your project, you can do this:Addcollective.blueprint.dancingto the list of eggs to install, e.g.:[buildout]
...
eggs =
    ...
    collective.blueprint.dancingTell the plone.recipe.zope2instance recipe to install a ZCML slug:[instance]
recipe = plone.recipe.zope2instance
...
zcml =
    collective.blueprint.dancingRe-run buildout, e.g. with:$ ./bin/buildoutYou can skip the ZCML slug if you are going to explicitly include the package
from another package’s configure.zcml file.RequirementsSinging & Dancing -http://pypi.python.org/pypi/collective.dancingtested with Plone 3.3.4Detailed DocumentationImportSubscriber sectionA ImportSubscriber section allows you to add subscribers to a collective.dancing
channel.The ImportSubscriber blueprint name iscollective.blueprint.dancing.importsubscriber.To determine the subscriber informations, the ImportSubscriber section inspects
each item and looks for the keys email, channel-id and composer-id, as described
below. Any item missing theemailkeys will be skipped.If the keychannel-idis missing, the ImportSubscriber section looks for the
optiondefault-channel-id. This option defaults todefault-channel.If the keycomposer-idis missing, the ImportSubscriber section looks for
the optiondefault-composer-id. This option defaults tohtml.For each key, the corresponding information will be found among the following:_collective.blueprint.dancing.importsubscriber_[sectionname]_[key]_collective.blueprint.dancing.importsubscriber_[key]_[sectionname]_[key]_[key]where[sectionname]is replaced with the name given to the current section,
and[key]is replaced byemail,channel-idorcomposer-id. This
allows you to target the right section precisely if needed.Alternatively, you can specify what key to use for each information by
specifying the``[key]-key`` option, which should be a list of keys to try (one
key per line; use are:orregexp:prefix to specify regular
expressions).>>> import pprint>>> importsubscriber = """
... [transmogrifier]
... pipeline =
...     source
...     importsubscriber
...     importsubscriber2
...     printer
...
... [source]
... blueprint = collective.blueprint.dancing.tests.importsubscribersource
...
... [importsubscriber]
... blueprint = collective.blueprint.dancing.importsubscriber
...
... [importsubscriber2]
... blueprint = collective.blueprint.dancing.importsubscriber
... default-channel-id=mychannel
... default-composer-id=mycomposer
...
... [printer]
... blueprint = collective.transmogrifier.sections.tests.pprinter
... """
>>> registerConfig(u'collective.blueprint.dancing.tests.importsubscriber',
...                importsubscriber)>>> transmogrifier(u'collective.blueprint.dancing.tests.importsubscriber')
[('_email', 'foo@foo.com')]
[('_email', 'bar@bar.com')]
[('_email', 'existing@email.com')]>>> pprint.pprint(plone.subscribers)
(u'foo@foo.com -channel:default-channel - composer:html',
 u'foo@foo.com -channel:mychannel - composer:mycomposer',
 u'bar@bar.com -channel:default-channel - composer:html',
 u'bar@bar.com -channel:mychannel - composer:mycomposer')Change History(name of developer listed in brackets)0.2 - (unreleased)0.1 - 2009-02-10Added ImportSubscriber section. See importsubscriber.txt.
[sylvainb]Downloadcollective.blueprint.dancing-0.1.zip(md5)