collective.themesitesetup 0.11.0

collective.themesitesetup

collective.themesitesetup is a plugin for plone.app.theming. With this plugin it’s possible to embed automatically imported generic setup profiles into a zipped theme package: one to be imported when theme is activated from the theming control panel, and the other one to be imported when theme is deactivated (as so called uninstall profile).

Note: Due to regression in plone.app.theming, this package will work only when a fixing pull for it is accepted and new version released (1, 2, 3):

Once this plugin is included into your Plone site (e.g. including it into the buildout eggs list and running the buildout), the plugin is enabled for the theme by adding the following line into its manifest.cfg:

[theme:genericsetup]

By default the plugin looks the profile imported during activation from a theme sub-directory called install and the profile imported during deactivation from a sub-directory called uninstall. The default lookup directories can be customized in manifest.cfg:

[theme:genericsetup]
install = my-install
uninstall = my-uninstall

The site setup import can also be disable whenever required by adding the line disabled = true into the plugin configuration in manifest.cfg:

[theme:genericsetup]
disabled = true
...

The importable profile can be edited TTW through the theme editor:

Note: Because the theme editor hides all dotfiles, files starting with a dot must be renamed to end with .dotfile (and to not start with a dot).

This plugin also provides a helper forms for exporting the current site setup into a through-the-web created (editable) theme and importing the site setup steps from the theme folder.

The site setup export form can be reached by adding @@export-site-setup after the theme resource directory URL, e.g. http://localhost:8080/Plone/++theme++my-theme/@@export-site-setup:

The site setup import form can be reached by adding @@import-site-setup after the theme resource directory URL, e.g. http://localhost:8080/Plone/++theme++my-theme/@@export-site-setup.

The import form should be especially useful for testing the import and performing manual site setup upgrades by importing only the updates step or a special upgrade profile directory.

Changelog