Gallery 3.0 Alpha 4 is ready!

It's here, the latest technology preview for Gallery 3. In the last 6 weeks we've been busy fixing bugs and adding features. The original plan called for us to have a beta release by now, but that's taking a little longer than expected so we'd like to share the Alpha 4 release with you now so that you can continue to play with the product and give us your feedback. In a hurry? download it now!

Intended audience

Alpha 4 isn't quite game ready yet. We've still got big changes to make so this technology preview is still aimed at enthusiasts, designers and module developers. But if you're interested, this is the perfect time to do a test drive with the improved user interface and to start developing feature extensions and designing new themes.

Security warning

This is a technology preview of Gallery 3.0 and as such it is not intended to be installed on public websites yet. The application has undergone a professional security audit, which has identified some security vulnerabilities and will be fixed before the final release. Please resist the temptation to share your test drive with the world and wait for the final release first!

Let's go!

With the disclaimers and warnings out of the way, here it is: Download Gallery 3.0 Alpha 4 (1.2 MB) or retrieve directly from the SourceForge repository:

svn co

The Gallery 3 Philosophy

Gallery 3.0 is easy and fun to customize. We have made every effort to make it much easier for the casual developer to hack on the product. You don't need a computer science degree to do something really cool with it! And our user-centric development process ensures that the user interface is not an afterthought.

  • Scope and target audience - Before starting development on Gallery 3.0, the target audience and the scope of the application were clearly defined. Gallery 3 is not a general purpose web application handling any file format you throw at it. And it's not supported on every web platform that exists. It's highly targetted.

    Prudent decisions helped to simplify the product at a very early stage. For instance, there are no longer photo-level permissions. Permissions are managed on an album level. Most of our users don't effectively use photo-level permissions and this simplification extends from the database up to the user interface.

  • Simplicity - We're glad to have usability and user interface experts on our team, designing and prototyping interfaces that just make sense. The emphasis is on making simple, frequent tasks quick and easy. To see an example of this, check out the admin dashboard and the user/group administration page.

  • Size matters! - Gallery 3.0 is currently a mere 4.3MB (uncompressed on your disk), with all its features. Compare that to the 16.5MB of Gallery 2.3's bare bones minimal package. Leaving out some levels of abstraction really helps to lose some weight!

  • On the shoulders of giants... - Gallery 3.0 is made possible by some truly great advances in technology.

    • We evaluated many PHP frameworks before choosing Kohana. It makes PHP application development simple and fast. Thanks to the Kohana folks for providing this first class application framework!

    • PHP 5. We're taking advantage of many of the new features and capabilities available in the latest versions of PHP. This allows us to write less code and have a faster product.

    • We're using jQuery to create the rich user interactions in the browser that make the application fast and light. Especially with with jQuery UI and a host of plugins, UI development couldn't be more hassle-free.

  • Easily customizeable - Did you know you can create your own theme just by copying an existing theme to a new folder? How's that for easy? There's no new templating language.. if you know HTML and PHP you can start hacking today.

  • Simple to extend - We've worked hard to keep things simple. You can write your own module complete with installer, menus and theme integration in just a few lines of code. And to make life easier, we've created a Developer module that gives you a point and click way to create your own modules.

  • Fewer configurations - We support Gallery 3 on Unix running MySQL 5, Apache 2.2 and PHP 5.2. By restricting the number of platforms that we support, we can put out high quality releases faster. Gallery 3 may work with MySQL 4.1, IIS and other platforms but the Gallery team is going to focus its energy on making the best possible product on the supported configurations.

What's new in this release?

  • Bulk editing interface (alpha 4)
  • Gallery 2 to Gallery 3 import (alpha 4)
  • Tag management for admins (alpha 4)
  • 41 closed tickets in the alpha 4 release
  • Support for database table prefixes (alpha 3)
  • Random image block for the sidebar (alpha 3)
  • Module administration view (alpha 3)
  • Added translation server and localization client (alpha 3)
  • Reimplemented the Flash uploader using SWFUpload (alpha 3)
  • Album sort orderers (alpha 3)
  • Add photos directly from the web server (improved in alpha 3)
  • User/group/permissions management UI (alpha 3)
  • Auto-login at the end of the installer, with a welcome page (alpha 3)
  • Moved Google Maps and Polar Rose modules out of the official package into the community repository (alpha 3)
  • 58 closed tickets in the alpha 3 release
  • Localized UI with built-in editor (server side support is not finished) (alpha 2)
  • RSS feed for comments (alpha 2)
  • RSS feed for new images or movies (alpha 2)
  • EXIF read support (alpha 2)
  • Add photos directly from the web server (alpha 2)
  • Support for uploading and viewing FLV movie files (alpha 2)
  • Ability to view full size photos (alpha 2)
  • Boolean and full text search (alpha 2)
  • Album browsing
  • Item commenting, comment moderation
  • Spam protection with Akismet and Recaptcha
  • Image toolkit support for ImageMagick, GD, and GraphicsMagick
  • Theme system, including separate admin theme.
  • Module system to extend the functionality, and a series of existing modules
  • Basic metadata boolean search with relevance ranking
  • Flash-powered slideshow (Cooliris)
  • Album media RSS feeds
  • Quick edits of item metadata
  • In place item deletion and rotation
  • User group management (drag & drop interface)
  • Basic user permission management
  • Admin dashboard with drag and drop blocks

