Index of /modules/xcgal

[ICO]NameLast modifiedSizeDescription

[DIR]Parent Directory   -
[TXT]COPYING 14-Jan-2015 08:00 15K
[TXT]addpic.php 14-Jan-2015 08:00 3.3K
[TXT]admin.php 14-Jan-2015 08:00 3.0K
[DIR]admin/ 27-Aug-2019 15:49 -
[TXT]albmgr.php 14-Jan-2015 08:00 5.4K
[DIR]albums/ 27-Aug-2019 15:49 -
[DIR]blocks/ 27-Aug-2019 15:49 -
[TXT]comment_delete.php 14-Jan-2015 08:00 2.4K
[TXT]comment_edit.php 14-Jan-2015 08:00 3.1K
[TXT]comment_new.php 14-Jan-2015 08:00 3.4K
[TXT]comment_post.php 14-Jan-2015 08:00 3.1K
[TXT]comment_reply.php 14-Jan-2015 08:00 3.1K
[TXT]db_input.php 14-Jan-2015 08:00 10K
[TXT]delete.php 14-Jan-2015 08:00 13K
[TXT]displayecard.php 14-Jan-2015 08:00 4.5K
[TXT]displayimage.php 14-Jan-2015 08:00 19K
[TXT]ecard.php 14-Jan-2015 08:00 13K
[TXT]editpics.php 14-Jan-2015 08:00 17K
[DIR]images/ 27-Aug-2019 15:51 -
[DIR]include/ 27-Aug-2019 15:49 -
[TXT]index.php 14-Jan-2015 08:00 19K
[DIR]js/ 27-Aug-2019 15:49 -
[DIR]language/ 27-Aug-2019 15:49 -
[TXT]modifyalb.php 14-Jan-2015 08:00 11K
[TXT]ratepic.php 14-Jan-2015 08:00 4.9K
[TXT]readme.txt 14-Jan-2015 08:00 5.2K
[   ]scripts.js 14-Jan-2015 08:00 2.1K
[TXT]search.php 14-Jan-2015 08:00 2.7K
[TXT]showthumb.php 14-Jan-2015 08:00 5.2K
[DIR]sql/ 27-Aug-2019 15:49 -
[TXT]style.css 14-Jan-2015 08:00 3.5K
[DIR]templates/ 27-Aug-2019 15:49 -
[TXT]thumbnails.php 14-Jan-2015 08:00 7.0K
[TXT]upload.php 14-Jan-2015 08:00 7.4K
[TXT]xoops_version.php 14-Jan-2015 08:00 21K

Coppermine Photo Gallery - README

Coppermine Photo Gallery v1.1.0

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

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.

Changing the content of the main page

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

Formatting album and image descriptions

Coppermine understands the following bbCodes (the same bbCodes that are used by phpBB) in image and album description

Using Windows XP Web Publishing Wizard with Coppermine

If you are using Windows XP, you can use its builtin 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.

Creating your own themes

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.

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 -->.

Safe mode issues

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 :

Using SMTP to send emails

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.

Upgrading from version 1.0

If you already have installed version 1.0 and you want to transfer your albums to version 1.1 proceed in the following way:

This upgrade process leave your v1.0 gallery untouched

Upgrading from a previous Beta of version 1.1

Unpack the archive, delete the file config.inc.php that may possibly exist in the "include" directory and the file install.php (you don't need to run the install script when doing an upgrade). Upload the new files to your server overwriting the existing ones

Translating Coppermine into other languages

Coppermine has now 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 your own language, you can mail your language file to copper_lang@chezgreg.net.

Credits

Language file translation :

Note : if you have corrections to suggest on language files, mail them directly to the author of the translation.

 

Chinese (Big5) MyScripts & Math http://www.winpon.tw300.com/
Danish Jan Ole Laugesen http://www.tommerup.net/
Dutch Ron Bos http://www.ronbos.nl/
Finnish Ville Taavila  
French Niko http://www.chien.com/mustang/
German GauGau http://www.gaugau.de/
Greek Lykourgos
http://www.lykman.com/
Spanish Daniel Villoldo http://www.proel334.net/album/

Coppermine uses code from the following free softwares :

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/

Copyright and disclaimer

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.