Before installing cmsplugin-gallery, you'll need to have a copy of Django already installed. For the |version| release, Django 1.2 or newer is required. You will also need Django-cms version 2.1.0 or superior installed and running.
You'll also need the easy-thumbnails library for certain rendering engines, you can install it with pip for example by doing:
pip install easy-thumbnails
There are several ways to install cmsplugin-gallery:
- Automatically, via a package manager.
- Manually, by downloading a copy of the release package and installing it yourself.
- Manually, by performing a Mercurial checkout of the latest code.
It is also highly recommended that you learn to use virtualenv for development and deployment of Python software; virtualenv provides isolated Python environments into which collections of software (e.g., a copy of Django, and the necessary settings and applications for deploying a site) can be installed, without conflicting with other installed software. This makes installation, testing, management and deployment far simpler than traditional site-wide installation of Python packages.
Automatic installation via a package manager
Using easy_install, type:
easy_install -Z cmsplugin-gallery
Note that the -Z flag is required, to tell easy_install not to create a zipped package; zipped packages prevent certain features of Django from working properly.
Using pip, type:
pip install cmsplugin-gallery
Manual installation from a downloaded package
If you prefer not to use an automated package installer, you can download a copy of cmsplugin-gallery and install it manually. The latest release package can be downloaded from cmsplugin-gallery's listing on the Python Package Index.
Once you've downloaded the package, unpack it (on most operating systems, simply double-click; alternately, type tar zxvf cmsplugin-gallery-X-Y-Z.tar.gz at a command line on Linux, Mac OS X or other Unix-like systems). This will create the directory cmsplugin-gallery-X-Y-Z, which contains the setup.py installation script. From a command line in that directory, type:
python setup.py install
On some systems you may need to execute this with administrative privileges (e.g., sudo python setup.py install).
Manual installation from a Mercurial checkout
If you'd like to try out the latest in-development code, you can obtain it from the cmsplugin-gallery repository, which is hosted at Bitbucket and uses Mercurial for version control. To obtain the latest code and documentation, you'll need to have Mercurial installed, at which point you can type:
hg clone http://bitbucket.org/izi/cmsplugin-gallery/
This will create a copy of the cmsplugin-gallery Mercurial repository on your computer; you can then add the cmsplugin-gallery directory to your Python import path, or use the setup.py script to install as a package.