Missing Key Features

These features are yet to be added and will be part of the final 3.0 release:

  • Bulk editing of albums and photos (partially available in alpha 4)
  • A migration path from Gallery 2 (partially available in alpha 4)
  • Improved permissions UI.
  • Basic embedding hooks / instructions
  • (opt-in) Stats collection (helps us to improve the product)


Gallery 3.0 has received a professional security audit from our good friends over at Gotham Digital Science. They've dissected the code and probed it for security vulnerabilities, and then reported back to us. We have not yet addressed all of their concerns in this release, but we will resolve all security issues they discovered before the final release. Your security is important to us!

You can track development on our Trac roadmap.

Got feedback?

If you have any overall feedback, please visit the Gallery 3.0 Alpha 4 Feedback forum topic and let us know! If you have questions, please visit the Gallery 3 Wiki, the future home for Gallery 3 documentation.

carterx's picture

Can't wait to give Alpha 4 a try :-)

Oh man, get on with the final release please, delayed gratification is one thing but this is some kind of niche torturous porn tease!!!!

evidence - "resist", "temptation", "probe", "release", "play with". Need I say more!

alexus's picture
AndrewRH's picture

Just installed...looking good; thanks for putting in all the effort.

Could you tell me if it is known that some admin pages don't format correctly? Ticket 244 didn't seem to cover what I experienced...

I created a new album and the screen it went to afterward was just text, like this (I use Firefox 3.0.10 on WinXP):
(click HERE to see picture)

I also got a 404 error when I clicked on the link "Gallery: Your Photos on Your Website" (and others) on that page:
(click HERE to see picture of error message)


Great job, keep up the good work. Looking forward to the actual final release also. Alpha and Betas drive me nuts. Would help speed the process up if we all gave you $5.00 or more? :) :)

floridave's picture
Would help speed the process up if we all gave you $5.00 or more?

'we all'? I bet they would sure try! :-) if 'you all' do. :-)

Blog & G2 || floridave - Gallery Team

bharat's picture

We actually finished the entire product 3 months ago, we're just releasing it slowly to drive you guys crazy :-D

But seriously.. the best thing you can do to speed this along is to use gallery 3, get your friends to use it and leave a lot of feedback. Help each other in the forums, help us keep our bug tracker clean and in order and we'll keep cranking away on the code as fast as we can.

I install a fresh alpha-4, import pictures from gallery2, download translation (I submitted Traditional Chinese translation on alpha-2 and alpha-3 before), then do some translation. When I submit it again, it fails.

--- error message ---


core/helpers/l10n_client.php [188]:

Stack Trace

* core/controllers/admin_languages.php [51]:
l10n_client_Core::submit_translations( )
Admin_Languages_Controller->share( )
* core/controllers/admin.php [49]:

(Need to paste more messages?)

I'm sure this is mentioned somewhere... Can I install Gallery 3 Alpha 4 on the same web and database server as a G2 install, import the G2 data, without affecting the G2 database tables and file system? In other words, will G3 create it's own database tables and g2data folders or update the G2 ones?

Sorry, I'm not quite sure how Gallery works yet. I want to test G3 with my G2 data but not hurt my existing G2 install. Thanks.

bharat's picture
@engineer I'll get our i18n/l10n dev to take a look into this.

Steps to import Gallery 2 to Gallery 3
  1. Browse to Admin -> Modules and enable the "Gallery 2 Import" module
  2. Browse to Admin -> Settings -> Gallery 2 Import and configure the module. You must provide the disk path to your gallery2/embed.php file, eg /var/www/gallery2/embed.php
  3. Browse to Admin -> Maintenance and click the "run" link for the "Gallery 2 Import" task

  4. The import process will not harm your Gallery 2 install. You can pause/resume it. If it fails or gets hung, please check the files in var/logs for clues and report back.

