View on GitHub

Drupal Bamboo Slideshow

A Features based responsive slideshow for the Drupal Bamboo Theme

Download this project as a .zip file Download this project as a tar.gz file

Drupal Bamboo Slideshow Documentation

Bamboo Slideshow is a Feature (module) for Drupal 7. It uses Views, Views Slideshow and Flexslider so it's responsive out of the box. You can see a demo of it here. Bamboo Slideshow is a companion module for the Bamboo theme on drupal.org by Danny Englander (@Danny_Englander) The Feature works well with the Bamboo theme but should also work well with other Drupal 7 themes.

Required third party Drupal modules and library (As of August, 2014)

If you're using drush you can skip to "Installing with drush" below

Install the third party modules above as usual. See Installing contributed modules (Drupal 7) for more info.

Install the Bamboo Slideshow Feature (this module) as per above or if you have a "features" directory under /modules. Be sure to rename the unzipped / untarred "bamboo_slideshow-7.x-2.x" to just "bamboo_slideshow"

Typical locations for Drupal modules:

Notes

  1. When you activate the Bamboo slideshow module, you will be prompted to activate the dependent modules. Be sure to agree to this option to activate these dependent modules.
  2. Tested with Drupal 7.31

Installing with drush

If you have drush installed, once you've renamed and placed bamboo_slideshow in the appropriate place, you can simply do:

drush en bamboo_slideshow

... and you will be prompted to download and enable all dependancies. Note, you'll still need to download and place the flexslider library as per the instriuctions above.

Create Slideshow Content

Now that you have installed everything (and hopefully it went well :), create some content.

"Content > Add content > Bamboo Featured" (which is the name of the new content type this module creates after activation.) Or simply go to /node/add/bamboo-featured.

-- Node Fields

When you create slideshow content, there are a number of fields to be aware of.

Title - standard Drupal title which ends up as the title of the slide.

Slide Text - This is the text displayed in under the slide. The slideshow truncates this at 110 characters so ideally you should not enter any more than that.

Content Link Reference - This field option is if you would like to link your slide to another piece of existing content in your site. This option is ideal if retrofitting the slideshow to an existing site that has a lot of content. For this option, use the View: Bamboo Slideshow: Content Reference Slideshow Block on the blocks admin page.

Page content -- This field option is if you would like to have your slideshow linked to the origin node itself. For this option, use the View: Bamboo Slideshow: Link-to-self Slideshow Block on the blocks admin page.

For more info, refer to the screen capture that illustrates the fields above and what they do. There are also three sample images you can use in the included assets folder, the same ones that are used in the demo.

Choose and Place a Slideshow Block

The Feature creates two blocks as mentioned above. You can see these on the blocks admin page or at /admin/structure/block

  1. View: Bamboo Slideshow: Link-to-self Slideshow Block
  2. View: Bamboo Slideshow: Content Reference Slideshow Block

Use the first block if you are using the Page Content field, use the second block if you are using the Content Link Reference option. See "Node Fields" above for more info. Ideally you want to place this in a block region that is a full width of your theme. In the Bamboo theme, the region is called "Hero 1"

Updating Bamboo Slideshow

To update the Bamboo Slideshow feature, follow these steps:

  1. Download the feature from the repo
  2. Rename the unzipped / untarred "bamboo_slideshow-7.x-2.x" to just "bamboo_slideshow" and replace the old one with this new one wherever you have it in your site. i.e. /sites/all/modules
  3. Clear your Drupal cache
  4. Go to your drupal Features admin page and check to see if Bamboo Slideshow has been overridden at: /admin/structure/features
  5. If 3 above is true (most likely), click on "overridden", check any boxes and save by clicking "Revert Feature".
  6. Clear your Drupal cache once again.

Support

This Feature is free and licensed under GPL. However, if you require support, you can open an issue here on github.