This is a wrapper to use the Simple FadeSlideShow jQuery plugin from Pascal Bajorat with the Yii framework (PHP)
- jQuery http://jquery.com/
- Yii Framework http://www.yiiframework.com/
- Simple FadeSlideShow http://www.simplefadeslideshow.com/
- download the latest from github or do a checkout ([email protected]:schlypel/Yii-SimpleFadeSlideShow.git)
- put the folder SimpleFadeSlideShow to your extensions folder, usually protected/extensions
- use the provided widget in your view
Thanks to Yii´s auto loading, there is no need to add this extension to your config.
Minimal markup
$this->widget(
'ext.SimpleFadeSlideShow.SimpleFadeSlideShow',
array(
'images' => array('url.to.image','url.to.another.image')
)
);
Advanced markup
$this->widget(
'ext.SimpleFadeSlideShow.SimpleFadeSlideShow',
array(
'images' => array(
array(
'src' => 'url.to.image',
'href' => 'url.to.open.on.click',
'text' => 'Some text to show as link title and image alt tag'
),
array(
'src' => 'url.to.another.image',
'href' => 'url.to.open.on.click',
'text' => 'Some text to show as link title and image alt tag'
)
),
'width' => 624,
'height' => 240,
'interval' => 10000,
'speed' => 'slow',
'ListElement' => false,
'PlayPauseElement' => false,
'autoPlay' => true,
)
);
Basically all options from the jQuery plugin are supported, they may be given directly, if not given, some default values will be used.
Additionally you may give another CSS file or arrow image.
To see a list of all parameters, just have a look at the code, it´s very simple.
things that could be better
- still havent added the additional link target parameter which i have added in my project
- the view only accounts for lists of images at the moment, allthough the original jQuery plugin is absolutely capable of displaying any sort of content (wasn't necessary for my usecase)
- only one slideshow per page, multiple invocations may break it, this is a limitation from the underlying jQuery plugin