Make so that the tags were taken from the names or images to mozhnobylo change as you are worth and how I want to do so that the tags do not have this kind: tags / 1, tags / 2, tags / 3, and tags / Wallpaper, tags / picture, tags / photo. I would also like to see in the link of the Cyrillic characters. The huge negative is the use of the gallery / index.php / huge number of pages from the index falls in the transition to the new version.

Sorry if there are mistakes in translation, translated through the dictionary.

Just a clarification question --

If I install Alpha 4, the odds are high that I'll have to delete and reinstall when the first Beta is released, correct? There's still no Alpha --> Beta upgrade module coming with Beta 1?

I was just unclear whether the first Beta would include an upgrade module for the Alphas, or if the Beta would be the first release to guarantee an upgrade path.

THANKS for all your hard work!

bharat's picture

@PRaiD I believe that all of the changes you'd like are in the pipeline for the final release of Gallery3.

@Ericular You will have to delete your Alpha 4 and do a complete reinstall when beta 1 arrives. Our plan is that we'll support upgrades from Beta 1 to the final product.

scaturan's picture

thanks for the release. Are there plans to include "password reset" events in the log entries portion of the admin Dashboard?

danodemano's picture

This ROCKS!!! The words to describe how truly awesome this is just don't exist. I cannot wait for the final release, keep up the great work!!!!!!

bharat's picture

@scaturan that's a great idea! Would you file a ticket for it please?


Regarding the translation submission error. Thanks for reporting! I guess I see your failed submissions in our logs, but I wasn't logging the user id in these error log entries until now. I've improved logging.

There's at least 1 bug and some aspects that need to be improved.
- Bug: The translation client stores some strings without proper quote characters. Working on that now.
- Additionally, the server side rejects the whole batch submission of X translations, when it finds just one issue in one of the translations. Which is described in this ticket:

I'll let you know if the translation client fix is in.

Install was a snap. I am currently toying around with a new theme, and I must admit, I am really liking the simplicity involved. The coding is very straight forward and easy to customize.

I've uploaded some pictures I took from the last STL Cardinals baseball game I attended (with really good seats):

Thanks again to the gallery team for all the hard work!

I planned to learn css menu?

The function of mass upload of files is very convenient, but when you select the images they upload and immediately had to change the headlines after they add, do you could download and run to the front of these images to give a name.

I've just spotted the g2->g3 map table for imported items - which is very very cool. But what happens if you import from more than one G2 installation?

Hey all..
I have a problem with the gallery2 import...
I got this Warning-Massage:
Warning Message

An error was detected which prevented the loading of this page. If this problem persists, please contact the website administrator.

modules/g2_import/helpers/g2_import.php [63]:

g2_import_Core::require(/www/htdocs/..../.../....foto) [g2-import-core.require]: failed to open stream: No such device
Stack Trace


Who can help me or who has any idea?

Strange Error. Alpha 3 did not have this.
On top of every page in Alpha 4 I have this text though gallery 3 seems to work fine..

109.05.07 10:13 B C:\Users\Matt\Desktop\gallery3\core\hooks\init_gallery.php --> /public_html/gallery3/core/hooks init_gallery.php

strange a path to a file on my desktop and a path to the same file on my server all in one long line on top of all pages...

bharat's picture

@PRaiD: we have a lot of improvements for image upload coming, including (I think) the ones you want to see. Stay tuned!

@alecmyers: I hadn't thought of that scenario. We could add an extra column to that table with a source G2 id to work around that if there's a strong need.

@surfpoint: make sure that the path you enter to your G2 ends in "/embed.php"

@Armani2: that's very odd. I'm guessing that something went wrong with your ftp upload because that looks like a log line from a file transfer. Can you try retransfering your gallery3 files again?

GIJosh1516's picture

When loading the Graphics settings page, I receive the following error:

core/controllers/admin.php [25]:


Stack Trace
Admin_Controller->__construct( )kohana/core/Kohana.php [242]:
ReflectionClass->newInstance( )Kohana::instance( )kohana/core/Event.php [209]:
call_user_func( Array
[0] => Kohana
[1] => instance
)kohana/core/Bootstrap.php [55]:
Event::run( system.execute )index.php [61]:
require( kohana/core/Bootstrap.php )Loaded in 0.1253 seconds, using 2.02MB of memory. Generated by Kohana v2.3.3.

