Skip to main content

Provides a REST endpoint to query the site's navigation tree

Project description

http://img.shields.io/pypi/v/collective.restapi.navigationtree.svg https://img.shields.io/travis/collective/collective.restapi.navigationtree/master.svg https://img.shields.io/coveralls/collective/collective.restapi.navigationtree/master.svg

This Plone plugin provides a REST endpoint to query the site’s navigation tree. The endpoint name is @navigationtree, and can be considered an extension to plone.restapi’s @navigation endpoint, since the latter only returns the top level navigation menu items. collective.restapi.navigationtree depends on the webcouturier.dropdownmenu plugin to build the navigation tree, and honors the same configuration settings as webcouturier.dropdownmenu. Thus, the maximum depth of the tree can be set in the webcouturier.dropdownmenu configlet.

Tested on Plone 4.3, 5.0 and 5.1 with Archetypes and Dexterity.

Features

  • Simply GET @navigationtree

  • Extends the @navigation endpoint of plone.restapi by building a full navigation tree of the site, instead of limiting itself to just the top level navigation menu.

  • Depends on webcouturier.dropdownmenu, thus is ideal for sites that already use this plugin for their navigation menu.

  • Honors all the configuration settings in Plone’s _Navigation_ control panel.

  • Honors all the configuration settings in @@dropdown-controlpanel.

  • In particular, you can set the depth of the navigation tree in webcouturier.dropdownmenu’s configlet.

Examples

Getting the navigation tree:

GET /plone/@navigationtree HTTP/1.1
Accept: application/json
Authorization: Basic YWRtaW46c2VjcmV0

(Authorization is optional.)

Example response:

{
    "@id": "http://localhost:8080/Plone/@navigationtree",
    "items": [
        {
            "@id": "http://localhost:8080/Plone",
            "description": "",
            "items": "",
            "title": "Home"
        },
        {
            "@id": "http://localhost:8080/Plone/news",
            "description": "Site News",
            "items": [
                {
                    "@id": "http://localhost:8080/Plone/news/some-news",
                    "description": "",
                    "title": "Some News"
                }
            ],
            "title": "News"
        },
        {
            "@id": "http://localhost:8080/Plone/events",
            "description": "Site Events",
            "items": [],
            "title": "Events"
        },
        {
            "@id": "http://localhost:8080/Plone/Members",
            "description": "Site Users",
            "items": [],
            "title": "Users"
        }
    ]
}

Installation

Install collective.restapi.navigationtree by adding it to your buildout:

[buildout]

...

eggs =
    collective.restapi.navigationtree

and then running bin/buildout. This will automatically install webcouturier.dropdownmenu and plone.restapi, so you should pin the versions of these add-ons according to the version of Plone you are running.

Contribute

Support

If you are having issues, please let us know in the issue tracker.

License

The project is licensed under the GPLv2.

Contributors

Changelog

1.0a1 (2018-03-12)

  • Initial release. [fulv]

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.restapi.navigationtree-1.0a1.tar.gz (11.5 kB view details)

Uploaded Source

File details

Details for the file collective.restapi.navigationtree-1.0a1.tar.gz.

File metadata

File hashes

Hashes for collective.restapi.navigationtree-1.0a1.tar.gz
Algorithm Hash digest
SHA256 805eff65f58fd1ac3d20997b7fc5a374664c92c7b13659ab5df5993c7e5bc05b
MD5 395fbeb1efbedc2c3cd5043bb6f13580
BLAKE2b-256 ff3606e1174a6934983f8a525c5e397cefa001626ad99a7dc3ff6a1ff7eececa

See more details on using hashes here.

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