=== mobble ===
Contributors: scottsweb
Donate link: https://flattr.com/profile/scottsweb/things
Tags: mobile, conditional, css, media, queries, functions
Requires at least: 3.0
Tested up to: 4.7
Stable tag: trunk
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Helper plugin that provides conditional functions for detecting a variety of mobile devices & tablets. Perfect accompaniment to CSS Media Queries.

== Description ==

mobble provides mobile related conditional functions for your site. e.g. [is_iphone(), is_mobile() and is_tablet()](http://wordpress.org/extend/plugins/mobble/faq/ "More examples").

CSS media queries are great for creating responsive web designs but they do not always provide enough control. There are times when not all of the content, JavaScript or CSS on a page is relevant for a particular device. With the mobble functions you can make these kind of tweaks to your theme.

mobble can also add device information to the body class of your theme allowing you to easily target your CSS for different gadgets.

[a plugin by Scott Evans](http://scott.ee/ "Freelance WordPress web design Farnham, Surrey")

== Installation ==

To install this plugin:

1. Upload the `mobble` folder to the `/wp-content/plugins/` directory
1. Activate the plugin through the 'Plugins' menu in WordPress
1. You can now use `<?php is_mobile(); is_tablet(); // etc ?>` functions in your themes/templates
1. If you want you can also disable the device specific body classes in the WordPress Admin->Settings->mobble setting section

== Frequently Asked Questions ==

= What functions are available? =

The most useful ones are:

`<?php
is_handheld(); // any handheld device (phone, tablet, Nintendo)
is_mobile(); // any type of mobile phone (iPhone, Android, etc)
is_tablet(); // any tablet device
is_ios(); // any Apple device (iPhone, iPad, iPod)
?>`

You can also use:

`<?php
is_iphone();
is_ipad();
is_ipod();
is_android();
is_blackberry();
is_opera_mobile();
is_symbian();
is_kindle();
is_windows_mobile();
is_motorola();
is_samsung();
is_samsung_tablet();
is_sony_ericsson();
is_nintendo();
?>`

Inspecting `Mobile_Detect.php` will also reveal some other useful tools.

= Do you have any examples? =

Yup. This first example disables the sidebar for mobile/phone devices:

`<?php
if (!is_mobile()) {
	get_sidebar();
}
?>`

This second example loads a specific stylesheet for Apple devices (iPhone, iPod and iPad):

`<?php
if (is_ios()) {
	wp_enqueue_style('ios', get_template_directory_uri() . '/ios.css');
}
?>`

= Caching =
Please note that in certain setups caching will cause undesired behaviour. If your cache is set too aggressively PHP will be skipped and the device detection will not work.

== Screenshots ==

1. Code example - loading different navigations for mobile and desktop.
2. mobble settings screen for enabling/disabling the body class.

== Changelog ==

= 1.6 =
* Mobile Detect 2.8.24
* Add edge body class (props Luca Speranza)
* Add filters to functions (props Matthew Keasling)

= 1.5 =
* Add German translation (props @rpkoller)
* Minor PHP improvements
* Mobile Detect 2.8.17

= 1.4 =
* Run through PHP tidy
* Mobile detect update to 2.8.13

= 1.3 =
* Update mobile detect library to 2.7.6
* Small CSS change for 3.8

= 1.2.1 =
* Small bug fix on is_mobile()
* Moved screenshots out of trunk

= 1.2 =
* Now uses mobile-detect (http://mobiledetect.net/) which provides more accurate and varied detection
* Mobiles can now be graded (A,B,C) using the mobile-detect API (see mobile-detect.php) or mobiledetect.net
* is_palm, is_lg, is_nokia will be removed soon - check depricated notices
* New check for is_kindle - feedback on this one appreciated as I cannot test it

= 1.1 =
* Correction to the PHP.
* New body class of .desktop for anything not handheld
* Tested on 3.2+

= 1.0 =
* Initial release.