volto-bookmarks

Plone (Volto) add-on

Features

Add and manage bookmarks of pages and search and searchkit queries.

Bookmarks are grouped by the value of a selectable content type field.

Getting started

There are two options:

• Buttons in toolbar
• Buttons somewhere else

Installation

• Provide the necessary REST API endpoints for your Plone backend by installing collective.bookmarks

• Remember to install souper in Plone backend control panel.

• Install this Plone (Volto) add-on @plone-collective/volto-bookmarks. See Volto docs for instructions.

Integration of the two bookmark buttons

Option 1 - buttons in toolbar

This requires Volto >= 16.10.0 with a pluggable toolbar.

Include bookmarking in your Volto project by integrating the component Bookmarking. This component adds two buttons to the toolbar: one for toggling the bookmark of the current page and one for displaying a menu with a list of bookmarks.

config.js:

import { Bookmarking } from '@plone-collective/volto-bookmarks/components';

import '@plone/volto/config';

export default function applyConfig(config) {
  config.settings.appExtras = [
    ...config.settings.appExtras,
    {
      match: '/',
      component: Bookmarking,
    },
  ];
  return config;
}

Option 2 - buttons not in toolbar, but somewhere else

Add the two buttons to components of your choice:

import { ShowBookmarksContentButton } from '@plone-collective/volto-bookmarks/components';

    <ShowBookmarksContentButton />

import { ToggleBookmarkButton } from '@plone-collective/volto-bookmarks/components';

    <ToggleBookmarkButton />

Further configuration for both options

Add a mapping for bookmark groups labels and the name of the field for grouping bookmarks list.

config.settings.bookmarks = {
  ...config.settings.bookmarks,
  bookmarkgroupmapping: {
    manual: 'Manuals and HowTos',
    releasenote: 'Release Notes',
    search: 'Search', // id of search page
    'search-in-news': 'Search in News', // id of another search page
    default_nogroup: 'Miscellaneous',
  },
  bookmarkgroupfield: 'type_title',
};

Add a mapping for search filters:

  config.settings.bookmarks.filtermapping = {
    facet_fields: {
      'News Item': 'Nachricht',
      Document: 'Seite',
      Event: 'Veranstaltung',
    },
    search_sections: {
      others: 'Website',
      nachrichten: 'Nachrichten',
    },
  };

Copyright and License

Author Katja Süss, Rohberg, @ksuess https://www.rohberg.ch

Copyright (c) 2023 Plone Foundation

See LICENSE.md for details.