Plugins for the Coppermine Photo Gallery are add-ons that use the plugin interface of Coppermine.
Read up the documentation that comes with Coppermine to find out more, e.g. how to install a plugin.

Coppermine version: cpg1.4.x
Plugin name: Album Directory arranged by Categories
Plugin version: 1.1
Plugin author: wirewolf
Plugin announcement thread: http://forum.coppermine-gallery.net/index.php/topic,39429.0.html



Coppermine 1.4.10
Gallery Album List Plugin v1.1 by wirewolf, http://academyphotos.net/
Displays an bulleted list of Albums, listed by Category,
See example:
http://academyphotos.net/photogallery/index.php?file=album_directory/album_list

Script:
The script will only list Categories that have at least one Public Album and Albums that have at least one approved file.
While always best to have titles for the files, this script will also check for a title, and if there is none, it will substitute the filename.

Install:
unzip package and upload album_directory folder as is to plugins folder and use plugin manager to install it.
if you're not sure, read - How to install plugins - http://coppermine-gallery.net/forum/index.php?topic=24327.0

Language:
english only available in the package. You can translate into your language, please share if you do.

Options:
The script as is defaults to showing the 'The Latest, the Greatest and Pot Luck!' screen with Image CSS pop up preview below the Album List. See example above. You can toggle this option on or off, and you can also select preview or no preview. In the codebase.php file look for and edit the following lines:

// CONFIGURATION OPTIONS - BEGIN - THIS ARE THE ONLY LINES YOU NEED TO EDIT!!!

// define ALBUM_LIST_SCREEN for true or false
// true - use 'The Latest, the Greatest and Pot Luck!' screen
// false: don't use 'The Latest, the Greatest and Pot Luck!' screen

define('ALBUM_LIST_SCREEN',true); 

// if you define ALBUM_LIST_SCREEN as true, then define ALBUM_LIST_PREVIEW for true or false
// true:  use image css preview - pop up window, false: don't use image css preview - just normal url links

define('ALBUM_LIST_PREVIEW',true);

// if you define ALBUM_LIST_PREVIEW as true, then you can define the preview image width here,
// 200 default (200 pixels, 150 pixels works well too)

define('IMAGEWIDTH', 200);

// if you define ALBUM_LIST_PREVIEW as true or false, define limit here.
// limit is the number of thumbnail columns and the column spans. 3 or 4 works well.

define('LIMIT', 4);

// CONFIGURATION OPTIONS - END - DO NOT EDIT ANY LINES BELOW!!! REALLY!!!

I've played around a lot with these values, and the image width of 200 seems to be a good number. 150 works well too. But any value larger than 200 blows out the page too much and anything less than 150 doesn't seem worth it. Also, the value of 3 or 4 for the number of thumbnails works well too. I originally set the LIMIT to cpg's $CONFIG ['thumbcols'] (same as the thumbnail page, set in the Admin Panel), but decided to keep this script independent. Some users may not select the use of thumbnail pages.

A note on the imagewidth. The script calls for the 'normal' image as stored in the filepath folder, then sets only the width, not the height. If you set a certain width, the height will automatically adjust.

Options within the preview script:
If you select to use the ALBUM_LIST_PREVIEW, you also have edit options in the album_list_css.php file as well
At the top of this file, look for:

/*************************
edit the border, background and text colors; window width,
font sizes and number of thumbnails below for the preview
you can match to your theme. but if you use multiple themes
than I suggest leaving the border, background and text colors
as black #000000, white #FFFFFF and black #000000 respectively
*************************/

$border = '#000000'; // border color of the window
$background = '#FFFFFF'; // background color of the window. 
$textcolor = '#000000'; // text color in the window
$fonttitle = '11px'; // sets title font size
$fontwindow = '10px'; // sets window font size
$fontfamily = 'Verdana, Arial, Helvetica, sans-serif';
// comment out below line to remove shadow. works in IE only
$filter = 'progid:DXImageTransform.Microsoft.Shadow(color=gray,direction=135)';
/*************************
do not edit these next two lines! unless you feel like playing around!
You can use a '-' (minus) also to move the position. EM is a percentage '1EM or '-1EM',
or set actual pxs '-15px' or '15pxs' The position of the css window span is measured
from the left side of the Image Title - "This is a Title",
the span position (top) (left) would be at the start of the 'T' is the word 'This' 
*************************/
$top = '0EM'; // sets the window position over the Image Preview Title 
$left = '0EM'; // sets the center window position over the Image Preview Title

/*************************
NOTE I suggest you don't edit the z-index's, or the position or display values!
*************************/

For now I suggest leaving the default values. Try the script out and get used to it. Edit the codebase file first for ALBUM_LIST_SCREEN, ALBUM_LIST_PREVIEW, IMAGEWIDTH and LIMIT and see how it works. Then play around with the other values if you want.

Enjoy! wirewolf
