edgardmessias/yii2-nprogress

Slim progress bars for Ajax'y applications. Inspired by Google, YouTube, and Medium for Yii2 Framework.

0.3.0 2015-08-19 20:01 UTC

Requires

• bower-asset/nprogress: *
• yiisoft/yii2: *

BSD-3-Clause

• Edgard Messias

• assets
• extension
• pjax
• yii2
• nprogress

README

Slim progress bars for Ajax'y applications. Inspired by Google, YouTube, and Medium for Yii2 Framework.

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-dist edgardmessias/yii2-nprogress "*"

or add

"edgardmessias/yii2-nprogress": "*"

to the require section of your composer.json file.

Usage

Once the extension is installed, simply use it in your view code by :

<?php \edgardmessias\assets\nprogress\NProgressAsset::register($this); ?>

Customization

To change settings, simply add the following code in your configuration

'components' => [
    'assetManager' => [
        'bundles' => [
            'edgardmessias\assets\nprogress\NProgressAsset' => [
                'configuration' => [
                    'minimum' => 0.08,
                    'showSpinner' => true,
                ],
                'page_loading' => false,
                'pjax_events' => true,
                'jquery_ajax_events' => false,
            ],
        ],
    ],
],

Settings

• configuration: The NProgress Configuration (Default: null)
• page_loading: Show NProgress during page loading (Default: false)
• pjax_events: Show NProgress for pjax:start and pjax:end events (Default: true)
• jquery_ajax_events: Show NProgress for ajaxStart and ajaxComplete events (Default: false)