Yii 2.0: yii2-fotorama-widget

fotorama image gallery yii2 widget
5 followers

Fotorama Yii2 widget

This yii2 extension is a wrapper for the powerful jQuery gallery Fotorama

Requirements

Yii2

Installation

Install this extension using composer.

Run

php composer.phar require metalguardian/yii2-fotorama-widget "*"

or add

"metalguardian/yii2-fotorama-widget": "*"

to the require section of the composer.json file.

Usage

First way:

<?php 
    $fotorama = \metalguardian\fotorama\Fotorama::begin(
        [
            'options' => [
                'loop' => true,
                'hash' => true,
                'ratio' => 800/600,
            ],
            'spinner' => [
                'lines' => 20,
            ],
            'tagName' => 'span',
            'useHtmlData' => false,
            'htmlOptions' => [
                'class' => 'custom-class',
                'id' => 'custom-id',
            ],
        ]
    ); 
    ?>
        <img src="http://s.fotorama.io/1.jpg">    
        <img src="http://s.fotorama.io/2.jpg">
        <img src="http://s.fotorama.io/3.jpg">
        <img src="http://s.fotorama.io/4.jpg">
        <img src="http://s.fotorama.io/5.jpg">
    <?php $fotorama->end(); ?>

Second way:

<?php 
    echo \metalguardian\fotorama\Fotorama::widget(
        [
            'items' => [
                ['img' => 'http://s.fotorama.io/1.jpg', 'id' => 'id-one',],
                ['img' => 'http://s.fotorama.io/2.jpg',],
                ['img' => 'http://s.fotorama.io/3.jpg',],
                ['img' => 'http://s.fotorama.io/4.jpg',],
            ],
            'options' => [
                'nav' => 'thumbs',
            ]
        ]
    ); 
    ?>

To use CDNJS put this before run widget, will be used current version:

<?php \metalguardian\fotorama\Fotorama::$useCDN = true; ?>

Or select custom version:

<?php \metalguardian\fotorama\Fotorama::$useCDN = '4.5.0'; ?>

To setup default Fotorama widget options to all galleries on page:

<?php 
    \metalguardian\fotorama\Fotorama::setDefaults(
        [
            'nav' => 'thumbs',
            'spinner' => [
                'lines' => 20,
            ],
            'loop' => true,
            'hash' => true,
        ]
    );
    ?>

For complete documentation of Fotorama and all widget options please refer to the official Fotorama page

License

yii2-fotorama-widget is released under the MIT License. See the bundled LICENSE.md for details.

Resources

Total 2 comments

#18481 report it
Alain L at 2014/11/04 09:24pm
Very good.

This is much, much better than the default bootstrap widget. Nice job.

#17393 report it
Raoul at 2014/06/03 05:21am
great !

Great widget ! Thanks for sharing ....

Leave a comment

Please to leave your comment.

Create extension
Downloads
No downloadable files yet