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 and iPad information. You will also use it to check will user be redirected to Jaipho at all with Pipho_DeviceInfo::isSupported() method.

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_DESTINATION 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 or with your ftp client (e.g. WinSCP)
You can test installation with browser on your desktop computer. It is much easier to detect problems than testng with iPhone.

Adding your own photos

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 source photos folder. Since Pipho 1.02 this folder does not have to be inside your webroot
PIPHO_PHOTOS_FOLDER_DESTINATION - holds a path to your destination photos folder. This folder will be used to display images by web browser (iPhone, iPad...) and it has to be somewhere in webroot
PIPHO_JAIPHO_THEME - sets the folder where is css file. By default you can set it to Themes/Default or Themes/iUI
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