Skip to main content

Collective Amberjack core functionality

Project description

collective.amberjack.core

This package provides core functionality for collective.amberjack package.

Be aware that series 0.9.x is compatible with Plone3, series 1.x is compatible with Plone4.

How to create new tour

First of all you need to define the tour.

A tour looks like that:

{'tourId': u'example_tour',
 'title': _(u"Example tour"),
 'steps': <steps>}

a <steps> looks like that:

({'url': u'/',
  'xpath': u'',
  'xcontent': u'',
  'title': _(u"Some title"),
  'text': _(u"Some text"),
  'steps': ({'description': _(u"Some description"),
             'idStep': u'',
             'selector': u'',
             'text': u''},
            ...
           )
 },)

Steps parameters:

  • the description for the user (use [] to <span class=”ajHighlight”>highlight</span> parts),

  • the step id, [see ajStandardSteps section below]

  • an optional selector

  • an optional text used by the step

An example:

>>> add_folder = {
>>>                    'url': u'/',
>>>            'xpath': u'',
>>>            'xcontent': u'',
>>>            'title': _(u"Create a new folder"),
>>>            'text': _(u"Folders are ..."),
>>>            'steps': ({'description': _(u"Click the [Add new...] drop-down menu."),
>>>                       'idStep': u'menu_add-new',
>>>                       'selector': u'',
>>>                       'text': u''},
>>>                      {'description': _(u"Select [Folder] from the menu."),
>>>                       'idStep': u'new_folder',
>>>                       'selector': u'',
>>>                       'text': u''})}
>>>
>>> ajTour = {'tourId': u'basic01_add_a_folder',
>>>           'title': _(u'Add a Folder'),
>>>           'steps': (add_folder,
>>>                    )}

Then you have to register it in zcml:

<configure
    xmlns:collective.amberjack="http://namespaces.plone.org/collective.amberjack.core">
    <collective.amberjack:tour
        tourdescriptor=".example_tour.ajTour"
    />
</configure>

Changelog

0.9 (2010-04-30)

  • Change version to 0.9 (plone3 release series) [amleczko]

  • Renamed validation to validators, now a list of validators. Renamed isVisible to validate. Now show a warning box for each error message. [vincentfretin]

  • Internationalize the “of” separator, but the javascript is cached once it’s generated so the translation is the first language seen on the portal after a restart. [vincentfretin]

  • Internationalize the expected text of a step. [vincentfretin]

  • Don’t disable button, input, textarea, select. The user needs to fill out the “remaining fields” and upload an image for example. [vincentfretin]

  • Rename IManageTourUtility to ITourManager. [vincentfretin]

  • Add url to next tour at the end of a tour. [vincentfretin]

  • Add basic step validations: isAnonymous and isAuthenticated. [amleczko]

  • Refactor tour and step: add proper Interface schema for Tour and Step. Add validation checkings, write some coverage tests for that. [fdelia, amleczko]

  • Add doctests for meta registration. [fdelia, amleczko]

  • Add unittests for tour_manager. [fdelia, amleczko]

0.1 (released)

  • Initial release

Project details


Download files

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

Source Distribution

collective.amberjack.core-0.9.tar.gz (87.1 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