nivoslider

Nivo Slider, the most awesome jQuery image slider - now version 2.0 alpha
15 followers

Yii version of Nivo Slider.

This release is an alpha version, no bugs related yet.

New features:

  • Dynamic id generation
  • Dynamic div, images, captions an links generation
  • Fixed styles sheets
  • Images assets retouched.

Please report bugs at Forum topic.

Features

  • 9 unique transition effects
  • Simple clean & valid markup
  • Loads of settings to tweak
  • Built in directional and control navigation
  • Packed version only weighs 7kb
  • Supports linking images
  • Keyboard Navigation
  • Free to use and abuse under the MIT license

Browser support

  • Internet Explorer v7+
  • Firefox v3+
  • Google Chrome v4
  • Safari v4
  • Opera v10.5

Please support the original creator.

Resources

Donate

Documentation

Requirements

  • Yii 1.0 or above

Installation

  • Extract the release file under protected/extensions

Usage

Put the follow code into your views.

$this->widget('application.extensions.nivoslider.CNivoSlider', array(
    'images'=>array( //@array images with images arrays.
        array('src'=>'path/to/image'), //only display image.
        array('src'=>'path/to/image', 'caption'=>''), //display image and nivo slider caption.
        array('src'=>'path/to/image', 'url'=>array('')), //display image with link.
        array('src'=>'path/to/image', 'url'=>array(''), 'caption'=>''), //display image with nivo slider caption and link reference.
        ),
    )
);

Try others combinations. See configuration parameters bellow.

Parameters you could set on CNivoSlider

id              =   @string, the id of the nivo slider div. Defaults set to dynamic generation.
htmlOptions     =   @array, the html options of the nivo slider div. Defaults set to null.
fancy           =   @boolean, toggle the defaults fancy style. Defaults set to true.
cssFile         =   @string, path to custom style sheet.  Defaults set to NULL.
config          =   @array, configuration parameters of nivo slider jquery. Defaults set to basic configuration.
images          =   @array containing the images arrays of the widget. Defaults set to NONE.

Goto Nivo Slider website to check nivo slider configuration parameters.

Parameters you could set inside images array

src         =   @string, the path of image,
caption     =   @string, the nivo slider caption of image,
imageOptions=   @array, the html options of image tag
url         =   @array or @string, the path of link,
linkOptions =   @array, the html options of link tag

Change Log

July 24, 2010

  • Initial release.

July 28, 2010 - 2.0 alpha

  • All class code has been rewritten to be more flexible, dynamic and elegant
  • Implemented simple usage
  • Implemented dynamic id generation
  • Implemented dynamic div, images, captions and links generation
  • Implemented dynamic set of images html options and link html options.
  • Fixed nivo-slider.css. Now images with link have cursor pointer.
  • Fixed bullets positioning on fancy-nivo-silder.css.
  • arrow.png and bullets.png have been retouched.
  • Removed the loading.gif asset.

December 06, 2010

  • Fixed some bugs.

Total 10 comments

#5056 report it
TomTheGeek at 2011/09/10 04:51pm
No pics problem

I could see captions rotating but no pics, turns out width and height has to be set or you see nothing.

$this->widget('application.extensions.nivoslider.ENivoSlider', array(
    // set the width and height to see the pictures.
    'htmlOptions'=>array('style'=>'width: 400px; height: 200px;'),
    'images'=>array( //@array images with images arrays.
        array('src'=>Yii::app()->request>baseUrl.'/images/image.jpg',
              'caption'=>'Picture two',
              'linkOptions'=>array(),
             ),
        ),
    )
);
#4621 report it
Asgaroth at 2011/07/26 10:17pm
@Bug

To the suggested modification i had to change line 99 to

echo CHtml::image($item['src'], $options['title'], $options)."\n";

Otherwise im forced to set a caption or get a "Undefined index: caption "

#4243 report it
sirin_ibin at 2011/06/19 10:03pm
How can i control the size?

i tried this extension.it is very useful but whats my problem is images are comming very large size.How can i control the size?

#3863 report it
ejac at 2011/05/15 02:17pm
It works know! :)

I got it! the reason is that there is no default values for the parameters.. Thanks for sharing Great Extensions...

#3860 report it
ejac at 2011/05/15 12:55pm
Are you serious about the usage?

I tried exactly the usage instruction but it doesn't work. I noticed that when you didn't initialize the caption it will not work.. and I don't know why but the images doesn't appear. and also in the documentation part, it says

"application.extensions.nivoslider.CNivoSlider"

i think it must be

"application.extensions.nivoslider.ENivoSlider"

Please make it clear. Thanks!

#3696 report it
jacmoe at 2011/04/29 12:18am
Great work!

Really nice extension!

I had to modify one function to make it work, though:

public function renderImages($items)
    {
        foreach($items as $item) {
                        $options=isset($item['imageOptions']) ? $item['imageOptions'] : array();
                        $link_options=isset($item['linkOptions']) ? $item['linkOptions'] : array();
 
            if (isset($item['caption'])) {
                $options['title']=$item['caption'];
            } else {
                            $options['title'] = '';
                        }
 
            if (isset($item['url'])) {
                echo CHtml::link(CHtml::image($item['src'], $item['caption'], $options), $item['url'], $link_options)."\n";
            } else {
                echo CHtml::image($item['src'], $item['caption'], $options)."\n";
            }
        }
    }
#2432 report it
DarkNSF at 2010/12/30 12:07pm
Fix for this extension

Download the latest version of NivoSlider and copy over the existing library in assets.

http://nivo.dev7studios.com/

#2427 report it
DarkNSF at 2010/12/29 05:52pm
Broken

Appears to be broken with jQuery 1.4.4 which is bundled with Yii Framework 1.1.5

#2426 report it
DarkNSF at 2010/12/29 05:35pm
Issue in documentation
application.extensions.nivoslider.CNivoSlider

should be

application.extensions.nivoslider.ENivoSlider
#35 report it
aztech at 2010/10/07 08:16am
Works like a charm...

Please update example in documentation with "linkOptions". If "linkOptions" is not provided, then extension throws exception.

Leave a comment

Please to leave your comment.

Create extension