metalguardian / yii2-fotorama-widget
fotorama image gallery yii2 widget
Installs: 20 545
Dependents: 1
Suggesters: 0
Security: 0
Stars: 18
Watchers: 3
Forks: 7
Open Issues: 1
Type:yii2-extension
Requires
- bower-asset/fotorama: 4.*
- yiisoft/yii2: *
Requires (Dev)
This package is not auto-updated.
Last update: 2020-11-27 20:22:48 UTC
README
Unfortunately, original Fotorama gallery is no longer maintained. You still can use this extension if fotorama fits your project. Check github thread for alternatives.
Fotorama Yii2 widget
This yii2 extension is a wrapper for the powerful jQuery gallery Fotorama.
Installation
Install this extension using composer.
composer require metalguardian/yii2-fotorama-widget
You should have configured asset-packagist
repository in your project's composer.json
or installed
fxp/composer-asset-plugin
plugin. For more information see Yii2 bower/npm assets manual
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 \metalguardian\fotorama\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
for details.