NAME

Dancer::Plugin::Device::Layout - Dancer v1 plugin Dancer::Plugin::Device::Layout dynamically changes layout to match user agent's best layout.

VERSION

This documentation describes Dancer::Plugin::Device::Layout v0.1.

SYNOPSIS

    package MyApp;
    use Dancer ':syntax';
    use Dancer::Plugin::Device::Layout;
    
    get '/' => sub {
      my $tokens = {};
      my $options = { device_layout };
      template 'index', $tokens, $options;
    };

DESCRIPTION

Dancer::Plugin::Device::Layout was invented to extend YANICK's Dancer::Plugin::MobileDevice with tablet detection.

SUBROUTINES/METHODS

device_layout

Returns context sensetive layout information.

    # Returns ( layout => 'normal' )
    my $options = { device_layout };
    
    # Returns 'normal'
    my $display_layout = device_layout;

DIAGNOSTICS

"device_layout" does have diagnostic functionality. It takes a hash to override some internal values.

override_device => normal|tablet|mobile

Ignores the user agent and assume user agent is as provided.

CONFIGURATION AND ENVIRONMENT

Dancer::Plugin::Device::Layout uses Dancer's config system to configure itself.

Extend your config.yml like this:

    plugins:
      Device::Layout:
        normal_layout:    normal
        mobile_layout:    mobile
        tablet_layout:    tablet
        no_tablet:        0
        tablet_as_mobile: 0
        no_mobile:        0

normal_layout: LAYOUT

The normal layout when user agent is nighter a tablet nor a mobile device. Default is 'main'.

mobile_layout: LAYOUT

The mobile layout when user agent is a mobile but not a tablet device. Default is 'mobile'.

tablet_layout: LAYOUT

The tablet layout when user agent is a tablet device. Default is 'tablet'.

no_tablet: 1|0

Disable tablet detection. Default is '0'.

tablet_as_mobile: 1|0

Treat tablet as mobile devices. Default is undef.

no_mobile: 1|0

Disable mobile detection. Default is '0'.

DEPENDENCIES

strict

warnings

utf8

version 0.77 or higher

Dancer 1.3111 or higher (not 2.x)

Dancer::Plugin

HTTP::BrowserDetect 1.51 or higher

INCOMPATIBILITIES

Currently there are no incompatibilities known.

BUGS AND LIMITATIONS

Currently there are no bugs or limitations known. Please report bugs at GitHub Issues.

AUTHOR

• BURNERSK burnersk@cpan.org

LICENSE

Dancer::Plugin::Device::Layout by BURNERSK is licensed under a Artistic License 2.0 License.

COPYRIGHT

Copyright © 2013, BURNERSK. Some rights reserved.

cpanm Dancer::Plugin::Device::Layout

perl -MCPAN -e shell
install Dancer::Plugin::Device::Layout