riverskies / laravel-mobile-detect
Instant mobile detection access directly from within Blade templates.
Installs: 1 085 806
Dependents: 9
Suggesters: 2
Security: 0
Stars: 225
Watchers: 13
Forks: 32
Open Issues: 4
Requires
Requires (Dev)
- laravel/laravel: 5.5.*
- philo/laravel-blade: ^3.1
- phpspec/prophecy-phpunit: ^1.1
- phpunit/phpunit: ^6.3
README
A package that enables you to use device detection right in your Blade templates. (Utilises the well-known, constantly updated PHP mobile detection library.)
When would you use this package?
Responsive CSS may help to make content in the browser look nice on different devices but it won't help you serve responsive content from your backend (at least not the easy way). This can have a really bad knock-on effect on the user experience (have you ever waited for a large image to load while having a bad connection on your mobile?). This package will make it a breeze to serve device-specific content right from your back-end.
How does this package work?
The package implements various Blade directives that you can use to serve different content from your Blade template for different device types.
Installation
Install the package through composer:
$ composer require riverskies/laravel-mobile-detect
Laravel 5.4 or earlier
Add the service provider to your config/app.php file:
Riverskies\Laravel\MobileDetect\MobileDetectServiceProvider::class
Optionally, you can add an alias as well if you'd like to use the underlying instance anywhere else (or have access to all the functions):
'MobileDetect' => Riverskies\Laravel\MobileDetect\Facades\MobileDetect::class
Usage
Use the new Blade directives in your template files:
@desktop <img src="/path/to/high-definition/image"/> @elsedesktop <img src="/path/to/handheld-optimised/image"/> @enddesktop
NOTE You might have to run
php artisan view:clear
to have the new Blade directives take effect!
Available directives
@desktop
, @elsedesktop
, @enddesktop
- for destkop devices
@handheld
, @elsehandheld
, @endhandheld
- for non-desktop (mobile and tablet) devices
@tablet
, @elsetablet
, @endtablet
- for tablet devices
@nottablet
, @elsenottablet
, @endnottablet
- for non-tablet (desktop or mobile) devices
@mobile
, @elsemobile
, @endmobile
- for mobile devices
@notmobile
, @elsenotmobile
, @endnotmobile
- for non-mobile (desktop or tablet) devices
@ios
, @elseios
, @endios
- for iOS platforms
@android
, @elseandroid
, @endandroid
- for Android platforms
The usage of @else...
directives are optional.