derhaeuptling/contao-mobilecontent

MobileContent extension for Contao Open Source CMS

Thursday, May 10, 2018
by derhaeuptling
Repository
2 Watchers
4 Stars
265 Installations

PHP
0 Dependents
0 Suggesters
2 Forks
0 Open issues
9 Versions
37 % Grown

The README.md

Mobile Content (mobilecontent)

This extension lets you show or hide specific articles, content elements and frontend modules on mobile or desktop devices. Image fields are extended – you can now add an different image for the mobile devices., _(*1)

It works out of the box by recognizing the visitor user agent and displaying the appropriate content.
For use with CDN that caches the pages you may want to enable a separate mobile domain though (see explanation below)., _(*2)

The extension is compatible with Contao 3 and 4., _(*3)

Toggle the content

To toggle the content you can either edit the element settings or simply use the icons available in the list view:, _(*4)

, _(*5)

Different mobile image

To use a different image for mobile devices check Different mobile image on any elment with an image., _(*6)

, _(*7)

Mobile domain

In the website root settings you can enable the special domain for the mobile devices.
If mobile domain is enabled mobile and desktop layout will be distinguished by domain only., _(*8)

, _(*9)

Front end module

To allow easy switch between the desktop and mobile domains you can add the mobile/desktop switch front end module that displays a short information about the parallel domain and allows the visitors to switch to the correct version of the website for their device., _(*10)

Auto-redirect

When the auto-redirect is enabled, right before the visitor is redirected to the correct version of the page the script adds the mobile-content-redirecting CSS class to the <body> element., _(*11)

Note: when this feature is enabled, the toggle links get the extra hash parameter to the URL. When the user visits a page with that parameter (e.g. by clicking the link) the cookie will be set that prevents from yet another redirect back. This allows e.g. the mobile visitors to be redirected to the mobile version of the website on first page view but they can still view the desktop version by explicitly clicking the link., _(*12)

mobile/desktop detection by Viewport

If the Contao default mobile/desktop detection by User Agent does not fit your needs, you can alternatively activate detection by viewport width.
As this detection is done by JavaScript, the mobile/desktop switch front end module needs to be added to the layout., _(*13)

Insert tags

mobile::toggle

Adds a link to toggle between desktop and mobile view. This link carries the classes mobile_toggle and desktop or 'mobile' corresponding to the destination of the link (not the type of page it is on!)., _(*14)

mobile::toggle_url

Is replaced by the URL to the currently inactive view mode., _(*15)

mobile::toggle_text

Is replaced by the content of the language variable $GLOBALS['TL_LANG']['MSC']['toggleDesktop'][0] or $GLOBALS['TL_LANG']['MSC']['toggleMobile'][0]. This is normally the text of the standard toggle link created by mobile::toggle., _(*16)

mobile::toggle_title

Is replaced by the content of the language variable $GLOBALS['TL_LANG']['MSC']['toggleDesktop'][1] or $GLOBALS['TL_LANG']['MSC']['toggleMobile'][1]. This is normally the title of the standard toggle link created by mobile::toggle., _(*17)

mobile::alternatives::alternative_desktop:alternative_mobile

This insert tags shows only one of the two alternatives alternative_desktop or alternative_mobile depending on which type of view is currently active. Note: there is a single semicolon between the two last chunks in the insert tag., _(*18)

ifmobile […] endifmobile, ifndesktop […] endifndesktop

The content between the start and and tag is skipped if it appears on a desktop page., _(*19)

ifdesktop […] endifdesktop, ifnmobile […] endifnmobile

The content between the start and and tag is skipped if it appears on a mobile page., _(*20)

Developers

To check if the current page is mobile:, _(*21)

$GLOBALS['objPage']->isMobile

Example for the templates:, _(*22)

<?php if ($GLOBALS['objPage']->isMobile): ?>
    mobile content
<?php else: ?>
    desktop content
<?php endif; ?>

content contao mobile

contao-module contao-mobilecontent

MobileContent extension for Contao Open Source CMS

derhaeuptling/contao-mobilecontent

The README.md

Mobile Content (mobilecontent)

Toggle the content

Different mobile image

Mobile domain

Front end module

Auto-redirect

mobile/desktop detection by Viewport

Insert tags

mobile::toggle

mobile::toggle_url

mobile::toggle_text

mobile::toggle_title

mobile::alternatives::alternative_desktop:alternative_mobile

ifmobile […] endifmobile, ifndesktop […] endifndesktop

ifdesktop […] endifdesktop, ifnmobile […] endifnmobile

Developers

The Versions

dev-master

The Requires

by Kamil Kuzminski

by derhaeuptling

2.2.2

The Requires

by Kamil Kuzminski

by derhaeuptling

2.2.1

The Requires

by Kamil Kuzminski

by derhaeuptling

2.2.0

The Requires

by Kamil Kuzminski

by derhaeuptling

2.1.2

The Requires

by Kamil Kuzminski

by derhaeuptling

2.1.1

The Requires

by Kamil Kuzminski

by derhaeuptling

2.1.0

The Requires

by Kamil Kuzminski

by derhaeuptling

2.0.1

The Requires

by Kamil Kuzminski

by derhaeuptling

2.0.0

The Requires

by Kamil Kuzminski

by derhaeuptling