analyticsface/yii2-mobile-detector

Mobile detector for Yii2 Framework.

Aface Mobile Detect

Installation

The preferred way to install this extension is through composer. This requires the composer-asset-plugin, which is also a dependency for yii2 – so if you have yii2 installed, you are most likely already set., _(*1)

Either run, _(*2)

composer require analyticsface/yii2-mobile-detector:*

or add, _(*3)

"analyticsface/yii2-mobile-detector" : "*"

to the require section of your application's composer.json file., _(*4)

Usage

add rule for hide 'index' action, _(*5)

'<controller:\w+>/' => '<controller>/index'

1) Add to /frontend/config/bootstrap.php, _(*6)

Yii::$container->set('aface\mobiledetector\mode\ClientMode', function () {
    return new \aface\mobiledetector\mode\ClientMode(Yii::$app->request);
});

2) Add to 'components' view, _(*7)

'components' => [
        'view' => function (\aface\mobiledetector\mode\ViewMode $mode) {
            return Yii::createObject([
                'class' => 'yii\web\View',
                'theme' => $mode->isMobile()
                    ? [
                        'basePath' => '@frontend/themes/mobile',
                        'baseUrl' => '@web',
                        'pathMap' => [
                            '@frontend/views' => '@frontend/themes/mobile/views',
                        ],
                    ]
                    : [
                        'basePath' => '@frontend/themes/desktop',
                        'baseUrl' => '@web',
                        'pathMap' => [
                            '@frontend/views' => '@frontend/themes/desktop/views',
                        ],
                    ],
            ]);
        },
        ...
    ]

3) Add filter 'as viewMode', _(*8)

 'components' => [
        ...
    ],
    'as viewMode' => [
        'class' => 'aface\mobiledetector\filter\ViewModeFilter',
        'expire' => 30 * 86400 // 30 days
    ],
    'params' => $params,

4) Add to layout switch link, _(*9)

<?= Html::a('Mobile version', Url::current(['mode' => 'mobile']), ['data-method' => 'post']) ?>

5) If css/js files used from theme, _(*10)

a) add to main Asset, _(*11)

public $sourcePath = '@theme';

b) add alias, _(*12)

'components' => [
        'view' => function (\aface\mobiledetector\mode\ViewMode $mode) {

            $theme = Yii::$app->request->getCookies()->getValue(\aface\mobiledetector\mode\ClientMode::COOKIE_NAME);

            if ($theme === null) {
                $theme = $mode->isMobile() ? 'mobile' : 'desktop';
            }

            Yii::setAlias('theme', '@frontend/themes/' . $theme);

            ...   
        },
        ...
    ]