This occurs while logged in as admin. I am unable to load any page that requires any level of privilege such as add photo, album, dashboard, etc.


Found the problem, it was IE switching to compatibility mode, I was able to remain logged in after navigating to a protected page. Thought I would share, Thanks!

GIJosh1516's picture

Sorry to double dip,

I was able to upload a few images, but only GIFs were loading. While trying to setup the Graphics toolkits, I receive the following error:

Here are my system's details:

Operating System: Linux
Apache: Apache/2.2.11 (Fedora)
PHP: 5.2.6
MySQL: 5.0.77

Here's the build:
Version: 3.0 pre-beta svn
Albums: 1
Photos: 16

I'm using the latest svn, but thought the toolkit detection was resolved in Alpha 3....

Just tested gallery3 a bit and it looks and behaves great! Looking forward to the B1.

However the gallery2 import does not work for me (It Stalled), tried it 3 times and i got the same error. I DO have around 12k images spread over like 180 albums so im a kinda extreme case though. Here is the error message in the log:
2009-05-09 13:44:46 +02:00 --- error: Uncaught PHP Error: Undefined variable: group in file modules/g2_import/helpers/g2_import.php on line 124

bharat's picture

@Ramis: I think you're seeing which I fixed right after the alpha 4 release. Try a nightly download from and see if that fixes the problem for you.

bharat's picture

@GIJosh1516 Ah, this is a bug. I filed it and have fixed it in subversion so if you get the latest code from svn or wait for tomorrow's nightly you can try out the fix. Alternatively, you can try installing the GD module in your php config.

@bharat: That worked, thanks! I use windows server btw.
The next think on my wishing list would be support for ImageMagick or GraphicsMagick on windows (adding 12k items with GD takes way too much time). I have both of them installed and added to my path, but i suppose that windows is not supported yet.

Looking good! A few permissions got a bit squiffy on import from G2, and I had to tell it about a fair few album cover thumbnails again, but apart from that it appears OK.
Just one thing on permissions - if I enter and album with permissions of "hidden from public" but allowed to view by registered users, even though I'm admin, the images and thumbs are broken. If I change perms to everyone, thumbs can generate and images show. If I change back to private, thumbs break again when I change permissions. It looks like changing the perms from the dropdown of the image representing the album on the front of the gallery that I want to hide, doesn't change permissions. But going into the album, then changing perms, works. Then I get the broken image icon again.

Lack of comments import is the only thing stopping me using it as my primary gallery now, but it's come a long way, some very good work from the team.

Like the Alpha a lot - even after my 'convert' to Mac, I had no issue to setup a test server at
It has a lot of my old theme - seems I have to jump back to develop ...



bharat's picture

@toastmaster the permission system relies on mod_rewrite being around. If it's not, then you'll get behavior like you're seeing now. Do you have mod_rewrite? Check your apache error logs. comment import is coming!

@LFrank nice photos!

Does watermarks module works ?
Any documentations?
Requirements for size?

BassKozz's picture

This is probably really easy, but I can't seem to find it:
Where can I find the setting to change the path where the file/photos are stored?
In G2 it was part of the web install gui (default=g2data), but I didn't notice a section for it on my G3a4 install?

bharat's picture

@yrik: yes it does. Go to Admin -> Modules and enable the module, then go to Admin -> Content -> Watermarks to use it. No size requirements, and minimal documentation.

@BassKozz: right now there's no setting for it. Look for VARPATH in gallery3/index.php .. we currently expect it to be in gallery3/var but you can move it somewhere else and change that variable in index.php

spelesto's picture

And I have a problem with installation on Linux Gentoo machine. When install the script gives this error: PHP is missing the filter extension.

Here's a snippet of configuration file php.ini:

PHP Version 5.2.8-pl2-gentoo

