EXT: Photo Book¶

What does it do?¶

A Gallery without the need of uploading pictures one by one.The plugin creates an on the fly gallery of all subfolders and pictures.Thumbnails and lowsize pictures are created while the original is accessable through a link.Comments are plain text files or included in the images so can be made offline or through the comment part of the plugin.Simple http slideshow so no need for fancy javascripts.

Why another gallery? I needed to put in about 15000 pictures at once so I was too lazy to do so.The previous photobook was a perl script so it was converted quite easily.

Screenshots¶

• In general there are only a few screens: single, thumbnail and comment.Comment is like the single view above except the comment line is a textbox.

  

Comment plugin¶

This is the same as the show mode exept for the edit links near directories and edit field under the photo.Be sure to restrict access to pages with this plugin.

EXIF support¶

EXIF support for PHP internal (above PHP4.2) or external (metacam, jhead).The priority is: metacam, jhead and php-internal because the internal array is a bit unreadable for shuttertime and apperture values.

When you want to use this in safe mode create a www_bin directory and put it in your php.ini .In this directory create links to the tools you need.

When no commentfile is available and PHP-EXIFsupport is then the comment from the image is used.

Watermarks¶

If you are using image magick 4 or 5 stay away from this option because all your pictures will be 256 colors. For Image Magick 6 this option is quite neat. The watermark is only applied to the single view so disable the link to the original if you want to “protect” your photos.

Be sure that your Image Magick settings are correct or prepare for invert-a-mask-bingo....

Go to the Photobook section in the template-constant-editor

Enable watermark.

There are three files which are used for the watermark: Watermark mask file

This file is to blend out your original. Experiment with it or leave it white. If your whole photobook is in black and white convert this one into a complete black gif.

Watermark bottomimg file

This is your original watermark. For example place your text and logo in here.

Watermark bottomimg mask file

This is a grey scale mask to describe what part of the bottomimg will be shown. Copy the bottom file, convert it into grey scale and outline the whole thing with 2 pixels. In the EXT:goof_fotoboek/res is an example.

Slideshow¶

The slideshow option is off by default because it was a new option. Enable the slide show in the phtotbook section of the template- constants-editor. In the editor is also an option to set the time interval.

Accesskeys¶

Accesskeys have been added to the most important links. In Firefox ALT-<accesskey> is enough to use the link. In Internet Explorer only the link is selected by ALT-<accesskey> and another RETURN is needed.

Next +Previous -Slideshow *Home hOne level up uThumbnails t

Configuration¶

Templatefile

Sections

SINGLE = template for single picture

THUMBTPL = template for the thumbnails

DIRTITLE = Name of current directory or the comment for it.

PREV = previous button

NEXT = next button

INDEX = button to go to the root of the photobook

UP = go one level up

THUMB = thumbnails button

DIRS = list of subdirectories or their comment

IMAGE = the photo itself

TITLE = first row of the photo comment file

COMMENT = rest of the comment file

THUMBNAILS = Thumbnail images

NAVSTART = Start image of navigation bar

NAVEND = End image of navigation bar

FASTNAV = Fast navigation bar

PATH_TO_ORIGINAL = relative path to the original image

PATH_TO_SINGLE = relative path to the resized image

THUMBNAIL_IMAGE =

THUMBNAIL_COMMMENT_HEADER=

THUMBNAIL_FILESIZE=

ORIENTATION=

THUMBID=

PAGES = paged navigation

COUNT_NR = Current image number

COUNT_COUNT = total count of images in current directory

COUNT_STRING = “image # of # images”

Simulate static¶

Both simulate static and realUrl are documented in other places.I only documented these parts to save myself a lot of emails .

Below is a part of a template setup to get rid of the parameters in the url.

config.simulateStaticDocuments = 1config.simulateStaticDocuments_pEnc = md5config.simulateStaticDocuments_noTypeIfNoTitle = 1config.simulateStaticDocuments_aliasPro = 1config.simulateStaticDocuments_addTitle = 40config.simulateStaticDocuments_pEnc_onlyP (no_cache,L,cHash, back PID,tx_gooffotoboek_pi1[func],tx_gooffotoboek_pi1[fid],tx_gooffot oboek_pi1[srcdir],tx_gooffotoboek_pi1[slide],)

RealUrl¶

