zkaffold is a Plone product to install content on a Plone site.
How to install
Add zkaffold to your product:
- Add "zkaffold" to your product's install_requires in setup.py
- Add < include package="zkaffold" / > in your product's configure.zcml
- Add "profile-zkaffold:default" as a dependency to your product's metadata.xml
- run ./bin/buildout
zkaffold should now be installed. Note that zkaffold is not installable / uninstallable from the portal quick installer.
How to use
After installing zkaffold in your plone site, you can build content for your plone site by:
- create "initial" profile in your product,
- create a directory called "zkaffold" in profile/initial,
- create structure.xml (example structure.xml is in zkaffold/exportimport/tests/test_exportimport.py),
You can also create default users in your plone site by:
- create members.xml (example members.xml is in zkaffold/exportimport/tests/test_exportimport.py)
If you are using buildout, in your buildout.cfg:
- in the [plonesite] section, add your product initial profile (e.g. mysite:initial) to "profiles-initial",
- run ./bin/buildout
Your plone site should now be populated with content specified in structure.xml. Note that if your plone site already exists before running buildout, it will not add any content. You'll have to delete your plone site or run the zkaffold import step to add the content.
You can use different profiles to create different content, for example if you want test content, you can create another profile and add that in profiles-initial when you want test content to be built.
zkaffold publishes all objects by default by trying to apply transition "publish" to the objects. If your objects need a different way of publishing, have a look at zkaffold/exportimport/tests/test_exportimport.py.
Product's homepage
Here are some key features of "zkaffold":
· Install content
· Install products
· Delete content
· Apply zope interfaces
· Modify content
· Generate test content
Requirements:
· Python
· Plone CMS
· lxml