Home

Documentation: Diaporama

Submitted by GoZ on Wed, 23/09/2009 - 17:54
Printer-friendly versionPDF version

1. Introduction

This post is a documentation for Diaporama module of CMS Drupal.

You can find a quick presentation of the module here.

Command Lines are executed under linux in console mod. We supposed you have web user rights (for example www-data for ubuntu).

2. Module installation

2.1. Uncompress and download module

To install module, go in the module directory /sites/all/modules/.

cd sites/all/modules

If you haven't installed modules yet, you have to create modules directory.

cd sites/all
mkdir modules
cd modules

If it isn't done either, donwload the last version of module which correpsond to your drupal version on Diaporama and uncompress it. Of course, modify the version of the module by the version you want on command line.

wget http://ftp.drupal.org/files/projects/diaporama-6.x-2.0-beta1.tar.gz
tar zxvf diaporama-6.x-2.0-beta1.tar.gz

This module has two dependencies with the image module that you can find on module's drupal page. The installation instructions are the same as above..

2.2. Download of flash player dewslider

Diaporama module use a flash player : Dewslider that you can find in Alsacreations creator's site.
Dewslider is free of use but not to modify. See on Alsacréations's site for more details.

Put the player in files/diaporamas directory :

#Drupal 5
cd files/
# Drupal 6
cd sites/default/files/
 
# 2 versions
mkdir diaporamas
cd diaporamas
wget http://www.alsacreations.fr/mediaflash/dewslider5/dewslider.swf.zip
unzip dewslider.swf.zip dewslider.swf
rm -Rf  dewslider.swf.zip

2.3. Module activation

Go on the modules administration page : yoursite.com/?q=admin/build/modules
Active modules image, image_gallery and diaporama.


Screenshot of modules administration page under Drupal 6

Diaporama module is now up.

3. Module configuration

It is possible to set global variables slideshows, ie the default values when creating your slideshows. For that, go on page yoursite.com/?q=admin/settings/diaporama.


Screenshot of Diaporamas settings under Drupal 6

4. Diaporama creation

To create a slideshow you must first have added images via the image module.

4.1. Images galery creation

It is more convenient to use photo galleries to group your images into categories. This way, your images are organized and can be used in batches.

4.2. Image creation

If you don't have any images created yet, go to page votresite.com/?q=node/add/image and create one or more images (it is better to have several images for a slideshow).

4.3. Diaporama creation and settings

Now we have one or more gallery images and pictures, we can create our slideshow. Note that photo galleries are optional.

Here are the configurable options for a slideshow:

  • Width : Width of slideshow
  • Height : Height of slideshow
  • Keep ratio :

    If this box is checked, the images keep ratio, and a background of
    color specified in the setup diaporama page will be added if the images
    not exactly the same size as the slideshow.


    Screenshot slideshow with same ratio and green background.

    If this box is unchecked, the images are stretched to match the size of the slide.


    Screenshot slideshow without keeping ratio.

  • Transition : Used to determine the effect of transition. See Alsacréations's site for more details.
  • Speed transition : The speed transition is the time in milliseconds (ms) of the transition effect between two images.
  • Time display : The time display is the time in seconds to display an image.
  • Show buttons : If the box is checked, the buttons move to the previous / next image is displayed. Otherwise, they are not displayed.
  • Buttons position : This option determines the location button previous / next image in the slideshow.
  • Show titles : If the box is checked, the title image is displayed as they were before the creation of the image with the image module.
  • Position des titres : Cette option permet de déterminer l'emplacement des titres dans le diaporama.
  • Random start : If box is checked, the slideshow begins with a random picture and then continue with the same order.
  • Open image nodeIf the box is checked, then click on the image, it is displayed for viewing.
  • Enable slideshow embedded : If the box is checked, an image will display a code to put on his site to view the slideshow.
  • Link to galleries : If galleries of images are selected, the slideshow will be linked to these galleries. Each time the cron runs, it updates the slide based on adding and deleting images in the galleries. After registration, images galleries selected will automatically appear as checked in the "Select images" and can not be deselected.
  • Select images: : The images created through the image module are displayed as thumbnails and sorted by image gallery. Also displayed images belong to any gallery. Simply select the desired pictures in the slideshow.


    Screenshot of setting image selection when creating a slideshow.

5. Feature requests, errors and anomalies

You can see anomalies or post feature requests on the drupal site in the support page.