Configure Command './configure' '--prefix=/usr/lib/php5' '--host=i686-pc-linux-gnu' '--mandir=/usr/lib/php5/man' '--infodir=/usr/lib/php5/info' '--sysconfdir=/etc' '--cache-file=./config.cache' '--with-pcre-regex=/usr' '--disable-cli' '--with-apxs2=/usr/sbin/apxs2' '--with-config-file-path=/etc/php/apache2-php5' '--with-config-file-scan-dir=/etc/php/apache2-php5/ext-active' '--without-pear' '--disable-bcmath' '--with-bz2' '--disable-calendar' '--with-curl' '--without-curlwrappers' '--disable-dbase' '--enable-exif' '--without-fbsql' '--without-fdftk' '--disable-filter' '--enable-ftp' '--with-gettext' '--without-gmp' '--disable-ipv6' '--without-kerberos' '--enable-mbstring' '--with-mcrypt' '--without-mhash' '--without-msql' '--without-mssql' '--with-ncurses' '--with-openssl' '--with-openssl-dir=/usr' '--disable-pcntl' '--with-pgsql' '--disable-posix' '--with-pspell' '--without-recode' '--disable-shmop' '--without-snmp' '--enable-soap' '--disable-sockets' '--without-sybase' '--without-sybase-ct' '--disable-sysvmsg' '--disable-sysvsem' '--disable-sysvshm' '--with-tidy' '--disable-tokenizer' '--disable-wddx' '--with-xmlrpc' '--with-xsl' '--enable-zip' '--with-zlib' '--disable-debug' '--enable-dba' '--without-cdb' '--with-db4' '--disable-flatfile' '--without-gdbm' '--disable-inifile' '--without-qdbm' '--with-freetype-dir=/usr' '--with-t1lib=/usr' '--disable-gd-jis-conv' '--with-jpeg-dir=/usr' '--with-png-dir=/usr' '--without-xpm-dir' '--with-gd' '--with-imap' '--with-imap-ssl' '--with-mysql=/usr' '--with-mysql-sock=/var/run/mysqld/mysqld.sock' '--with-mysqli=/usr/bin/mysql_config' '--without-pdo-dblib' '--with-pdo-mysql=/usr' '--without-pdo-odbc' '--with-pdo-pgsql' '--with-pdo-sqlite=/usr' '--with-readline' '--without-libedit' '--without-mm' '--with-sqlite=/usr' '--enable-sqlite-utf8'

I understand in this case I need to recompile PHP. Yes?

Question: Сan work without recompiling the new version Gallery 3.0 Alpha 4???

Best regards, Artem K, Russia

bharat's picture

@spelesto unfortunately, no. You'll have to re-emerge PHP with the "filter" use flag in the system settings.

spelesto's picture

@bharat: And i's possible to recompile PHP with all the options already listed, but only by adding '- disable-filter'???

bharat's picture

Theoretically, yes. But gentoo has its own way of doing things (and I am not a gentoo expert) so I can't give you the exact instructions.

I get Fatal error: Call to undefined function mb_detect_encoding() in /home/xxx/gallery3/modules/tag/helpers/tag_event.php on line 37

when i add a folder of photos from the server.


spelesto's picture

So you will need to recompile PHP.
Got it. Thank you for your advice!

bharat's picture

@Burnouts: try a nightly or the latest code from svn; that issue has been fixed.

thx a lot... it works...

Hi and thanks for your great work!

I tried installing Gallery3 using the same database i use for Gallery2. The Install stopped telling me that the database i set is used by Gallery2 (in other words i can not remember exactly), which is true. I've set different prefixes for Gallery2 and 3. Is that a bug or a feature?

@meeb: Gallery2 and 3 need separate databases. If you run the mysql administrator console you can create another database called gallery3 on the same server. You will need the root password you chose when you installed mysql to do it. Otherwise, backup the gallery2 folder in the mysql installation and reinstall mysql.

I can't upload any watermarks image.
I works with gd module.
When i try to load any watermark image the load windows does nothing.
Where I can configure path to image magic , like '/usr/bin/convert'?


i have some trouble with the add from server module. (SVN from 12.05.2009). After clicking the add button i get the following error message:
Fatal Error /Runtime Message: An error was detected which prevented the loading of this page. If this problem persists, please contact the website administrator.

modules/server_add/helpers/server_add_task.php [27]:

unserialize() [function.unserialize]: Error at offset 65524 of 65535 bytes

I also habe problems with the g2 import module: after configuring the module i get the hint:
Gallery version 2.3 detected
Your Gallery 2 has the following importable data in it
* 4 users
* 3 groups
* 153 albums
* 2930 photos
* 0 movies
* 0 tagged photos/movies/albums
You can begin your import on the maintenance page

But the import does not do anything. I run it over night but in the morning it still did not anything. No Error, no timeout, just a progressbar with the progress 0.

Any idea?

bharat's picture

@yric can you check the log files in gallery3/var/logs? There should be a clue in there. Also if you get the latest code from svn, we've added an Admin > Settings > Advanced menu that allows you to change paths around.

@juergen.haigis I've made a lot of improvements in the g2 import module since alpha 4.. can you try a new nightly download (you'll have to completely reinstall g3!) or the latest code from svn?