// $Id:

Dynamic Display Block Module

Note: This is an alpha version of the module for testing and review purpose only. 
      Although the module functionally works. Don't use it on a production site.

CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Installation
 * Configuration

INTRODUCTION
------------
Original idea cycle module by roopletheme - http://drupal.org/user/164625

Code changed by:
* Philip Blaauw (ppblaauw) - http://drupal.org/user/155138
* Iren T. Biasong (iren_cruz) - http://drupal.org/user/305000

Dynamic display block is a block module which creates a block that presents content 
in a dynamic way using the jQuery Cycle plug-in and the jQuery easing plug-in. 

You can select images as the content of a dynamic display block by specifying a folder 
that contains the image files or select a content type. The teaser of the 
nodes of this content type will be used as the content of the dynamic display block. 

Also header image blocks from the Header Image module can be used. 
To use the functionality of the Header Image module a small patch has to be applied to 
this module. (We have contacted the maintainer of the Header Image module to let the 
Dynamic Display block module cooperate with the Header Image module to avoid using 
a patch)

The module does not attempt to size, scale, crop, or otherwise alter images. 
It will be displayed exactly as it exists. You can use CSS and/or HTML to have 
the browser scale the images if necessary. The best option is to size the images 
before you use them in a dynamic display block.

The module uses the teaser of content types and doesn't show extra links if a 
content type is chosen as the content of a dynamic display block.

Several effects and other setting can be set in the configuration settings of 
a dynamic display block.

INSTALLATION
------------
Note: dynamic display block depends on the jQuery-update module. 
      Please install this module first.

1. Download, extract and copy the ddblock folder to your sites/all/modules directory. 

2. Enable the module at Administer > Site Building > Modules. 

CONFIGURATION
-------------
1. Navigate to Administer > Site configuration > Dynamic display block

2. Create a dynamic display block and configure the block (leave all default settings). 

3. Place some pictures in the /files/images/ddblock folder (.jpg, .gif or .png) files.

4. Navigate to Administer > Site building > Blocks 

5. Place the block in one of the regions of your Site.

Content settings:

Image Folder: The folder containing image files to be used as the content of 
dynamic display block. Use a relative path. The default is files/images/ddblock

Content Types: The nodes of the content type to be used as content of dynamic display block.

Number of nodes: Number of nodes to show in dynamic display block.

Content container: Container of the content to show, eg. img, to show images.

Settings:

Transition Effect: The transition effect between content.

Speed: Speed of the transitions (1000 = 1 second).

Timeout: The time (in Milliseconds) between transitions (1000 = 1 second, 0 to 
disable auto advance).

Sort Order: The display order of the content.

Pause: Enable users to pause the cycle by hovering on the content.

Next: Enable users to advanced to the next content by clicking on the content.

Pager: Add a number pager or an image pager to a dynamic display block.

Custom Settings:

Custom Options: Custom options for the cycle plug-in. If you use custom options, 
the other settings are not used.

