Coppermine Photo Gallery is a picture gallery script. Users can upload pictures with a web browser (thumbnails are created on the fly), rate pictures, add comments and send e-cards. The admins can manage the galleries and batch add pictures that have been uploaded on the server by FTP.
Images are stored in albums and albums can be grouped by categories. The script supports multiple users and each user can possibly have its own set of albums.
The script also supports multiple languages and has a theme system. It uses PHP, a MySQL database and the GD library (version 1.x or 2.x) or ImageMagick to make the thumbnails. An install script makes the installation fast and simple.
What is required
How To Install The Script
Getting Started
Changing the content of the main page
Formatting album and image descriptions
Using Windows XP Web Publishing Wizard with Coppermine
Creating your own themes
Safe mode issues
Using SMTP to send emails
Upgrading from version 1.0
Upgrading from releases of version 1.1
Integrating the script with your bulletin board
Translating Coppermine into other languages
Credits
Login with the admin username and password, click on the "admin mode" link if it is visible, go to the Config page and start to configure your gallery. Note that even if you are a member of the administrator group, you need to be in "admin mode" to configure your gallery.
Use the anonymous group to define what non-regsitered users can and can't do.
Use the "Album Manager" ("Albums" link in the admin menu) in to create and order your albums.
Use the properties of an album to modify its description and permissions.
In order for a user to be allowed to upload a picture in album two conditions must be met:
The same apply to picture rating and comment posting.
If you have installed the script succesfully but are having trouble getting it working properly you can enable the "debug mode" on the config page. In this mode, the script outputs most of the warning/error messages produced by PHP in addition to some debug information. This can provide valuable information to understand what is wrong.
On the config page, you have an option called "The content of the main page". Here you can define what is displayed on the main page of the script.
The default value is "catlist/alblist/random,2/lastup,2"
You can use the following "codes"
The ,2 means 2 rows of thumbnails
Coppermine understands the following bbCodes (the same bbCodes that are used by phpBB) in image and album description
If you are using Windows XP, you can use its built-in web publishing wizard to upload your photos to your gallery.
Once you have properly installed the script on your server, call the xp_publish.php file from your web browser (http://your_site.com/coppermine_dir/xp_publish.php).
The script displays some information on how to do the installation on the client side and how to use the Wizard. Basically you will need to download a small file created by the script that needs to be loaded into your Windows registry.
Coppermine themes are stored in the "themes" directory, they consist of 3 files :
To create a new template the best solution is to use an existing one as a basis. Do do that make copy of the folder of the theme you want to use as a basis then edit the "template.html" and "template.php" files and replace all occurences of "themes/old_theme_dir" with "themes/new_theme_dir" in order for the links to point to the correct place.
When editing the "template.html" file do not remove the elements between {} these are the placeholders used by the script. Also keep in mind that despite this file being located in the "themes/your_theme_dir" directory, it must be build like if it was in the main directory of the script. Practically to load an image, you must use <img src="themes/theme_dir/images/image.gif" alt=""/> and not <img src="images/image.gif" alt=""/>. The same apply for the "theme.php" file.
Also, make sure not to delete the line <script type="text/javascript" src="scripts.js"></script> that is needed for the full-size pop-ups and other stuff related to JavaScript.
If you are using an HTML editor to make your template, the best solution is that you copy the "template.html" file into the main directory of the script and edit it there. If the script find a file named "template.html" in the main directory it will load it instead of the one of the theme directory. Once you have finished your editings, move the file back to the directory of your theme.
To modify the colors, fonts, font sizes, etc... used by the script, edit the "style.css" stylesheet. If you want to increase or decrease the size of the fonts you can simply modify the line with : table { font-size: 12px; }. Most of the font sizes used by the script are defined as a percentage of this size.
The "theme.php" file contains all the HTML templates used by the script. You can also edit them. When making modifications to these templates, don't touch the lines with <!-- BEGIN xxx --> and <!-- END xxx -->.
A significant number of webhost on the Internet run PHP in safe mode. Coppermine runs without any problem in safe mode and with the "open basedir restriction" active, provided safe mode is properly configured. Unfortunately on many hosts, safe mode is not configured properly.
If your webhost is running PHP in safe mode but is misconfigured, you may need to do the following :
By default the script uses the PHP built-in mail function to send emails. In some cases, the PHP built-in function can't be used.
If in order to send emails with PHP you need to supply a hostname, a username and a password, you need to edit the file "include/mailer.inc.php" and put the correct values there ($CONFIG['smtp_host'] = 'smtp.somewhere.com'; $CONFIG['smtp_username'] = 'username'; $CONFIG['smtp_password'] = 'password';). If you don't need a username and password to connect to your SMTP server, just leave them blank.
If you already have installed version 1.0 and you want to transfer your albums to version 1.2 proceed in the following way:
This upgrade process leaves your v1.0 gallery untouched
Coppermine can be integrated with the following bulletin boards (eg. Coppermine and your bulletin board will share the same user database)
The login integration use your bulletin board cookies, therefore it won't work if your board cookies are not visible by Coppermine. So unless you are an expert, keep things simple and install Coppermine and your bulletin board on the same domain. Example :
If you are using phpBB 2, go to the admin control panel and check that "Cookie domain" corresponds to your domain, "Cookie name" is "phpbb2mysql" and "Cookie path" is "/".
If you are using Invision Power Board, go to the "admin control panel / board settings / cookies" and check that all fields are blank. If they are not, you modified the default values and you are an expert.
If you are using vBulletin, go to the "admin control panel / vBulletin options / HTTP Headers and output" and check that the value for "Cookie Domain" corresponds to your domain and that "Path to save cookies" is "/"
It is also recommended that you use the same database for your board and Coppermine.
You will also need to perform the following operations after having unpacked the archive on your harddrive and before uploading the files to your webserver :
Edit the file include/init.inc.php. At the beginning of the file you will find the following lines :
// User database integration // Uncomment the applicable line if you want to use it // define('UDB_INTEGRATION', 'phpbb'); // define('UDB_INTEGRATION', 'invisionboard'); // define('UDB_INTEGRATION', 'vbulletin');
Un-comment the line that corresponds to the bulletin board you use (eg. remove the "//" that are at the beginning of the line)
define('UDB_INTEGRATION', 'phpbb');
The go to the bridge directory and open the file that corresponds to the bulletin board you use (eg. phpbb.php).
At the beginning of the file there are a number a configuration values that need to be set. For phpBB they are the following :
// database configuration define('PHPBB_DB_NAME','phpBB'); // The name of the database used by the board define('PHPBB_BD_HOST','localhost'); // The name of the database server define('PHPBB_DB_USERNAME','root'); // The username to use to connect to the database define('PHPBB_DB_PASSWORD',''); // The password to use to connect to the database // The web path to your phpBB directory // In this example http://yoursite_name.com/phpBB2/ define('PHPBB_WEB_PATH','/phpBB2/');
Modify them according to the configuration of your board and save the file.
Upload all files onto your webserver and run the install script. Note that the admin username and password you enter during the installation will be ignored by the script. To login as an admin, you will need to use the admin username and password of your board.
Once you have completed the installation, login using the admin account of your board. Go to the gallery, enter admin mode and click on the "Groups" button. This will synchronize Coppermine groups with those of your board. The permission you will see for each group will be completely messy, so take some time to set them properly.
Each time you add or delete a group in your board you will need to do the operation above in order to keep the synchronisation of the groups.
When you will try to login / logout or manage users from Coppermine, you will be redirected to the corresponding page of your bulletin board. Once the login or logout is performed you won't be redirected automatically to the gallery because your board does not have any function for that. It's up to you to add a link on your board to get you back to the gallery.
Coppermine has a separate language file that make the translation of the script much more easy. The language files are stored in the lang directory. The files with the utf-8 suffix are unicode encoded files. They are automatically generated with the iconv program so there is no need for you to make an unicode version of your translation.
If you select an utf-8 language file as the default one, then the script will be able to automatically select a language file based on the visitor browser configuration. For instance if the default language file is danish-utf-8 and an english visitor access your gallery, the english-utf-8 language file will be used by the script.
If you have translated Coppermine into a language not already supported, please visit the Coppermine Web Site at Sourceforge and follow the instructions for submitting your language.
Note : if you have corrections to suggest on language files, mail them directly to the author of the translation.
The list for the CPG 1.2 translators can be found in credits.html
phpBB
Author: phpBBGroup
URL: http://www.phpbb.com/
phpMyAdmin
Author: phpMyAdmin devel team
URL: http://www.phpmyadmin.net/
phpPhotoAlbum
Author: Henning Støverud
E-mail: henning@stoverud.com
URL: http://www.stoverud.com/PHPhotoalbum/
The following slight quirks and tiny issues are known and will be fixed in future releases.
This application is opensource software released under the GPL.
BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
Coppermine Photo Gallery is Copyright © 2002, 2003 Grégory
DEMAR, All Rights Reserved.