Web and Mobile documentation
  • User Manual
    • Features
      • Introduction
        • The best technology
        • The best usability
        • The best code
        • Open source
    • Installation
      • Introduction
      • Prerequisites
      • Installation of fresh site
        • Ubuntu
        • OSX
        • Windows
        • Setting it up
        • hosts file location
        • Adding required lines
      • Installation for existing Plone sites
        • Plone 4 buildout.cfg changes
        • Plone 3 buildout.cfg changes
      • Trunk version for developers
        • Modify buildout to include Web and Mobile trunk version sources
        • Running buildout with Mr. Developer
        • Start Plone
      • Uninstall
      • Running automatic test suite
      • Troubleshooting
        • lxml too old
        • This container already has a Virtual Host Monster
        • Unable to preview
    • User experience
    • Multichannel publishing
      • Introduction
      • Mobile options
        • Mobile folder listing
        • Appear in mobile folder listing
      • Convergence options
        • Content media
        • Content overrides
    • Previewing the mobile site
      • Introduction
      • Background on preview technology
      • Preview and login
    • Navigation on mobile site
      • Introduction
      • Mobile Site Actions
      • Mobile folder listing
      • Main navigation
      • Sections
      • Front page shortcut
    • Redirects between web and mobile site
      • Introduction
        • Methods of browser discrimination
        • Preserving the wanted content page in redirect
      • Redirecting logic
      • Web and mobile domain name mappings
      • Manual redirecting URLs
    • Image resize and optimization
      • Introduction
        • Resizing
        • Defloating
      • Default resize algorithm
      • Resizing your own stuff
      • Resizer cache
        • Clearing cache
    • Tracking and analytics
      • Introduction
      • Supported tracking services
      • How to set-up a tracker
        • Using the default Javascript tracking code
        • Different Javascript for web and mobile sites
        • Image based tracking
        • Google Analytics mobile background
      • Bango
      • Admob
      • Real IP address of the client
    • Search engine optimizations
      • User friendly URLs
      • Title and other META tags
      • Sitemap submission
      • robots.txt
      • XHTML
    • Mobile Sitemap protocol
      • Introduction
        • robots.txt
      • Mobile sitemap URLs
    • Settings and configuration
      • mobile_domain_prefixes
      • mobile_domain_suffixes
      • preview_domain_prefixes
      • web_domain_prefixes
      • serve_mobile_via_ip
      • mobile_skin
      • image_resizer_secret
      • image_resize_cache_path
      • default_canvas_width
      • default_canvas_height
      • tracker_name
      • tracking_id
      • tracker_debug
    • Mobile browser detection
      • Enabling handset detection
      • Two-phase handset detection
      • HTML and XHTML
      • Testing different handsets
      • Changing handset database backend
      • Updating Wurlf
    • Special mobile features
    • Add-on product support
      • Introduction
      • Supported add-ons
      • Adding support
    • Roadmap
      • Introduction
        • Version 0.9
        • Version 1.0
        • Version 1.1
        • TODO
    • License and open source contributions
      • Dependencies
    • Troubleshooting
      • Introduction
      • ImportError: initLevenshtein
      • plone_view.mark_view(view) exception
      • Too many redirects error on mobile device when using NGINX
  • Developer Manual
    • Architecture
      • Introduction
        • Integrated products
      • Architecture overview
      • Python run-time
      • Generic mobile.* libraries for Python
        • mobile.sniffer
        • mobile.heurestic
        • mobile.htmlprocessing
      • Plone specific packages
        • gomobile.mobile
        • gomobile.convergence
        • gomobiletheme.basic
        • gomobile.imageinfo
        • gomobile.supporter
        • gomobile.buildout
        • mfabrik.behaviorutilities
        • collective.fastview
    • Site rendering modes
      • Introduction
      • Modes
      • Determining the mode
      • See also
    • Extending and customizing
      • Introduction
      • Core interfaces
    • Theming
      • Introduction
      • Namespace and Python package name recommendations
      • Creating a mobile theme
      • Writing your first theme
        • Theme layer is mobile aware
        • five.grok used
        • Overring the logo
        • Change footer
        • Overriding a browser view for mobile
        • Controlling automatic mobile folder listing
        • Making your own touch friendly link listing
        • Setting CSS and JS locations
        • No viewlet managers
        • Image transformations
        • HTML content transformations
      • Theme examples
      • Plone 3 compatibility
    • Transformations
      • Introduction
      • CSS
        • Desktop visuals trick
      • Rewriting HTML
      • Image resizing
        • Resizing traversable images
        • Resizing non-traversable objects
        • Resizer parameters
    • XHTML compatibility
      • Introduction
      • HTML flavor information
      • XHTML pitfalls
 
Web and Mobile documentation
  • Docs »
  • User Manual »
  • Navigation on mobile site
  • Edit on GitHub

Navigation on mobile site¶

  • Introduction
  • Mobile Site Actions
  • Mobile folder listing
  • Main navigation
  • Sections
  • Front page shortcut

Introduction¶

Since mobile screen estate is expensive, mobile navigation needs some special consideration to work optimally.

Here are explained some options and rules which make navigation smooth on Go Mobile.

Mobile Site Actions¶

The mobile site can have site actions in the right side of the header, that will be some actions that are used often and they are represented with an icon.

For site actions to show up, they need to be specified in ZMI:

  • Navigate to portal_actions

  • Click "Add CMF Action Category"

  • Enter "mobile_site_actions" into the ID field and click Add

  • Select the newly created category and add CMF Action to it

  • It is not enough only to specify the ID, but other fields also need some values, so select the newly created action

  • Title, URL and Icon fields are required. For adding a search button, we'll use:

    Title: "Search",
    URL: "string:${portal_url}/search",
    Icon: "string:${portal_url}/++resource++gomobiletheme.basic/actions/search.png"
    

You can customize this viewlet by overriding TopActions viewlet in gomobiletheme.basic.

Mobile folder listing¶

There is no space navigation portlet, or left side vertical navigation, on the mobile. This is the main navigation method basically on every known web site.

To allow easy navigation and automatic child content listing, each folderish content item has MobileFolderListing viewlet, defined in gomobiletheme.basic package. It displays "Here you can also find:" label and the summary of child content at the bottom of the page.

However, this method is impractical for folders containing more than ten to twenty items. You can opt-out pages from automatic folder listing using Mobile options form.

  • Folderish content item generates mobile folder listing
  • Any item appears in mobile folder listing

Note

If document actions viewlet is hidden, you need to first make it visible using Plone's @@manage-viewlets functionality to access the page.

Main navigation¶

The navigation is based on the mobile_navigation action category, and it can be set only through ZMI:

  • Navigate to portal_actions
  • Click "Add CMF Action Category"
  • Enter "mobile_navigation" into the ID field and click Add
  • Select the newly created category and add CMF Action to it
  • It is not enough only to specify the ID, but other fields also need some values, so select the newly created action
  • Title and URL fields are required (the URL field is an expression so you can use for example "string:${portal_url}/" here for the home page)

You can customize this viewlet by overriding Navigation viewlet in gomobiletheme.basic.

Sections¶

Sections are the text links found in the footer, i,e. Terms of Service, Privacy Policy, Full Site

This can be set the same way as the main navigation, only the name of the category differs, as the sections use "mobile_sections".

You can customize this viewlet by overriding Sections viewlet in gomobiletheme.basic.

Front page shortcut¶

Site logo acts as front page shortcut, like it does on web pages.

Next Previous

© Copyright 2010, mFabrik Research Oy.

Built with Sphinx using a theme provided by Read the Docs.