Drupal integration for the excellent Bootstrap Tour library.

Features

  • Add and configure multiple site tours, each with multiple steps
  • Tours can span multiple pages seamlessly
  • Each step has GUI a configurable popup title, popup body, placement relative to the element, CSS selector to target the element, and path
  • Leave the CSS selector out to show steps as a modal centered on the page
  • Popup content accepts filtered/formatted text so you can add HTML and use a WYSIWYG if you'd like
  • Back/Forward/End Tour buttons on each step of the tour
  • Tours can auto-run the first time the user hits the specified path or they can be run manually in code
  • You can also force a tour to run by linking whatever the first step's path is with ?tour=tourname added to the URL.
  • Features integration

Installation

  1. You'll first want to make sure that you're including the following Bootstrap assets in one way or another (usually they'll come with your theme if using a Bootstrap based theme):
    • bootstrap.css
    • bootstrap.tooltip.js
    • bootstrap.popover.js
  2. Download and enable this module.
  3. Head to /admin/structure/tours/add to create a new tour. You can set it to auto-run or you can run it manually in your code by running bootstrap_tour_run_tour($tourname) wherever you want. Or, just link to /path/of/first/step?tour=tourname
  4. Optional: If you want to host the library yourself rather than using CDNJS, you can do this manually by extracting this zip file to sites/all/libraries/bootstrap_tour, or by adding something like this to your drush make file:
    ; Bootstrap Tour
    libraries[bootstrap_tour][download][type] = get
    libraries[bootstrap_tour][download][url] = https://github.com/sorich87/bootstrap-tour/archive/v0.5.0.zip
    libraries[bootstrap_tour][destination] = libraries
    libraries[bootstrap_tour][directory_name] = bootstrap_tour
    

About the 2.x branch

The 2.x branch converts tour steps into entities allowing steps to be re-ordered, removed, edited. The non-entity 1.x branch is no longer supported.

Project information

Releases