The four options:

1. Multiple mid-sized snapshots per row. This is the default. shrunken snapshot version of images will be displayed in a grid.
2. Multiple shrunken mid-sized snapshots per row. Similar to 1 -- but the grid cells are less wide. This can eliminate the white-space that often appears when shrinking a snapshot. Which means more images can be fit on a row.
3. Two larger images per row (snapshots). Typically two images per row, that are about 400px high. If you display an image (by clicking on it, and then clicking ⇗) a snapshot (640x480) image is displayed in a new window (or tab).
4. Two larger images per row (full images). Typically two images per row, that are about 400px high. If you display an image (by clicking on it, and then clicking ⇗) the full resolution image is displayed in a new window (or tab).

• contain a CSV list of numbers designating which images to display.
• Each number should refer to a imageFileName (or a thumbnail) in the list of files menu.
• 1 refers to the first image!
• Or ... you can specify a range by using a dash between two numbers: such as 5 - 10.

Shortcuts::

• Show all! : display all the files. This is equivalent to specifying 1- in the input box.
• Show all images! : display all the image files (do not display non-image files)

Examples ( note that spaces are ignored):

• Display all images: 1 -
• Dispay images 3, 6, and 10: 3,6, 10
• Display images 4 to 8, image 11, and images 20 to 26: 4 - 8, 11, 20-26

Several buttons at the top of the wsGallery browser window provide information on scroll locations of the currently displayed image.

The buttons (in the top row of the wsGallery files container) control how files are displayed. This includes: specifying what size of file to retrieve from the server, where to display a file, whether or not to shrink it when displaying, and using thumbnails to display file selection buttons.

• 2 line dir description, 2 line file description (displayed when a file is chosen). This is the default
• no dir description, 2 line file description (updated when a file is chosen)
• 2 line dir description, 2 line file description updated when a file is chosen)
• multi-line dir description, multi-line file description (updated when a file is chosen)
• 2 line dir description, no file description

The following lists files supported as of the most recent version of wsGallery (Jan 2022), and the limitations to this support. A mildly ambitious administrator can add support for a number of other files

• Rows of buttons (this is the default). The list of files is displayed as rows of buttons (or thumbnails), with each row containing several buttons (or thumbnails).
  This is compact, but sparse on information.
• list format. The list format display the file's creation date, and the pixel width and height And the first several characters of a description.. Up to 3 different files are displayed per line.
• table format: The table format uses a table with one file per row. This takes the most space, but displays the most information... including the mimetype, file date, pixel width x height, total file size, and description. And, you can sort the table on any of these columns.

• ⬜asIs: The full image is displayed. If (the typical case) the image is larger than the viewer, you scroll to see hidden portions of the image. Scrolling can be done with the scrollbars, or by clicking and moving the mouse within the view box.
• ▩ stretch: the image is stretched to fill the view box. This means that proportions are not maintained-- the stretching may be more in the vertical than the horizontal (or vice versa)
• 🗜 shrink: the image is proportionally shrunk to fit inside the view box. This means that the view box may not be filled -- there may be white space either on the right or the bottom of viewer.

You can toggle through 4 choices.

• ⧉ Dual viewer / 🖵 2️⃣ / 🗜 shrink and when the slide show starts, click the ▣ to expand viewer 2 to fill the window.
  When ready to stop, click the ▣ (and then uncheck the slideshow box).
• ⧉ Dual viewer / 🗔 to view in external viewer. Depending on your screen resolution, you can set the ⿳ custom width and height
• ◨ single viewer. Once the slide show starts, click the ⤊ to display using the entire window. To stop the slide show, hit esc.

• 🄵: Fit -- reSize to fit within viewer2
• ẓ: zoomIn -- zoom in toward the scroll viewer2 location
• 🇿 zoomOut -- zoom out from the scroll viewer2 location
• ✜ reCenter -- set the current upper left corner to be the scroll viewer2 location
• ⟲ redisplay -- current image at full resolution

