Laravel Device View
, (*1)
Dynamically change Laravel views based on the visitor's device., (*2)
Installation
Composer
From the command line run:, (*3)
composer require torann/device-view
Setup
This package extends Laravel's built in ViewServiceProvider
, so that provider must be replaced in app/app.php
.
Replace the instance of 'Illuminate\View\ViewServiceProvider',
with 'Torann\DeviceView\DeviceViewServiceProvider',
., (*4)
Publish the configurations
Run this on the command line from the root of your project:, (*5)
$ php artisan vendor:publish --provider="Torann\DeviceView\DeviceViewServiceProvider"
A configuration file will be publish to config/device-view.php
., (*6)
Configuration
The default settings are for the device views to be in the views
directory in resources/
with the default theme called default
., (*7)
resources/
views/
default/
mobile/
tablet/
Usage
A standard call to View::make('index')
will look for an index view in resources/views/default/
. However, if a theme is specified with
$app['view.finder']->setDeviceView('mobile');
prior to calling View::make()
then the view will first be looked for in resources/views/mobile/views
.
If the view is not found for the current theme the default theme will then be searched., (*8)
Facade
The DeviceView
facade can also be used if preferred DeviceView::setDeviceView('mobile')
by adding an entry for Torann\DeviceView\Facades\DeviceView
to config/app.php
., (*9)
Helper Methods
DeviceView::getPlatform(), (*10)
Return the user's operating system., (*11)
Example
Given a directory structure of:, (*12)
resources/
views/
default/
layout.blade.php
admin.blade.php
mobile/
layout.blade.php
View::make('layout'); // Loads resources/views/default/layout.blade.php
$app['view.finder']->setDeviceView('default');
View::make('layout'); // Loads resources/views/mobile/layout.blade.php
View::make('admin'); // Loads resources/views/default/admin.blade.php