ImgDir FAQ

ImgDir FAQ

1. What's the latest version of imgDir that's available?
2. How can i see what changes were made in the various versions?
3. What's the easiest way to stay up-to-date with imgDir?
4. Can I customize imgDir at all?
5. What do all the options in ".imgdir/dflt.txt" mean?

1. What's the latest version of imgDir that's available?

The post setup demo on the website always uses the latest released version, so just go there to get the latest version number.
(top)

2. How can i see what changes were made in the various versions?

If you look at the source code for imgdir (view in browser or a text editor such as notepad), you'll see the revision history summarized at the top of the file.
(top)

3. What's the easiest way to stay up-to-date with imgDir?

If you are running imgDir on a linux box and you have the ablity to run scripts from there, you can download getimgdir from this website and use it to get the latest version. Basically, getimgdir gets the latest version from the website and installs it in a specified directory on the local machine. It's a perl script so it may also work on a windows box that has perl installed, but it's never been tested in such an environment.

NOTE to BerZerker users: If you have an account on BerZerker, to install or update imgdir, just login to your BerZerker shell and type "getimgdir [pathname]" where pathname is the path to an existing directory where you want ImgDir installed or updated. You can also "cd" to the directory and type "getimgdir ." (since "." in linux represents the current directory). If it's an existing imgdir installation, you may need to use -f to force an overwrite.

You can always just download the latest version and overwrite your copy of imgdir.php with the newest. Our intent is to ALWAYS make them backward compatible. Just keep around your old imgdir.php in case you don't like the latest changes (although typically they are new features or bug fixes which won't change your website).
(top)

4. Can I customize imgDir at all?

Yes, but since the main goal of imgDir was simplicity, the customizations are "under the hood" and aren't obvious. The only way to modify an imgDir installation currently is to edit the ".imgdir/dflt.txt" file that is automatically created when imgdir is first invoked. See the next question for more details.
(top)

5. What do all the options in ".imgdir/dflt.txt" mean?

Here's an explanation. Some of the options should not be changed and these are so noted. Be careful when changing this file, lest you break the program.

dflt_version Specifies imgdir version associated with this file.Do not change.
method Specifies display style. For future use. Do not change.
tsize Thumbnail size in pixels. Click 'Rebuild Thumbnails' to see changes.
per_row Number of thumbnails shown per row.
sortby Default sort basis. Allowed values are fname, mdate and fsize.
order Default sort order. Allowed values are ascending and descending.
new_window Open images in new window? This feature may be buggy.
show_dir Do you want to display sub folders by default? If not, a link will be shown allowing them to be displayed.
description_file Text file which, if exists, contains descriptive text for picture website.
image_cycle
per_page Max number of thumbnails displayed on a single page.
collapse_folders If set to 1, display of subfolders will collapse to a link if number of subfolders exceeds the collapse_row_count
collapse_row_count If collapse_folders is set, Max rows of sub folders to display before collapsing to a link.
images Comma separated list of image suffixes which will be displayed as thumbnails.
images_to_convert Comma separated list of image suffixes which will be converted to .jpg before being displayed.
videos Comman separated list of file suffixes which are shown as a generic movie icon.
link_target URL which is associated with a link that's shown at top of page.
link_label Title of link that's shown at top of page.
title Title of this picture website.
sort_link_pic_count Suppress display of sort options if number of thumbnails is less than this value.
convert_path Pathname to image conversion utilty for building thumbnails. Change only if this differs on your web host
imgsize Maximum size image to display. Can always get the full sized image by doing another click through. It is recommended that you set this to some reasonable value if you store large images.
compact Display page in 'compact' format? i.e. no filename, no sort links and tighter spaced thumbnails.
immediate_movie_access Display movie immediately when you click on icon?
passwd For future use. Do not change.
debug Turn on debug output? Normally not needed by anyone but me!
textfiles File suffixes which will be displayed with a generic textfile icon.
exclude Comma separated list of filenames to exclude from display
folder_icon URL to an image which will override the default generic folder icon.
textfile_icon URL to an image which will override the default generic textfile icon.
movie_icon URL to an image which will override the default generic movie icon.
seperator Seperator which is displayed when building sub-folder-base page names.

(top)

dflt_version	Specifies imgdir version associated with this file.Do not change.
method	Specifies display style. For future use. Do not change.
tsize	Thumbnail size in pixels. Click 'Rebuild Thumbnails' to see changes.
per_row	Number of thumbnails shown per row.
sortby	Default sort basis. Allowed values are fname, mdate and fsize.
order	Default sort order. Allowed values are ascending and descending.
new_window	Open images in new window? This feature may be buggy.
show_dir	Do you want to display sub folders by default? If not, a link will be shown allowing them to be displayed.
description_file	Text file which, if exists, contains descriptive text for picture website.
image_cycle
per_page	Max number of thumbnails displayed on a single page.
collapse_folders	If set to 1, display of subfolders will collapse to a link if number of subfolders exceeds the collapse_row_count
collapse_row_count	If collapse_folders is set, Max rows of sub folders to display before collapsing to a link.
images	Comma separated list of image suffixes which will be displayed as thumbnails.
images_to_convert	Comma separated list of image suffixes which will be converted to .jpg before being displayed.
videos	Comman separated list of file suffixes which are shown as a generic movie icon.
link_target	URL which is associated with a link that's shown at top of page.
link_label	Title of link that's shown at top of page.
title	Title of this picture website.
sort_link_pic_count	Suppress display of sort options if number of thumbnails is less than this value.
convert_path	Pathname to image conversion utilty for building thumbnails. Change only if this differs on your web host
imgsize	Maximum size image to display. Can always get the full sized image by doing another click through. It is recommended that you set this to some reasonable value if you store large images.
compact	Display page in 'compact' format? i.e. no filename, no sort links and tighter spaced thumbnails.
immediate_movie_access	Display movie immediately when you click on icon?
passwd	For future use. Do not change.
debug	Turn on debug output? Normally not needed by anyone but me!
textfiles	File suffixes which will be displayed with a generic textfile icon.
exclude	Comma separated list of filenames to exclude from display
folder_icon	URL to an image which will override the default generic folder icon.
textfile_icon	URL to an image which will override the default generic textfile icon.
movie_icon	URL to an image which will override the default generic movie icon.
seperator	Seperator which is displayed when building sub-folder-base page names.