Sliders module for Yii 2

Docs

• Installation cms module

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist infoweb-internet-solutions/yii2-cms-sliders "*"

or add

"infoweb-internet-solutions/yii2-cms-sliders": "*"

to the require section of your composer.json file.

Once the extension is installed, simply modify your common configuration as follows:

return [
    ...
    'modules' => [
        ...
        'yii2images' => [
            'class' => 'rico\yii2images\Module',
            // @frontend/web/
            'imagesStorePath' => '@uploadsBaseUrl/img/store', //path to origin images
            'imagesCachePath' => '@uploadsBaseUrl/img/cache', //path to resized copies
            'graphicsLibrary' => 'GD', //but really its better to use 'Imagick'
            'placeHolderPath' => '@infoweb/sliders/assets/img/placeHolder.png',
        ],
    ],
];

Run this migration

yii migrate/up --migrationPath=@infoweb/sliders/migrations

Import the translations

yii i18n/import @infoweb/sliders/messages

Add to backend/config/main.php

'modules' => [
    ...
    'sliders' => [
        'class' => 'infoweb\sliders\Module',
    ],
    ...
    'cms' => [
        ...
        'sideBarItems'  => [
            'modules'   => [
                ...
                [
                    'label'     => 'Sliders',
                    'i18nGroup' => 'infoweb/sliders',
                    'url'       => '/sliders/slider/index',
                    'authItem'  => 'showSlidersModule',
                    'activeUrl' => 'sliders',
                ],
            ],
        ],
    ],
    ...
],

Configuration

All available configuration options are listed below with their default values.

defaultWith (type: integer, default: 800)

The default with (in pixels) of a new slider.

defaultHeight (type: integer, default: 200)

The default height (in pixels) of a new slider.

enableImageTitle (type: boolean, default: false)

If this option is set to true, it is possible to set a title for each image of a slider.

enableImageSubTitle (type: boolean, default: false)

If this option is set to true, it is possible to set a subtitle for each image of a slider.

enableImageDescription (type: boolean, default: false)

If this option is set to true, it is possible to set a description for each image of a slider.

enableImageUrl (type: boolean, default: false)

If this option is set to true, it is possible to set an url for each image of a slider.

enableTextPosition (type: boolean, default: false)

If this option is set to true, it is possible to set a position for each image text in the a slider.