How to Install Free Plone Themes on Plone 3

— filed under: Installation

The following are general instructions for free themes (distributed as Python eggs) installation on buildout-based and non-buildout-based Plone 3 instances. There is INSTALL.txt file in every theme's /docs directory with the exact installation instructions for every theme.

Buildout-based Zope instance

In this article we use quintagroup.theme.themename as an example theme name

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:

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

Tell the plone.recipe.zope2instance recipe to install a ZCML slug:
```
[instance]
...
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'.

Zope instance without Buildout

In this article we use quintagroup.theme.themename as an example theme name

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 download theme package tar archive - quintagroup.theme.themename-version.tar.gz.
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'.

Sections

Personal tools