How to Install Free Plone Themes on Plone 3

The following instructions cover installation of Free Plone skins (distributed in a .tgz or .egg file) on traditional and buildout-based Zope instances for Plone 3.

Traditional Zope instance

If you are using traditional Zope instances (no buildout) you can do this:

Step 1

Variant A - tgz archive

Follow the link on the theme page on this website to get theme package tar archive from Sourceforge (e.g. quintagroup.theme.themename-version.tar.gz, where quinatgroup.theme.themename - is an example theme name used for the following instruction purposes).
Unpack downloaded archive:
- On Windows use a program like WinZip or 7-Zip
- On Linux, BSD and OS X you may use the following command:
```
tar -zxf quintagroup.theme.themename-version.tar.gz
```
You will get a theme package directory (quintagroup.theme.themename).
Open this directory and you will have quintagroup folder among other items inside. Move this folder into your Zope instance lib/python directory.

Variant B - egg

Follow the link on the theme home page on this website to download theme package egg from PyPi (quintagroup.theme.themename-version-python_version.egg)
Find quintagroup folder inside quintagroup.theme.themename-version-python_version.egg file. Move this folder into your Zope instance lib/python directory.

Step 2

Create a file called quintagroup.theme.themenane-configure.zcml in your Zope instance etc/package-includes directory. The file should only contain this:

<include package="quintagroup.theme.themename" />

Note: In case you have downloaded tar.gz archive you will find quintagroup.theme.themenane-configure.zcml file in quintagroup.theme.themename-version.tar.gz/quintagroup.theme.themename folder. Simply copy it into your Zope instance etc/package-includes directory.

Step 3

Restart the Zope server, for example with the following command in the terminal:
```
./bin/zopectl restart
```

On your Plone site go to Site Setup -> Add-on Products
Select the theme among products available for installation press 'Install'.

Buildout-based Zope instance

If you are using zc.buildout and the plone.recipe.zope2instance recipe to manage your project, you can do this:

Open buildout.cfg file in the root of your instance.

Add quintagroup.theme.themename to the list of eggs to install, e.g.:

[buildout]
...
eggs =
       ...
       quintagroup.theme.themename

Tell the plone.recipe.zope2instance recipe to install a ZCML slug:

[instance]
recipe = plone.recipe.zope2instance
...
zcml =
        quintagroup.theme.themename

Re-run buildout with the following command in the terminal:
```
./bin/buildout
```
Restart the Zope server, for example, with the following command in the terminal:
```
./bin/instance restart
```

On your Plone site go to Site Setup -> Add-on Products
Select the theme among products available for installation press 'Install'.

Sections