Wrapper around the Backstretch JQuery plugin

Installs: 3 379

Dependents: 0

Suggesters: 0

Security: 0

Stars: 3

Watchers: 4

Forks: 0

Open Issues: 0



1.0.1 2014-10-28 15:07 UTC

This package is not auto-updated.

Last update: 2023-09-26 02:38:21 UTC


This yii2 extension is a wrapper around the jQuery Backstretch Plugin.


The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist raoul2000/yii2-backstretch-widget "*"

or add

"raoul2000/yii2-backstretch-widget": "*"

to the require section of your composer.json file.


Once the extension is installed, simply use it in your code like for instance in the examples below.

Start a slideshow on the background of element #elementId.

Note that the images are defined as local or remote. The second argument of pluginOptions contains the plugin initialization settings that can be redefined if the default ones are not what you want.

		'selector' => '#elementId',
		'pluginOptions' => [
				'duration' => 3000,
				'fade' => 'slow',
				'centeredX' => true,
				'centeredY' => true

To attach Backstretch as the body's background

In its simplest form, attach an image to the background of the body element. Default settings are used to initialize the plugin.

		'pluginOptions' => 'path/to/image1.jpg'

For complete documentation please refer to the jquery-backstretch Github page

If this plugin did not convinced you, have a look to the Background Switcher Plugin


yii2-backstretch-widget is released under the BSD 3-Clause License. See the bundled LICENSE.md for details.