![[ICO]](/icons/blank.gif){kind=icon}
![[ ]](/icons/unknown.gif){kind=icon}
![[TXT]](/icons/text.gif){kind=icon}
![[IMG]](/icons/image2.gif){kind=icon}
![[DIR]](/icons/folder.gif){kind=icon}
Welcome to Gallery 2. This is the official release of Gallery 2.3, code named “Skidoo”. Please read through this document carefully before installing Gallery 2 and before asking for help. We have taken care to try to answer as many of your questions here as possible. If you don't read this and have problems, we may refer you back to this document as a first resource.
If you’re impatient like us, you just want to get going. The odds are that your system is all set to handle Gallery 2 so just skip right to the installer and start clicking. It should walk you through everything you need to get going. If you hit a snag, please come back here and read more before asking questions! Enjoy.
Gallery is a web based software product that lets you manage your photos on your own website. You must have your own website with PHP and database support in order to install and use it. With Gallery you can easily create and maintain albums of photos via an intuitive interface. Photo management includes automatic thumbnail creation, image resizing, rotation, ordering, captioning, searching and more. Albums and photos can have view, edit, delete and other permissions per individual authenticated user for an additional level of privacy. It's great for communities - give accounts to your friends and family and let them upload and manage their own photos on your website!
In preparation of the Gallery 2.3 release, we retained Gotham Digital Science (GDS) to a perform security audit on Gallery 2. They are experts in application security, as this is the primary focus of their business.
We recognize that hiring external consultants to perform security audits does not guarantee that our code is bug-free and by no means un-hackable, but it clearly indicates our willingness to perform due diligence to make sure our code is reasonably secure. The combination of an external perspective of security experts and the insight of internal experts both performing detailed audits is yielding much better results than only one of the two perspectives alone.
Audits of previous releases were done by the following origanzations:
The Gallery project treats security issues very seriously. If you find a security flaw, do not hesitate to email us at:
Over four years of design and development have gone into making Gallery 2 the best online photo management product available. We have made it easy to add new features while keeping them in separate modules so that you can customize it to only have the ones that you want. For those of you who like standards, we have strict XHTML compliance but give plenty of power to our themes so that you can make it look the way that you want. It's a powerful application and you're in the driver's seat.
You can choose from four different packages:
You get to pick and choose which modules you activate, so even if you download a package that has more modules than you need you can always choose not to activate the ones you don't want. You can also activate a module and test it out for a while, then later deactivate and uninstall it. You can also delete any modules/themes that you're not using if you want to save space.
All of our modules and themes are available separately so if you install a smaller package you can still add more functionality later on, either by downloading yourself or using the Downloadable Plugins feature in the Site Admin section.
Download Gallery packages, modules and themes from the Gallery Download Page.
$ cd $HOME
$ mkdir g2data
$ chmod 777 g2data
C:\> mkdir g2data
$ mysqladmin -uroot create gallery2
$ mysql gallery2 -uroot -e"GRANT ALL ON gallery2.* TO
username@localhost IDENTIFIED BY 'password'"
$ createdb gallery2 -E UNICODE
If it complains that UNICODE is not a valid encoding name, then try:
$ createdb gallery2 -E SQL_ASCII
If it complains about that, too then try:
$ createdb gallery2
$ create database gallery2 {additional parameters};
$ db2 "create database gallery2 using codeset utf-8 territory us pagesize 32 k"
C:\>sqlcmd -S myhostname\SQLEXPRESS -e
1>create database gallery2
2>go
1>use gallery2
2>go
1>create schema g2user
2>go
1>create login g2user with password = "g2pwd"
2>go
1>create user g2user for login g2user with default_schema = g2user
2>go
1>use master
2>go
1>grant CONTROL SERVER to g2user
2>go
1>quit
Your PHP must include PHP Data Objects support, but no other setup is required.
Gallery 2 is a web application and must be installed on your web
server in order for you to use it. If you've unpacked it on
your desktop, you will have to upload it to your server as part
of the install process. Then you can configure it using your web browser.
As an alternative to the lengthy upload via FTP, take a look at the
Gallery 2 Pre-Installer.
$ tar xzf gallery2.tar.gz
$ unzip gallery2.zip
Once you’ve successfully got Gallery 2 installed, you should take a look at the Gallery 2 Quick Start Guide. It will help you get started with Gallery and will walk you through the steps from zero to managing your first photo album in your freshly installed Gallery. Below are some links to your gallery that will make it easier for you to follow the Quick Start Guide. Note: You may need to activate certain modules to be able to use some of these links.
Take a look at the list of User Contributions to find even more modules, themes, utilities, mods and more.
Updating is quick and easy and should not lose any of your data.
Third party modules and themes designed for Gallery 2.0 will not work with Gallery 2.3. During the upgrade process, these modules and themes will be automatically deactivated for you. You can find updated versions for most of these modules and themes here: http://codex.gallery2.org/Gallery2:User_Contributions
There are many resources available to you if you're having problems with Gallery:
Remember – reporting bugs is good. Even if you think it’s silly, go ahead and report it. We can always close the bug or refile it (please don’t be offended in this case) but it’s harder to find bugs than it is to fix them so we’re counting on you to help us with the finding part.
Check our Known Issues list and Bug Tracker for information and some workarounds for known problems.
Unit Tests - Gallery 2 was designed using Extreme Programming methodologies. This
means that we have over 2,000 unit tests that ensure code
quality. If you want to help us out, you can try running
the unit tests and report back to us if any of them fail.
Note - these tests shouldn’t change your Gallery 2 settings at all, but if they fail, they may leave things in a weird state. Be warned that there's a slim chance that you might have to ditch your Gallery 2 data and start over if something catastrophic happens.
For Themers - There is now some theme documentation that you should read if you want to change the look of your Gallery 2 by customizing an existing theme and its templates or by creating your own theme.
Localization - If you’re interested in localizing Gallery 2 into another language, you can review the current state of localization and then read the localization how-to and get started. Submit your localizations early and often - no need to wait until you’re entirely done.
For Developers - We've gotten started on some developer documentation that you should read if you want to start hacking on Gallery 2. Some of the information is a little bit out of date or in early drafts, but it's a start.
Embedding - To learn more about embedding Gallery 2 into your website and about existing integrations in content management systems, portals, blogs etc. please see Gallery 2 Embedding.
Copyright (C) 2000-2008 Bharat Mediratta $Id: README.html 18171 2008-10-17 04:40:36Z andy_st $