Mobile navigation and a basic infrastructure for mobile buttons on a Plone site.

Navigation

Verified details

These details have been verified by PyPI
Maintainers
Avatar for 4teamwork from gravatar.com 4teamwork Avatar for bierik from gravatar.com bierik Avatar for buchi from gravatar.com buchi Avatar for deif from gravatar.com deif Avatar for elio.schmutz from gravatar.com elio.schmutz Avatar for jone from gravatar.com jone Avatar for lukasg from gravatar.com lukasg Avatar for phgross from gravatar.com phgross

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: GNU General Public License (GPL) (GPL2)
  • Author: Mathias Leimgruber
  • Tags ftw, plone, mobile, navigation
Classifiers

Project description

Introduction

With ftw.mobile you can implement mobile buttons, which shows a list of options on click. The package needs ftw.theming, which provides the basic styles.

Plus it provides a mobile navigation, which is also displayed as a mobile button, but nbehaves completely different.

ALPHA STATE: This software is currently under heavy development and the actual version may not be compatible with the final version.

Installation

  • Add the package to your buildout configuration:

[instance]
eggs +=
    ...
    ftw.mobile

Usage

Two default buttons are registered by default.

  • User Menu

  • Navigation

Basically the buttons are rendered in a viewlet, which is visible at an certain viewport size.

Register new button

Minimal example:

from ftw.mobile.buttons import BaseButton


class UserButton(BaseButton):

    def label(self):
        return u"User menu"

    def position(self):
        return 1000

    def data(self):
        """json data to display"""
        context_state = getMultiAdapter((self.context, self.request),
                                        name=u'plone_context_state')

        user_actions = context_state.actions('user')

        def link_data(item):
            return {'url': item.get('url'),
                    'label': item.get('title')}
        return map(link_data, user_actions)

You need to define at least the label, the position and the data for a working mobile button.

Keep in mind, that the data method needs to return valid json data structure:

[
    {
        "url": "$LINK_URL",
        "label": "$LINK_LABEL"
    },
    {
        "url": "$LINK_URL",
         "label": "$LINK_LABEL"
    }
]

The user button has the postion 1000 and is rendered most right position and the navigation has the position 100, which is on the most left side.

The navigation button is somehow special across his complexity. The navigation button is not considered a simple button ;-)

Details Navigation Button

The mobilenavigation adds two additional wrappers arround all children of the body on pageload.

Development

Python:

  1. Fork this repo

  2. Clone your fork

  3. Shell: ln -s development.cfg buidlout.cfg

  4. Shell: python boostrap.py

  5. Shell: bin/buildout

Run bin/test to test your changes.

Or start an instance by running bin/instance fg.

Changelog

1.0.1 (2016-07-18)

  • Use zindex system from ftw.theming to fix dropdown menues [Kevin Bieri]

1.0.0a3 (2016-07-11)

  • Introduce transitionend marker on root element. [Kevin Bieri]

1.0.0a2 (2016-07-06)

  • Fix offcanvas navigation on iOS devices. Rework revealing offcanvas navigation using two additional wrappers. Refactor styling. [Kevin Bieri]

1.0.0a1 (2016-07-06)

  • Init release

Project details

Verified details

These details have been verified by PyPI
Maintainers
Avatar for 4teamwork from gravatar.com 4teamwork Avatar for bierik from gravatar.com bierik Avatar for buchi from gravatar.com buchi Avatar for deif from gravatar.com deif Avatar for elio.schmutz from gravatar.com elio.schmutz Avatar for jone from gravatar.com jone Avatar for lukasg from gravatar.com lukasg Avatar for phgross from gravatar.com phgross

Unverified details

These details have not been verified by PyPI
Project links
Meta
  • License: GNU General Public License (GPL) (GPL2)
  • Author: Mathias Leimgruber
  • Tags ftw, plone, mobile, navigation
Classifiers

Release history Release notifications | RSS feed

2.2.2

2.2.1

2.2.0

2.1.0

2.0.1

2.0.0

1.10.3

1.10.2

1.10.1

1.10.0

1.9.0

1.8.0

1.7.2

1.7.1

1.7.0

1.6.6

1.6.5

1.6.4

1.6.3

1.6.2

1.6.1

1.6.0

1.5.1

1.5.0

1.4.0

1.3.0

1.2.0

1.1.0

1.0.2

This version

1.0.1

1.0.0a3 pre-release

1.0.0a2 pre-release

1.0.0a1 pre-release

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ftw.mobile-1.0.1.tar.gz (44.5 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page