WordPress Coppermine Plugin

‘WordPress Coppermine Plugin’ can be downloaded here.

This WordPress plugin supplies a set of template tags to allow you display images from a Coppermine Gallery.

Tags are provided to display the following:

• A configurable list of albums
• Grid of images from a selected album
• A latest images block to display a configurable number of images that were last uploaded.

This plugin leverages Lightbox2 v2.04 to display the full size version of the images. As this software was not created by me it has not been included within this package. It can be downloaded from http://www.huddletogether.com/projects/lightbox2/#download

The plug-in supplies a settings page which allows the user to enter the Coppermine database details and the display settings.

The gallery on this site uses this plugin.

Installation

Installing the WordPress Coppermine Plugin is simple:

1. Unzip ‘id-coppermine-plugin.zip’ in to the ‘/wp-content/plugins/’ directory.
2. Activate the plugin through the ‘Plugins’ menu in WordPress.
3. In the ‘Settings’ menu select ‘ID Coppermine’.
4. Under the ‘General Settings’ section enter the full url to the root of your Coppermine installation i.e. http://www.yoursite.com/copperminedirectory and the Coppermine username of the user for whom to display the images for. NOTE: there should not be a trailing slash in the url.
5. Under the ‘Coppermine Database Settings’ section enter the Coppermine web server and database details. These details will not be validated so you will only find out if they are incorrect when you try to view a page using one of the template tags. This allows you to be able to change the details at any point.
6. In the ‘Display Settings’ section you can set the number of column and rows to display when rendering the gallery, and wether to display the image title and to list the albums.
7. In the ‘Latest Images Settings’ section you can specify the number of images to display when rendering the latest images section.
8. Download Lightbox2 from http://www.huddletogether.com/projects/lightbox2/#download and extract to the same directory as your blog homepage.

Usage

1. Inside the folder of your selected theme create a file called ‘gallery.php’.
2. Open this file using notepad or your favourite text editor and paste the following:

   <?php
   /*
   Template Name: Gallery
   */
   
   /**
    * @package WordPress
    * @subpackage Default_Theme
    */
   
   get_header(); ?>
   
   <div id="gallery" role="main">
   
   <?php
    id_coppermine_render_album_list();
    id_coppermine_render_gallery();
    id_coppermine_render_page_nav();
   ?>
   </div>
   
   <?php get_footer(); ?>

3. Save the file.
4. In the admin menu under ‘Pages’ select ‘Add New’
5. Call the page ‘Gallery’
6. Do not enter anything into the body/text area of the page.
7. Under ‘Template’, select ‘Gallery’ from the drop down.
8. Click publish.

If you change your theme you will need to remember to copy the ‘gallery.php’ file from your original theme directory to your new one.

Donations

Although this plugin is provided free of charge please consider making a small donation to the Vulcan to the Sky Trust.