File directories within Photo Room are displayed as photo albums. Photo Room displays the directory name as the name of the album. Images found in the directory are displayed as thumbnails when the album name is selected. Site visiters can view the full size image by clicking the thumbnail.
To publish a new photo album, simply create a new directory under the Photo Room directory and place your images to display in the new directory. Next time Photo Room is displayed within a browser the new directory will appear in the list of photo albums.
Some behaviors of Photo Room can be customized for each deployment. These customization are made within the appSettings section of the web.config.
| key | default | remarks |
|---|---|---|
| image_search_patterns | *.jpg *.gif | Space delimited list of image file search patterns. The list identifies the files to display as images within a photo album. |
| exclude_directories | bin|components|images| |
Pipe (|) character delimited list of directories within the Photo Room directory to
exclude. The default list excludes directories needed by Photo Room.
Note: PhotoRoom releases prior to Version 1.6 use the semicolon character as the separator. |
| thumbnail_max_dimension | 120 | Specifies the maximum dimensions (height and width) of each thumbnail image. |
| slideshow_max_dimension | 400 | Specifies the maximum dimensions (height and width) of each image displayed in the slide show. |
| prefix_delimiter | - | This is used to remove leading characters from the directory that should not be displayed as part of the album name within Photo Room. This is handy for sorting photo albums. |
| display_image_count | false | Displays the number of images in each photo album. |
| directory_sort_order | desc | Controls the sort order for the photo album names (directories). Use "asc" to sort in ascending order; "desc" to sort in descending order. |
| logo_flag | nologo |
Will display a watermark image in the upper right corner of
a rendered image. Typically used to include a copyright
message on the image. Valid values: image | slideshow | thumbnail | nologo where image will display the watermark on full images found on the tricks.aspx page. slideshow will add the watermark to slideshow images. thumbnail will add the watermark to thumbnail images. And nologo will not display any watermark. Note: You can use a combination of logo_flag settings to display the watermark on different image types. For example, setting logo_flag to "image|slideshow" will display the watermark on both the full image and the slideshow image. |
| logo_image | images/watermark.jpg | Specifies the file location of the watermark image. |
| page_size | 20 | Sets the number of images to display per page. Set to 0 to turn off paging. |
| image_columns | 0 | To display the thumbnail images in a table set image_columns to some value greater than zero. This is used to control the layout of the thumbnails, ie, the number of thumbnail images displayed across the screen. |
| display_img_alt | true | To display the image file name on the thumbnail images set display_img_alt to true. This will add the ALT attribute to the IMG tag for the thumbnail images causing the file name to be displayed in the mouse over popup. In other words when the mouse cursor is over a thumbnail image the file name will be displayed. |
Branding
Photo Room displays photo albums in a fairly plain but pleasant web page.
However there will be some who wish to brand Photo Room with the common look of
their web site. The folks at WASTEDBoarding.com
did just that.
Photo Room consist of a single web page, default.aspx. To rebrand the page with your own look simply modify the HTML found in default.aspx.
Sorting
Photo album names are sorted by name. In cases where one wishes to sort in a
different order, directory names can be prefixed with a sort token. For
example, to sort albums by date prefix each directory name with a date in
YYYYMMDD format.
In cases where you do not wish to display the sort token as part of the album name, separate the sort token prefix and the album name with a prefix delimiter character. This character must be specified as the value for the appSetting key prefix_delimiter found in the web.config. For example, 20020219-Snowboarding Trip.