Pipho - PHP image gallery for iPhone

Or, what happens when Jaipho meets PHP.
Although Jaipho is meant to be used as secondary image gallery script, some of my colleagues convinced me that there should be server side solution too. They just wanted to upload photos on server and let the script do everything else.
Pipho is exactly that. It reads photos from desired folder, on the fly creates resized thumbnail and slide images, and dumps Jaipho javascript read images part. In addition, it supports text files as descriptions for both, gallery and slides.

In short, Pipho is a PHP Jaipho implementation example.

If you are making iPhone optimized site, and you already do not have gallery engine on your site, this is perfect solution for you.

Package description

It is PHP5 package written in Zend Framework coding standard, but at this moment it does not requires any class from it. PHP classes are stored in library folder. Two classes are representing the main logic.

Pipho_DeviceInfo holds information about optimal images size for device which accesses the gallery. Right now it holds only iPhone information, but in a close future, Jaipho is planned to support other smartphones too (basic Android tests are already done and it looks find). You will also use it to check will user be redirected to Jaipho at all.

Pipho_FileManager is a class which have methods for loading photos from your desired folder. It will automatically create best fit thumbnails and slide images from your original photo. Results are returned as Pipho_Image and Pipho_Gallery objects. Pipho_Image class has method getJsReadImage() which will return image data formated as Jaipho Javascript dao.ReadImage() method.

Installation

Unpack download package and upload it to your webserver. Package also contains Jaipho javascript source, what means that it can be used without any additional download.
Ensure that the photos folder (PIPHO_PHOTOS_FOLDER constant) and all it's sub folders are writable. If this is not a case, Pipho will throw an exception. You can do it by running Linux command "chmod -R 777 photos/" from your webroot.
You can test it with browser on your desktop computer.

Adding your own photos

Please note that although Pipho_FileManager class has methods for listing all galleries, in the current Pipho version, there is nowhere you can actually see the list. Only way to switch galleries is to add an url argument e.g. ?gallery_id=mygallery
Example which has implemented gallery listings can be found in integration with iUI article at http://www.jaipho.com/content/using-jaipho-iui

1. Upload your photos inside the photos folder PIPHO_PHOTOS_FOLDER. Your photos have to be organized in folders: e.g. photos/mygallery/, photos/vacation/, photos/newimages/... Gallery folder name is used as gallery_id value. Photos folder should be inside your webroot folder. In other words, the photos should be accessible with your web browser. E.g. www.mysite.com/photos/mygallery/image.jpg
2. Add description file in each folder. It should be always named _gallery.txt. First line is a title, and all other lines are considered as gallery description. Gallery description is not used at the moment. This is optional step. If you skip it, gallery name will be set as it folder name.
3. You can add titles and description for your images. Just add txt filename with the same name as image has (for myimage.jpg, add myimage.txt). First line is image title, and all other is description (same as gallery description file).

Watching galleries for the first time

In the moment when you try to see gallery with your browser, Pipho will check do the thumbnails and slides exists, and if they don't it will resize them on the fly.
It can be time consuming operation and there are two errors that PHP might throw.
- Fatal error: Maximum execution time of 30 seconds exceeded. You can increase execution time with PHP function set_time_limit ( int $seconds ).
- Fatal error: Allowed memory size of 33554432 bytes exhausted. This might happened if your photos are few MByets large. You can increase allowed memory for script with ini_set("memory_limit","64M")

Both of this functions should be added at the beginning of script where Pipho is implemented (index.php in downloaded package). It's recommended that you try all your galleries by yourself first, and after all thumbs and slides are created, you can remove those two functions.

Configuration

At the beginning of index.php is set of constants which you can change to accomplish your particular needs.

PIPHO_PHOTOS_FOLDER - holds a path to your photos folder
PIPHO_FORCE_WRITE - if set to true, the image resizing will be called on every page load, no matter if the resized images already exists. Use it only for debugging.
PIPHO_SLIDE_RESIZE_ENABLED - if you already have optimal resized images for usage on iPhone, you can turn off resizing engine by setting this const to false. Otherwise, if enabled, your images can be downgraded in quality.

PIPHO_SORT_IMAGES_ENABLED - turn on or off sort order in which the images will be shown.
PIPHO_SORT_IMAGES_SORT_TYPE - as there are different types of sorting here you can set which particular type you need. For possible values you can check at http://www.php.net/manual/en/array.constants.php
PIPHO_SORT_IMAGES_REVERSE - set it to true if for any reason you need the reverse order

PIPHO_SORT_GALLERIES_ENABLED - same as the IMAGES version, with only difference that it affects the order in galleries list.
PIPHO_SORT_GALLERIES_SORT_TYPE - same as the IMAGES version
PIPHO_SORT_GALLERIES_REVERSE - same as the IMAGES version

Please note few more things
- PHP GD library has to be installed on your server. If it is not, you'll PHP will throw error "Call to undefined function imagecreatefromjpeg()"
- Pipho requires PHP 5. Otherwise, php will throw error with text "syntax error, unexpected '{'"

Permalink