This project is not covered by Drupal’s security advisory policy.

Concept

This module provides a backend that enables site builders to create custom slideshows without having a knowledge of how to build Drupal modules. Although the main focus of this module is the backend, it also comes packaged with a slideshow that can be used out of the box, and for some users this will suit their needs.

The Backend (the Framework)

This module provides the following features in the backend:

  • Ability to turn any content type on the site into a slideshow
  • The ability to add an unlimited number of images into each slideshow
  • The ability to add the following for each image:
    • Title
    • Description
    • Custom ALT text
    • Custom HTML title text
  • Allows for a download link to the full-sized image to be added to each slideshow
  • Above download link can be set to private, so that only users with permission to view the node in question are able to access the download link to the full-sized image
  • An import function in which images can be uploaded to a folder through FTP (or other means), and imported into a node

Customization Skill Set

In order to add a custom slideshow to this module, the site builder(s) will need to be able to:

  • Write HTML
  • Write CSS
  • A knowledge of how to work with Drupal templates
  • Enough PHP knowledge to be able to use PHP in the templates

Optionally, the site builder will also know how to write JavaScript/JQuery. This is not an absolute requirement however, as this slideshow will work out of the box without javascript set up.

Using the module out of the box

This module can be used out of the box with the slideshow it comes bundled with. To use this module, do the following:

  1. Download the module to your modules directory
  2. Download the module's dependencies to your modules directory:
  3. Enable all of the above modules
  4. Enable at least one Image API toolkit. The following two ship with Image API:
    • ImageAPI
    • GD2
  5. Navigate to Administer -> Site Configuration -> Slideshow Framework
  6. Expand the 'Content Types' fieldset
  7. Select at least one content type to act as a slideshow (note: you may want to create a new content type specifically for slideshows if you want slideshows to be independent entities on your site).
  8. Change any other settings on this page to match your needs
  9. Click 'Save Configuration'

Now when you create a new node of the type you specified on the settings page, an image upload element will be present allowing for the uploading of images to the node.

Customizing a slideshow

To customize a slideshow, do the following:

  1. Copy all the templates in the module's template directory into the site's current theme folder
  2. Re-write all the HTML as necessary in the template files
  3. Create a CSS file in the module's 'slideshow_css' folder
  4. Create a Javascript file in the module's 'slideshow_scripts' folder (If using a javascript driven slideshow
  5. Enable the module
  6. Navigate to Administer -> Site Configuration -> Slideshow Framework
  7. Under 'Slideshow Files', select the CSS and JS files you created in steps 3 and 4
  8. Click 'Save Configuration'
  9. Clear your cache

If the image sizes and/or thumbnail sizes for your slideshow are different than the sizes in the default slideshow, you can do the following:

  1. Install the Imagecache UI module (ships with the Imagecache module, and should already be present in your modules directory)
  2. Navigate to Administer -> Site Building -> Imagecache
  3. Create a new imagecache preset for either the main image size, the thumbnail, or both
  4. Navigate to Administer -> Site Configuration -> Slideshow Framework
  5. Expand the 'Image Sizes' fieldset
  6. Select the presets you created above
  7. Click 'Save Configuration'

And with that your files should all override the initial module files.

Using the module's import function

This module provides an import function that allows for the uploading of images through FTP or some other means. To use the import function, do the following:

  1. Upload your images to the sites/default/files/slideshow_framework_import folder using FTP or some other method
  2. Navigate to Administer -> Content management -> Slideshow Framework Image Import
  3. Select the images you want to import into the slideshow
  4. Select the content type of the node you want to create. Note: if you haven't enabled any content types on the site to be slideshows, you will need to do this first. Follow the provided link to the settings page.
  5. Follow the directions on the following pages.

Module Support

As this module is focused on being a slideshow framework, I will not be taking any requests to add functionality to the front end of the provided slideshow. If you need changes made to the front end, then I suggest customizing it yourself according to the directions shown on this page.

I will take any bugfix and feature requests for the backend of the slideshow.

If anyone wants to provide additional default slideshows to be packaged with the module, I will be happy to include them in future versions of the slideshow. However, I won't provide support for these slideshows.

Developer

The development of this module including all HTML/CSS/JQuery/images for the packaged slideshow has been done by Jaypan.

Project information

Releases