Dynamic display block slideshow module for Drupal

1. DDblock module and Required Modules
   1. Dynamic display block module.
   2. Libraries API module.
   3. Views module.
   4. jquery.cycle plugin.
      1. Download the full version (NOT the Cycle Lite version) of the jquery cycle plugin from http://malsup.com/jquery/cycle/download.html
         (use jquery.cycle.all.min.js (packed version) or jquery.cycle.all.js, tested till version 2.99)
      2. Install the jquery cycle plugin in /sites/all/libraries/jquery.cycle/
2. Slideshow themes
   The module has a default slideshow theme without a pager. 6 free example slideshow themes with different pagers, can be downloaded from the download page (ddblock-upright10p-60p-v7-1-3.zip)
   Extract the “custom” folder from the ddblock-upright10p-60p-v7-1-3.zip file and its content into the drupal theme directory of the Drupal theme you use: sites/all/themes/[your_theme]/custom. The Drupal theme which is set as default in the drupal themes configuration page is [your_theme]. The directory structure should now be: sites/all/themes/[your_theme]/custom/modules/ddblock/....
   Important note: After installing the slideshow themes, clear the cache so the Drupal theme system picks up the new .tpl.php files.
3. MODULES - Installation modules
   1. Copy required modules to: sites/all/modules.
   2. Enable the required modules.
   3. Enable the ddblock module.
   4. Goto: Administration > People > Permissions.
   5. Give permissions which roles can administer and/or view dynamic display blocks.
   6. Save permissions.
4. CONTENT TYPES - Create Content Type
   Create a content type for the slideshow.
   Fields which can be included are:
   • Title – Title of a slide and title of full node view (standard with a content type).
   • Image – Slide image and pager image (new imagefield).
   • Slide text – Text on a slide (new text field).
   • Body – Text of full node view (standard with a content type).
   • Pager image - Image of a pager_item when another image needed. (new imagefield)
   • Pager item text – Text of a pager_item (new text field).

Note: For using different sizes of the same image in the slide and the pager, just use one image and add this imagefield twice to the view to give different styles.

5. CONTENT - Create Nodes
   Create at least two nodes to make the slideshow work.
   1. Navigate to Administration > Content > Add content [your content type].
      • Fill in Title – Used for the title of a slide and the title of the full node view.
      • Upload Image – Image used for slide and pager.
      • Fill in Slide text – Used for the text on a slide.
      • Fill in Body – Used for the text of the full node view.
      • Upload pager image - Used for the image of a pager item.
      • Fill in Pager item text – Used for the text of a pager item.
   2. Click Publishing options and check Published.
   3. Click Save button.
6. VIEWS - Create View
   Create a view for your content type and add the fields for the slideshow.
   • Filter on your content type and only display published nodes.
   • Add the fields for the slideshow; Title, image, slide_text, pager_text, path or link (for readmore button.)
   • Set maximum number of slides to show in the slideshow.
   • Sort on publication data. (optional)
   • Create a block display.

   Notes:

   • When adding a path (aliased path to node) for the readmore button, you need to rewrite the path field in the view and use <a href="[path]">Read more...</a> to add the link.
     Another option is to use a link field in the content type so a link can be added to any page and each slide can have a different title on the button.
   • For the pager item don't use a link to the node. The css used for the pager does not support the link and wil look broken. Removing the link will show the pager correct.

7. DDBLOCK - Enable content type and view for ddblock (SETTINGS TAB)
   1. Navigate to Administration > Structure > Dynamic display block.
   2. Click the Settings tab.
   3. Select the checkbox next to: [your content type].
   4. Select the checkbox next to: [views – block display of your view].
   5. Click Save configuration button.
8. DDBLOCK - Create Dynamic display block instance of [your view] (INSTANCE TAB)
   1. Navigate to Administration > Structure > Dynamic display block.
   2. Click the Instance tab.
   3. Type a unique instance title in the Instance Title textfield.
   4. Select [your view] in the Block type.
   5. Click the Add Instance button.
9. DDBLOCK - Configure the block (LIST TAB)
   1. Navigate to Administration > Structure > Dynamic display block.
   2. Click the List tab.
   3. Click on the configure block link. (You can also do the same thing from Administration > Structure > Blocks).
   4. Configure the block as follows:
      Display method:
      When default setting are used nothing has to be done here, otherwise:
      • Choose Cycleblock radio button to use the jQuery cycle plugin functionality.
      • Use advanced settings.

      Template:

      • You can choose any of these slideshow themes: Upright10 Upright20 Upright30 Upright40 Upright50 Upright60. Note: When the slideshow themes don't show up in the select list, check if they are installed in the right place and read permissions are given on the filesystem.
      • When custom themes are installed they can also be chosen here.
      • When a slideshow theme supports sizes files click the "get template sizes" button to be able to chose the available sizes. If no sizes files are available the only choice is default.

      Mappings:
      Map the "views fields" to the "slideshow theme fields".
      notes:

      • The same image for the slide and pager can be used. If an additional pager image field is available, that field can be used for the pager image.
      • Don't use a link in the pager text or the pager image.

      Slideshow settings:
      When default setting are used nothing has to be done here, otherwise:
      Choose transition effect, Speed, Timeout, Sort Order, Pause and Next.
      Prev/next Pager settings:
      Check the checkbox: Prev/Next Pager to enable a prev/next pager on the slideshow. (by default images will be used for the prev/next pager.
      When default setting are used nothing has to be done here, otherwise:

      1. Choose pager event.
      2. Type text for prev and next pager if no images are used, or you require text on the image
      3. Choose if you want to Hide Prev/Next Pager when no slide available.

      Pager settings:
      Check the checkbox: Use Pager to enable a pager for the slideshow.
      When default setting are used nothing has to be done here, otherwise:

      1. Pager type will be chosen automatically.
      2. Choose Pager position.
      3. Choose Pager event.
      4. Choose other available pager settings.

      Slide text settings:
      Check the checkbox: Use slide text to enable the slide-text for the slideshow.

      1. Choose the slide-text position.
      2. Choose the slide-text container. (can be left on default setting in most cases)
      3. To enable slide-text effects click on Use jQuery effects for text of a slide.
         When default setting are used nothing has to be done here, otherwise:
         1. Choose Slide text position.
         2. Choose Before Effect.
         3. Choose Speed Before Effect.
         4. Choose After Effect.
         5. Choose Speed After Effect.

      Custom jQuery Cycle Plugin settings:
      To enable custom settings for the cycle plugin, you can add lines here in json format, see helptext.

10. BLOCKS - enable the ddblock instance in a region
    1. Navigate to Administration > Structure > Blocks.
    2. Place your newly created ddblock instance in a region of your theme.
       Note:Use the ddblock instance instead of the block display of the view.
    3. Save

Your slideshow should be working now!

Important notes

• If the slideshow does not work, please have a look in the issue queue for similar issues. (Also search the closed ones.)
• When there are no similar issues in the issue queue, create a new one.
• Give enough information, what you did, how it can be replicated, a link to your site, etc, so you can get accurate answers on your issues.
• Please only post comments here to improve the tutorial.
• Please post support requests, feature requests, bug reports for the module in the issue queue .