How to Install Premium Plone Themes on Plone 3

After you competed buying process for any of Quinatgroup Premium Themes on PayPal, you will receive an archive that includes 2 files. You may use either of these two files to install the theme on your instance:

1. Theme product source archive - quintagroup.theme.themename-version.tgz
2. Theme product egg archive - quintagroup.theme.themename-version-python_version.egg

where quinatgroup.theme.themename - is an example theme name used for the following instruction purposes.

Buildout-based Zope instance

If you are using zc.buildout and the plone.recipe.zope2instance recipe to manage your project, you can use either egg or tgz archive file to install the theme on your Zope instance. Explanations for each case follows:

Variant 1. Tgz Archive

1. Unpack source archive quintagroup.theme.themename-version.tgz to get a theme package directory - quintagroup.theme.themename:
   • 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

2. Move this package directory quintagroup.theme.themename to your instance src directory.
3. Open buildout.cfg file in the root of your instance and add reference to the theme products location (to src directory) under [buildout]:
   

   [buildout]
   parts = 
   .....
   develop = src/quintagroup.theme.themename

4. Add quintagroup.theme.themename to the list of eggs to install and tell the plone.recipe.zope2instance recipe to install a ZCML slug:
   

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

5. Re-run buildout with the following command in the terminal::
   

   ./bin/buildout

6. Restart the Zope server, for example, with the following command in the terminal:
   

   ./bin/instance restart

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

Variant 2. Egg Archive

1. Unzip egg archive quintagroup.theme.themename-version-python_version.egg to get a theme package egg directory - quintagroup.theme.themename-version-python_version.egg:
• On Windows use a program like WinZip or 7-Zip
• On Linux, BSD and OS X:
  
  • use the following command to unzip the egg archive into the folder titled e.g quintagroup.theme.themename.egg

  unzip quintagroup.theme.themename-version-python_version.egg -d quintagroup.theme.themename.egg

• delete theme egg archive
• rename egg folder quintagroup.theme.themename.egg to initial egg archive name - quintagroup.theme.themename-version-python_version.egg
2. Move the theme egg folder quintagroup.theme.themename-version-python_version.egg into your Zope instance eggs directory.
   
3. Open buildout.cfg file in the root of your instance and add quintagroup.theme.themename to the list of eggs to install and tell the plone.recipe.zope2instance recipe to install a ZCML slug:

   [instance]
   recipe = plone.recipe.zope2instance
   ...
   eggs =
       ${buildout:eggs}
       ...
       quintagroup.theme.themename
   ...
   zcml =
       ...
       quintagroup.theme.themename

4. Re-run buildout with the following command in the terminal:

   ./bin/buildout

5. Restart the Zope server, for example, with the following command in the terminal:
   

   ./bin/instance restart

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

Zope instance without Buildout

1. Unpack source archive quintagroup.theme.themename-version.tgz to get a theme package directory - quintagroup.theme.themename:
   • 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

2. Open this directory and you will have quintagroup folder among other items inside. Move this folder into your Zope instance lib/python directory.
3. Move a file called quintagroup.theme.themenane-configure.zcml , located  in quintagroup.theme.themename folder, into your Zope instance etc/package-includes directory. Make sure the file only contain this:
   

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

4. Restart the Zope server, for example with the following command in the terminal:
   

   ./bin/zopectl restart

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