xcGallery 1RC1

xcGallery is a gallery modul for xoops 2.0.x based on coppermine photo gallery 1.1.0 © Grégory DEMAR.

This Version is the first release candidat, this means it isn't stable and maybe there are some little bugs. If you find any bugs then be so kind and submit them to the bug tracker on the projects page (http://www.myxoopsforge.org/modules/xfmod/project/?xcgal). 

xcGallery is relased under the GPL. For licenses infomations read the copying file, please.

Requirements:
- working xoops 2.0.x installation (with php/mysql)
- For image resizing you can use GD(without gif support), ImageMagik or Netpbm(still experimental)

Installation:
For installation put the xcgal directory into your xoops module dir. Set albums and its including userpics dir read and write able. Go to xoops admin panel and install xcGallery with the xoops module installation. If you have done this successfully, go to the xcgallery preferences and make your settings. Now, it's important that you go to the xcGallery group manager for creating the default groups.
Afterwards, you can create your first category with the categories manager. For pic uploading you need also to create at least on album, you can do this on the user side.

Some settings explanation:

"Album list view: The content of the main page"
Here you can arranged the content of the gallery main page. Use following abbreviation(without ') seperated with a /:
'catlist': for diaplaying the category list 
'alblist': for diaplaying album list 

'random,x': random pictures with x rows
'lastup,x': last uploads with x rows
'topn,x': most viewed with x rows 
'toprated,x': top rated with x rows
'lastcom,x': last comments with x rows 
'mostsend,x': most sent ecards  with x rows
'lasthits,x': last hits with x rows

Example: 'catlist/alblist/random,2/lastcom,2/lasthits,1' this displays the category and album list, 2 rows of random pics, 2 rows of last commented pics and 1 row of the last hits. 
Excluding catlist and alblist, you can use this commands for the meta albums block, too.

"Method for resizing images"
For resizing you can select gd1, gd2, ImageMagick or Netpbm. If you select ImageMagick or Netpbm enter the path to your utilities into the field below. You don't need to enter the path to your utilities if Netpbm/ImageMagick path is including in your Environment path. You can see this easily in your phpinfo(e.g. Apache Environment...PATH).
If you fillout the path field be sure that you have entered the full path and used the right slashes, use \ for windows and / for *nix.

"Custom fields" 
There are 4 free defineable custom fields for additional infomations for pics. They appear on the image display and upload only if you give them a caption.

"EXIF"
If you want to have exif data displayed for your images, you need to run php the exif extension.

"Gallery debug mode" 
This is a leftover from coppermine, because we have the xoops debug modes, but it's maybe useful for theme developers...it doesn't show any errors, but the get, post and gallery cookie content.

"Ecard settings"
For ecards you can select html or text ecard, if you select html card, then the card will be generated from the xcgal_discard.html template, it's also used for picking up the cards if you have selected text cards. I keept this template really simple so feel free to fit it for your needs, but beware don't forget that it's used twice, for picking and sending ;-)
The ecard sending works not with sendmail, if you have selected sendmail on your xoops mailsetup it will try to use php mail. It works well with php mail, smtp and smtp auth. (i hoppe).
For anti spaming you can set a limit for sending ecards per user/hour.

How does the group manager work?
You can set several permissions for your group, they have only effect if the groups have access rights to the xcGallery module. If you have one user in several groups, then the group manager selects the best settings for this user(e.g. user "test" is member of group "a" and "b", group "a" has a quota of 500kb and no upload approvals, group "b"'s quota is 1024 kb and but they need upload approval,now, the best setting for our user "test" is a quota of 1024kb and no upload approval.

Safe Mode:
If php runs on your server the safe mode enabled, you can't use xcGallery as it is, but there is a workaround. I haven't test this option, but it works only! then the safe mode configuration is faultily. To try this out, open the xcgal/include/init.inc.php go to line 36 and uncomment "//define('SILLY_SAFE_MODE',1);" (delete the slashes;-)) ans save it now go and try it, may be you have luck.

You will see that this gallery has much function and i don't want to explain them all, sorry guys ;-)
So, try it out, test it and use it!

If you have any questions, feature requests or if you have found a bug use the projects forums and trackers at myxoopsforge.org, thanx.

Keep in mind that this is only a rc and that other features like multiple uploads for users, notifications, image manipulations... will be included in further releases, but the important thing at the moment is to make this gallery as stable as possible. 

Ok...i think this is enough
greetz
derya

xcGallery 1RC1 © Derya Kiran (meeresstille@gmx.de)
Project Page: http://www.myxoopsforge.org/modules/xfmod/project/?xcgal
Demo at http://www.myxoopsforge.info/modules/xcgal/