• ☑️ or 🇽 Current status of tree. ☑️ means enabled -- directories and files can be viewed. 🇽 means disabled -- the tree information is stored, but its directories and files are not viewable. Clicking on this will change the status (without changing any of the tree's stored information)
• !create !update or !refresh : create, or update, a directory list for this tree
  !create : no directory list exists for this tree. It won't be accessible until you create one!
  !update: a directory list exists, but it is out of date (a directory has been added, or removed). update is used to view added directories (and get rid of removed ones)
  refresh: the directory list is probably up to date, but refreshing it can clean up some descriptions (and catch changes deeper in the directory tree)
  Note that when updating or refreshing a tree's directory list, you can either retain or remove existing directory descriptions. All file descriptions will be retained
  ... see change file descriptions for more on working with file descriptions!

  If you update or revise a tree, there are several options.

  Retain prior disabled directory settings. If not checked, the disabled status information is removed -- so all directories will be visible. Retain prior directory descriptions: Check this to retain any changes to directory descriptions. If not checked, the default (based on readme.txt files in the directories) are used. (made in the the admin can retain this status by checking this checkbox. If not checked, the disabled status information is removed -- so all directories will be visible. Remove unused cache directories: If a directory has been removed from a tree, the cache entries for it will still exist. Since these are useless, one can save disk space by removing them. Checking this will do this removal. If unchecked, they will left as is. Note: disabling directories, and changing descriptions, is done using tree specific 👁✎dirs

• displays a list of all directories in this tree. For any of these directories you can:
  

dirname a description

After directory creation (or preview), you can click ⇗ to display the status report in a new window

• dirName show & view the files in a directory. The same menu a non-admin would see to show & view a directory's files!
• ✎🔑♪ n View & modify descriptions of files, and file notes and keywords. n is the number of viewable files in this directory.
• 👁 Disable, partiallyDisable, or enable a directory. After modifying one (or several), click update dirStatus
• ✅ : Initialize a directory (create fileLists, thumbnails, snaphots, ...)
• dir desc : Modify the directory description. After modifying one (or several) descriptions, click update dir descriptions

Notes:

• Directory descriptions should be short.
• All HTML will be stripped from directory descriptions.
• When you have changed a description, the border is highlighted.
• when a directoryList is created (or updated, or refreshed): the descriptions for each directory is generated using the contents of a readme.txt file (in the directory). If there is no such file, a simple description is created.

You can initialize one directory at a time, or several directories at once.

Although you can specify entries by hand, we recommend using the tool (in the viewer1 container in the NE corner).

1. Select one of the currently specified galleries (click on it)
2. A list of the trees in this gallery will be displayed. Select one of them.
3. In the viewer 2 container, a list of the directories in this gallery will be displayed. Select one of them
4. In the viewer 3 container. Specify a name and description, and then save it.
5. A row will be written to the entries box (in the admin container)

• One entry per row.
• Each entry must have format of: entryName:gallery,tree,dir,description
  The entryName must be single word (less than 30 characters)
  The description should be less than 100 characters, and must not contain HTML.
• Empty rows, and rows that begin with a ;, are ignored

• 👁 : enabled. The client can open this directory, view its files, and display them.
• 🚫 : disabled. The directory is not be displayed on the list of directories (and it will not be openable)
• ⦻ : partiallyDisabled. The directory name is displayed on the list of directories, but will not be openable (clicking the button will not show a list of files in this directory)is disabled)

1. Click on a button to request a change in adirectory's status.
   When a status change is requested, the button will have a green border.
   When no change is requested the border is gray.
2. Click the Update dirStatus. If no changes were requested, nothing will happen.
3. If one or more changes were requested, a confirmation box ask you if you are sure.
4. Click on ok (or whatever your browser shows), and the changes will be made

• onTheFlyThumbnails : 0 (disable), or 1 (enable). Controls whether or not to create thumbnails on the fly.
  If the administrator does not create thumbnails for the files in a directory (using intialize a directory), wsGallery can create them as they are requested.
  If disabled (0) this will not occur, and a generic thumbnail will be used.
• onTheFlySnapshots : 0 (disable), or 1 (enable). Controls whether or not to create snapShots (640x480) on the fly.
  If the administrator does not create snapShots for the files in a directory (using intialize a directory), wsGallery can create them as they are requested.
  If disabled (0) this will not occur. The full image will be used.
• noCache . 0 to allow use of caching. 1 to suppress.
  Caching of files is used to improve throughput. But it does require disk space. If caching is suppressed, wsGallery will not attempt to read or write information to its cache. And this will occur even if information is in this cache -- say, due to prior use of intialize a directory.
  If caching is disabled:
  Thumbnails, and snapshots, are created each time they are requested.
  The list of files in a directory, and the buttons (text or thumbnails) used to create them are created each time a file list is displayed.
  Descriptions will not be available.
  These can substantially slow down throughput, especially if directories have several hundred files in them (since the fileList has to be generated each time).

  Note that if caching is suppressed, it is probably best to suppress onTheFly creation of thumbnails. A generic icon is quick to display, while thumbnail creation (each and every time) can be tedious.

• skips : A list of subdirectory names to skip. wsGallery recursively searches the directories in a tree. Some, or perhaps many, of these really should not be examined! Such as temp subdirectories. The skips parameter is used to specify which of these to skip.
  This is somewhat generic -- each item in the list should be just one word! For example:
  If skips=temp,tmp,old
  wsGallery is looking at /www/family/photos/ which contains: /www/family/photos/trip1/, and /www/family/photos/trip2/, and /www/family/photos/tmp/,
  The first two subdirectories (trip1 and trip2) will be examined
  The temp subdirectory will not be examined. Any subdirectory under temp will not be seen.
  Similarly, if /www/family/photos/trip2/ contains /www/family/photos/trip2/day1/ and /www/family/photos/trip2/tmp/.
  day1 will be examined, but tmp will not
• imgExts. The list of files (extensions) that wsGallery will treat as images.
  By default, png, gif , jpg , jpeg , bmp, xbm].
  These MUST be supported by php! You might want to remove bmp and xbm, since they aren't used much.
