https://github.com/backdrop-contrib/book_menus
Allows a user to manage book navigation via the normal Backdrop CMS admin menu interface.
https://github.com/backdrop-contrib/book_menus
backdrop backdropcms book books cms menu menus
Last synced: 5 months ago
JSON representation
Allows a user to manage book navigation via the normal Backdrop CMS admin menu interface.
- Host: GitHub
- URL: https://github.com/backdrop-contrib/book_menus
- Owner: backdrop-contrib
- License: gpl-2.0
- Created: 2022-11-22T20:24:37.000Z (about 3 years ago)
- Default Branch: 1.x-1.x
- Last Pushed: 2024-12-27T11:40:25.000Z (about 1 year ago)
- Last Synced: 2025-04-05T05:27:07.343Z (10 months ago)
- Topics: backdrop, backdropcms, book, books, cms, menu, menus
- Homepage: https://backdropcms.org/project/book_menus
- Size: 29.3 KB
- Stars: 1
- Watchers: 9
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Book Menus
Book Menus allows you to set books as normal Backdrop CMS menus. This means
they will be listed in admin/structure/menu, and have all of the additional
functionality that comes along with it.
This will allow you to use menu manipulation modules. For example, the initial
development was due to wanting a more flexible book menu structure with titles
or sections that are not necessarily links. This can be done using Book Menus
along with [Special Menu Items](https://github.com/backdrop-contrib/special_menu_items).
## Requirements
This module requires that the following modules are also enabled:
- Book - part of Core, disabled by default.
- Menu - part of Core, enabled by default.
## Installation
- Install this module using the official Backdrop CMS instructions at
https://docs.backdropcms.org/documentation/extend-with-modules.
- To manage the menu, the user must have the `administer menus` permission in
addition to the book permissions.
## Configuration
- Create some books.
- Navigate to `admin/content/book/settings` and chose the Book Menus.
- On the book list page, the edit operation will redirect to the normal menu.
- You can also see the menu at `admin/structure/menu`.
- Modify the menu as required.
### Blocks
This menu provides a block, *Book Menu Navigation*, that is similar in
functionality to core `book.module` with the *show block only on book pages*
setting.
However, the main difference it that it will always show the full tree. This
was necessary as non-book menu links and #below items weren't getting rendered
as core book.module passes the book menu item to menu_tree_output.
You can still use the core `book.module` Book Navigation block, but on Book Menus
it will likely be the *Book Menus Navigation* block you're looking for.
### Notes
- As this module intercepts the `admin/content/book/*` page, other book
manipulation module may not work with it.
## Issues
Bugs and Feature Requests should be reported in the Issue Queue:
https://github.com/backdrop-contrib/book_menus/issues.
## Current Maintainers
- [Martin Price](https://github.com/yorkshire-pudding) - [System Horizons Ltd](https://www.systemhorizons.co.uk)
## Credits
- Ported to Backdrop CMS by [Martin Price](https://github.com/yorkshire-pudding) - [System Horizons Ltd](https://www.systemhorizons.co.uk)
- Created for Drupal by [Sam K Hall](https://github.com/skh-)
## License
This project is GPL v2 software.
See the LICENSE.txt file in this directory for complete text.