I just cut and paste around when using realurl. So please let me know if this is wrong.

In typo3conf/localconf.php:

$TYPO3_CONF_VARS['EXTCONF']['realurl'] = array('_DEFAULT' => array('init' => array('enableCHashCache' => true),'pagePath' => array('type' => 'user','userFunc' =>'EXT:realurl/class.tx_realurl_ad vanced.php:&tx_realurl_advanced->main','spaceCharacter' => '-','expireDays' => 3),'postVarSets' => array('_DEFAULT' => array('album' => array(array('GETvar' => 'tx_gooffotoboek_pi1[srcdir]',),),'pic' => array(array('GETvar' => 'tx_gooffotoboek_pi1[fid]'),),'func' => array(array('GETvar' => 'tx_gooffotoboek_pi1[func]','valueMap' => array('thumbnails' => 'thumb',),),),'fileName' => array ('defaultToHTMLsuffixOnPrev' => true),),);

In your template-setup put:

config.simulateStaticDocuments = 0config.baseURL = 1config.tx_realurl_enable = 1

Accesslist¶

By default everybody who has rights to see the plugin can see all directories and photos in it. To create access lists per directory you can create .access files. An .access file contains the group ids which shall have access to the photos. Each group has to be on one line in the .access file.

Example:

#.access file for personal images2 #this is the family group5 #my friends# 6 is the testersgroup6

Note: Never use this option for real security. As all files in typo3's fileadmin they can be deeplinked.

Using sr_sendcard¶

With a small workaround you can create a “send as e-card” option.

Install sr_sendcard. Create a page with sendcard as a plugin. Note the URL for accessing the sendcard page.Now edit the fotoboek.tpl and add a link in the singleview part:

<a
href="/index.php?id=25&tx_srsendcard_pi1[cmd]=prompt&tx_srsendcard_pi1[card_caption]=foto:berlinVR.de&tx_srsendcard_pi1[cardaltText]=foto:berlinVR.de&tx_srsendcard_pi1[card_image]=&tx_srsendcard_pi1[card_image_path]=###PATH_TO_SINGLE###&tx_srsendcard_pi1[image_width]=[image_width]&tx_srsendcard_pi1[image_height]=[image_height]&tx_srsendcard_pi1[selection_image]=&tx_srsendcard_pi1[selection_imagealtText]=foto:berlinVR.de">Bild
als kostenlose E-Card an Freunde verschicken</a>

You probably need to remove all width and height tags in the sendcard template.

A real implementation of sr_sendcard is on the wishlist.

FAQ¶

Q: I see navigation but no pictures are rendered.A: In most cases there is something wrong with image magick. Be sure that image magick works in the install tool.

Hints: In the installtool go to “basic configuration”, look if there is an image magick entry and press save. Also check the typo3temp directory for ownership and rights.

Q: I see no navigation and or pictures are missing.A: Check file permissions. Try to access the image by a direct URL like http://mysite/fileadmin/fotobook/subdir/mycat.jpg .

Q: Why is it that only directories under uploads or fileadmin work?A: If you want to use archives outside the fileadmin-structure as I did you will have to add the path you use (a relative path to the site- root-dir) to the addAllowedPath list. You can find it in your install- tool under [FE][addAllowedPaths]. (Thnx prinsarian)

Q: the comment mode seems to forget my comments.A: check file permissions on the photobook directories. The webserver needs write access to it.

Reference¶

plugin.tx_gooffotoboek_pi1.

How to make multi directory photobook¶

Create a directory under fileadmin, say photobook.Create a few directories like birthday, hollyday, christmas and mypet.Upload images in these directories.Create a page in your typo3 site where you want the pictures to show up.Insert the plugin on that page (show mode)(for details on inserting the plugin on a page, see the user section)Look at it! 8-)

Adding comments¶

The mypet directory name is stupid, I want 'My beloved pet', create a textfile mypet.txt in the directory where the directory is and put 'My beloved pet' in it. If you have any comment on your pet directory then start that on the second line.

For photos you have some more options. You can create a textfile for your photo like we did for the mypet directory. If my photo was called fluffy.jpg its commentfile would be fluffy.txt. When using EXIF you can put the comment direct in the jpg with exif tools or even with XP file properties.

Another option is to add a page, protected with a login ofcourse, which contains the plugin in comment mode.