Thank you for downloading the Rin CPG theme ported from a WordPress theme by Khaled Abou Alfa and Joshua (http://www.brokenkode.com/manji).

I've overwritten some of the configuration settings by using variables in the theme.php file and added a new variable for retrieving the album description. The reason for this is to prevent the standard settings in the Configuration tables set by you from "breaking" the theme. If you wish to change these settings, do so here or delete them altogether and use the Configuration Manager in Coppermine. These changes are:

// These parameters overide what the user inputs in the Configuration setup to prevent the theme from breaking.
$CONFIG['max_film_strip_items'] = 5; //overrides the number of thumbnails.
$CONFIG['thumbcols'] = 4; //overrides the number of columns for thumbnails.
$CONFIG['main_table_width'] = '100%'; //overrides the Width of the main table (pixels or %).
$CONFIG['picture_table_width'] = '100%'; //overrides the Width of the table for file display (pixels or %).
$CONFIG['album_list_cols'] = 2; // sets "Number of columns for the album list = 3"
$CONFIG['first_level'] = 0; //sets "Show first level album thumbnails in categories = no".
$album_desc = get_album_desc($_GET[album]);

This theme has the first level of album thumbnails turned off to make large galleries look move attractive. This will prevent the main page from being cluttered with thumbnails and easier to chose a particular category. There is also a new function for truncating the album descriptions when viewing on the index or category pages. When you view a single album, the full description is printed out at the top of the album. This makes the index and category pages much cleaner looking. I've also adapted it to truncate long image captions when viewing on a thumbnail page but prints the full caption when viewing the intermediate image.

To edit the number of characters in the truncated album description, find in 2 places in the theme.php file - '{ALB_DESC}' => myTruncate($album['album_desc'], 20, " "), and change the number (20) to any length your desire. You can also change the padding characters (...) to any other set of characters by editing function myTruncate($string, $limit, $break=".", $pad="...") in the theme.php file.

To edit the number of characters in the truncated image caption, find in 2 places in the theme.php file - '{CAPTION}' => myTruncate($caption, 120, " "), // changing the number changes the # of characters printed for the thumbnail caption. and change the number (120) to an length you desire. This number doesn't seem to be match the string length but it is consistant so change it and view the results.

I've also adapted the compute_img_size($width, $height, $max) function to manage the size of the intermediate image. As in some cases (example would be the Coppermine demo page), some galleries have intermediate images of different sizes. This function was changed and added to the theme.php to make view all intermediate images at 400px wide. This function is now compute_img_size_max($width, $height) and you can change the view size by editing $max = 400;. If you have intermediate images smaller than 400px wide then this function will increase the image size when viewing which could result in a distorted image. Since the default size in Coppermine is "400", this should not be a problem unless you've decreased it. This setting in the theme.php file does not affect the setting in your Coppermine configuration but only resizes the images in the browser. Here's a link to additional info in the manual - http://coppermine-gallery.net/demo/cpg14x/docs/index.htm#admin_picture_thumbnail

Please enjoy the theme and make all the changes you need to suit your gallery.

Cheers,

Billy
http://www.billygbullock.com

/*
Theme Name: Rin
Theme URI: http://www.brokenkode.com/rin/
Description: Nebula flavoured Rin
Version: 1.0 
Author: Khaled Abou Alfa
Author URI: http://www.brokenkode.com/
Ported to CPG by: Billy Bullock
Porter URL: http://www.billygbullock.com
Coppermine Theme Version: 1.1.0
Tested on CPG v1.4.18
Released on August 10, 2008

License -
The CSS, XHTML and design is released under GPL:
http://www.opensource.org/licenses/gpl-license.php

This program is free software; you can redistribute it and/or modify it under 

The terms of the GNU General Public License as published by the Free Software 
Foundation, version 2 of the License.

This program is distributed in the hope that it will be useful, but WITHOUT ANY 
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A 

PARTICULAR PURPOSE. See the GNU General Public License for more details.
*/