• otherExts. The list of files that wsGallery will display (or try to display), with minimal options (such as no zooming or mouse assisted scrolling).
  By default: mov, mpg, mpeg, mp4, avi , pdf , txt , text , htm, html, xls , xlsx, ppt, pptx, doc, docx]
  otherExts also specifies what methods wsGallery should use to display these files. The supported methods are:
  Using a <video>
  Using a <img>
  Using an <embed>
  Using an <image>
  Using external display
  It isn't that hard to add files (such as .TIF or .JS ) files. That said: you should experiment with different handlers (and their modifiers) to see the results. Note that some handlers rely on external web resources (such as a Microsoft converter), and some require that the client's browser have addons (such as FireFox addon for tiff files).

• locally saved : These are favorites list that you previously created and saved . Thus: you have to remember where you saved such files!
• public: These are favorites list that you, or any other user of this site, created. They are stored on this server, and will be listed in a menu.

• Save locally : save the favorite-list on your hard drive. Due to security concerns, this is a multi-step process that requires you to open a text editor and paste content into it. And then save to a file. The steps are clearly specified, so its not that hard.
  And in the future when you use this favorites-list, you have to remember where you saved it!
• Save publically : save on the server. This will be viewable (and useable) by everyone who uses this site! And you don't have to remember its name. When its time to you will be shown clickable list.

• Read: Read a favorite-list ... and display its files in the file selection area. This can be read from your local hard drive, or from the server
• Create Create a favorite-list -- and save either to your local hard drive or to the server. You will be asked to enter a 1-word name, and a short description.
  If you will have to do some cutting and pasting.
• View View the current list of favorites. You can delete unwanted entries
• &cUscr;urrentFile Go to the add an entry menu, and display information on the more recently selected file. You can then use 𝒜dd to add this file to the favorites-list.

1. Click the 💙 (at the top of the window). A favorites box will open at the top of the screen.
2. Select a file you want to add to the favorites
3. Click 𝒞urrentFile (or ↺) -- information on the most recently viewed file is displayed.
4. Modify the description (or use the default)
5. Click 𝒜dd
6. A message will display how many entries are in the favorites-list

• A short cut!: After step 2, click on the a key -- the currently seleced file will be automatically added to the favorites-list
• If you try to add the same file twice in a row, a warning messages asks if you are sure. This message does not appear if you add other files in between!
• You can use View (in ) to review (and remove) entries in the favorites-list.

When you save a list of favorites, you will be asked for a name and a comment. The name should be short, one-word, name. It is used to identify the favorite list. The description can be a longer string, but should not contain HTML.

• Notes:
• The saved (local or public) favorites-list is not changed
• The list of files displayed does not change

• Name: Your name. This is optional
• Note: The note. It can have simple HTML (such as <b>), but nothing active (no onClick).
• Keywords: A list of keywords (comma seperated). Maybe used in searches!

• ⌫. Clear the note -- clear the Note and Keywords fields. A cleared note will be dropped when you click Save
• Note. Edit the note. Reminder: only simple html is allowed
• Keywords. Edit the keywords. Enter as a comma seperated list. No html allowed! Case is ignored.
• A new note row allows you (the administrator) to add a note, and keywords.

L
• Enter a keyword in the
• Click 👁
• If any matches are found, they will be highlighted. And the number of matches is shown in the search box!