Installation & Requirements
Drupal 7 will no longer be supported after January 5, 2025. Learn more and find resources for Drupal 7 sites
Installation with Drush is extremely easy, otherwise manual installation is possible although it takes more time. Views Slideshow 3 for Drupal 7 introduced the Views Slideshow Cycle module as a default implementation that will work out of the box; it also introduced more requirements.
Requirements
- Views 3.
- Ctools.
- Libraries API.
Views Slideshow Cycle also requires the following JavaScript libraries:
- jQuery Cycle plugin.
- jQuery Easing plugin.
- jQuery Pause plugin.
- jQuery Hover Intent plugin.
- JSON2 plugin.
Installation
Composer
If you are managing your Drupal site with composer, run the following from within your composer root (assumes that web/ is your webroot).
composer require drupal/views_slideshow ^3.8
cd web
drush en views_slideshow_cycle -y
Drush
If you aren't using Composer but have Drush available run the following from your Drupal installation root.
drush dl views_slideshow
drush en views_slideshow_cycle -y
Manual
The most complicated method, using Drush (and/or Composer) if possible is strongly recommended.
- Ensure that you are using Views 3.x.
- Upload/install the Libraries API module.
- Upload/install the Ctools module.
- Create a sites/all/libraries directory on your server.
- Create a directory within sites/all/libraries named jquery.cycle and save the jQuery.Cycle JavaScript file there.
- Upload/install the jQuery cycle plugin: place it inside the jquery.cycle directory.
- create a directory within sites/all/libraries named jquery.easing and save the jQuery.easing JavaScript file there.
- create a directory within sites/all/libraries named jquery.hoverIntent and save the jQuery.hoverIntent JavaScript file there.
- create a directory within sites/all/libraries named jquery.pause and save the jQuery.pause JavaScript file there.
- create a directory within sites/all/libraries named json2 and save the json2 JavaScript file there.
- Enable the Views slideshow and Views Slideshow: Cycle modules
Upgrading from 2.x
There is no supported upgrade path between Views slideshow 2.x and Views slideshow 3.x. If you need to upgrade, follow the steps listed here, and if you find deficiencies, please update this wiki. :)
- Ensure that you are using Views 3.x. (note: since 3.x is not the recommended version for D6, drush will not give you the 3.x version unless you specifically ask for it)
- Disable the views slideshow module, views slideshow thumbnail hover module, and views slideshow singleframe modules. (Disabling these modules should not require uninstalling)
- Delete/remove the Views slideshow 2.x module folder and all files within.
- Follow the installation instructions for Views Slideshow above.
- Update all your views that were previously using the slideshow style. (note: updating from views 2.x to views 3.x may also break other parts of your view not related to slideshows, check everything especially number of items per page, and pager settings.)
External Tutorials
- How to install the views slideshow module on Drupal 7
- 22 part comprehensive series by Modules Unraveled that covers instsallation, creating views and blocks, transitions, actions, controls and slide counters, text and image pagers, creating slideshows of just images or site content, displaying text over image slideshows, linking to external sites, and theming. Click here (or the image below) to watch the overview
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion