2. Adding the module
3. Configuration options
3.1 Content options
3.2 Advanced options
4. The module in practice: tips
4.1 Resize images before uploading
4.2 Create picture folder before adding Snapshot page
4.3 Slideshow tricks
4.4 Using the thumbnails
4.5 Box sizes of themes
4.6 Linking to the Snapshots module
4.7 Slideshow not working
4.8 Cannot upload files!
4.9 Automatic full screen browser
4.10 Interactive slideshow
In the chosen theme, a page is visible with 6 clickable buttons that enable navigating through the pictures. From left to right buttons navigate to: first picture in the list, previous picture, thumbnails overview, next picture, last picture in the list and slideshow. Mouseovers show button texts.
Below the navigation is an optional title given to group of pictures and below an optional long description.
Below these are the selectable thumbnails, landscape or portrait, framed in a rectangular one pixel wide frame that also contains the picture name. Around the thumbnail is a 5 pixel wide colored border. When hovering over a thumbnail the border color changes and a mouseover text shows picture information, for example:
allium.jpg (512x384, 63
In the chosen theme, a page is visible with 6 cliclable buttons that enable navigating through the pictures. From left to right buttons navigate to: first picture in the list, previous picture, thumbnails overview, next picture, last picture in the list and slideshow. Mouseovers show button texts. Next to the navigation buttons, the number of the displayed picture, the total number and the picture name are displayed. For example
1/12 - allium.jpg.
Below the navigation bar and picture info, the picture is shown either in landscape or portait format. Hovering over the picture shows picture information, for example:
allium.jpg (512x384, 63 kB). Clicking in the
picture shows the next picture.
The picture shows the borders of a monitor and a full screen picture. Every n seconds (configurable per picture) the picture changes in a continuous loop. To end the slideshow and return to the previous variant, press [Alt+F4] (Firefox).
When using the slideshow option in a Protected Area,
XXX TO BE DISCUSSED
In the Page Manager, select the Area or section and click on the Add a page link to enter the Add a page dialogue:
Fill out the fields as described in Page Manager, paragraph 3.1 Add a page.
In the Moudle dropdown menu, select the module. Do not forget to select Visible, Hidden or Embargo. Click [Save] to save your work and return to the Page Manager.
Now click on the Page Name to enter the Module Name (modlename) configuration dialogue. In the next paragraph the module will be configured.
Here you can configure the snapshots module. You can add an optional header and an optional introduction to the snapshots. You can also change the initial display of the snapshots. Use one of the following options:
- An invalid path produces an error message.
- When adding pictures in a private area, it is impossible to use these pictures in other private areas. This is a security feature.
- A location path leading to a public area differing from the one where the Snapshot page is located, leads to a warning message. This is a security feature.
- When the location path is in a personal location, i.e. My Files, Groups or Users, a warnng is given. Same feature.
- The user must have sufficient access permissions.
Most times it will be necessary to rename a picture to have it diplayed as the opening picture on a page.
The high-resolution pictures modern digital cameras produce are huge in size. Three to 10 mB and more are no exceptions. Generally, it's a bad idea to use these original images. It takes a long time to upload them to the schoolserver if at all possible. Most times the server settings will prohibit it. Furthermore, the process takes a lot of bandwidth and downloing them enlarges the monthly costs of data traffic.
Please do not upload the pictures directly from the cmaera to the server, but resize them first to a reasonable size, for example 800x600 or 1024x768 pixels.
There are numerous programs to batch resize and rotate images. In Ubuntu/Linux use, for example, the file manager 'Nautilus' with a plugin. In Windows Irfanview with its plugins is a perfect freewar solution. https://www.ixquick.com is your friend.
Do not use pictures with the
extension. This format creates huge file sizes. For example, a
.bmp picture of 1.900.000 bytes can be reduced to
106.000 bytes by converting the image to
format, or even reduced to 22.000 bytes in
format. Format converting can also be done in Irfanview.
Suppose you need a picture of 180x150 pixels (180x150=27.000 pixels). The actual size of the picture you want to use is 600x400 pixels (600x400=480.000 pixels).
In the F/CKEditor, there is an option to set the desired image width and height.
Using this option is not a good idea, since it only reduces the visible size of the picture, not its size in pixels. The 600x400 picture takes almoust 18 (!) times longer to download. The result can be a boring slow site.
When, after creating a direcory, you create the page for the Snapshots module, you find the created directory as default for the pictures. To do this, proceed as follows:
The best idea is to keep pictures in the right Area and not in My Files, Groups or Users. If done, you get a warning message.
010_005_picturename.jpg (first picture for 5 seconds)
020_012_Other_name.png (second picture for 12 seconds)
030_004_Anothername.gif (third picture for 4 seconds)
zz_thumb_. As example, the picture
allium.jpghas a thumbnail with the filename
Links in pages
<a href="/index.php/35">Field trip to the botanical garden</a>when using proxy friednly URLs.
<a href="/index.php?node=35">Field trip to the botanical garden</a>
These links bring you to the variant, selected in the configuration of the Snapshots module, i.e. Thumbnails, First or Snapshots.
<a href="/index.php/35/variant/1/Field_trip_to_the_botanical_garden">Field trip to the botanical garden</a>when using proxy friednly URLs.
If no proxy friendly URLs, use:
By using this URL you force to display one of these
1 = thumbnails
2 = first
3 = slideshow
<a href="/index.php/35/snapshot/5/lavendula_jpg.html"> Picture of lavender</a>, when using proxy friendly URLs.
If no proxy friendly URLs, use:
Non proxy-friendly URL:
- Download time too long. Check the window title bar and look
- Connection too slow
- Pop-up windows disabled in browser.
File size is limited to 8388608 bytes, total upload size is limited to 67108864 bytes.
These limits are set in the server in
/etc/http/php.ini. When changing these values,
notice that you are on your own.
#!/bin/bash $ fullscreen.sh 17/01/2015 DS # Script to start firefox, and # wait 20 sec. so FF can check something, # let xdotool do its job on F11. firefox http://exemplum.eu/ & sleep 20 xdotool key F11 #eof fullscreen.sh
"firefox.exe" -url http://example.com -fullscreen
As a rule the slideshow function displays the selected pictures in alphabetical order, using either a fixed interval of 5 seconds per picture or a configurable interval per picture. The latter is based on a specially crafted filename, see section 4.3 Slideshow tricks above.
The slideshow function also responds to the following five different keystrokes.
[Spacebar]: refreshes the list of images
[Cursor left]: show the first image in the series
[Cursor up]: show the next image in the series
[Cursor down]: show the previous image in the series
[Cursor right]: stop the slideshow and return to the thumbnail view