https://github.com/aaronsadleruk/our.umbraco.umbnav
Drag and drop menu editor for Umbraco V8, V9 and V10+
https://github.com/aaronsadleruk/our.umbraco.umbnav
hacktoberfest hacktoberfest2021 hacktoberfest2022 hacktoberfest2023 umbraco umbraco-packages umbraco-v10 umbraco-v8 umbraco-v9
Last synced: 6 months ago
JSON representation
Drag and drop menu editor for Umbraco V8, V9 and V10+
- Host: GitHub
- URL: https://github.com/aaronsadleruk/our.umbraco.umbnav
- Owner: AaronSadlerUK
- License: mit
- Created: 2021-06-04T13:18:18.000Z (almost 5 years ago)
- Default Branch: develop
- Last Pushed: 2024-11-15T09:17:10.000Z (over 1 year ago)
- Last Synced: 2025-09-14T08:18:03.011Z (6 months ago)
- Topics: hacktoberfest, hacktoberfest2021, hacktoberfest2022, hacktoberfest2023, umbraco, umbraco-packages, umbraco-v10, umbraco-v8, umbraco-v9
- Language: JavaScript
- Homepage:
- Size: 19.8 MB
- Stars: 11
- Watchers: 1
- Forks: 17
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# Umbraco UmbNav
[](https://www.nuget.org/packages/Our.Umbraco.UmbNav.Web)
UmbNav adds a drag and drop menu builder to the Umbraco V10 backoffice.
## Getting started
UmbNav V2.X only supports Umbraco 10+
Use UmbNav V1.X for Umbraco V8 and V9
### Features
- Set maximum child levels
- Hide menu items where `umbracoNaviHide` is true
- Auto expand the backoffice menu tree on hover
- Set the delay of the auto expand on hover (in ms)
- Add `noopener` to external links by clicking a checkbox
- Add `noreferrer` to external links by clicking a checkbox
- Auto add child nodes when rendering on the front end
- Allow menu items to be shown / hidden depending on member authentication status
- Add custom CSS classes to each menu item in the backoffice
- Display the property editor as full width in the back office (Hide the label)
- Add an image to a menu item
- TagHelper
- GetLinkHtml extension for Umbraco V8 and V9
- Add label items
### Installation
UmbNav is available from [NuGet](https://www.nuget.org/packages/Our.Umbraco.UmbNav.Web), or as a manual download directly from GitHub.
**The deprecation of using Ids between V1 and V2 is a breaking change, so if you are using Ids then you will required to rebuild your menu after upgrading**
#### NuGet package repository
To [install UI from NuGet](https://www.nuget.org/packages/Our.Umbraco.UmbNav.Web), run the following command in your instance of Visual Studio.
PM> Install-Package Our.Umbraco.UmbNav.Web
To [install Core from NuGet](https://www.nuget.org/packages/Our.Umbraco.UmbNav.Core), run the following command in your instance of Visual Studio.
PM> Install-Package Our.Umbraco.UmbNav.Core
To [install API from NuGet](https://www.nuget.org/packages/Our.Umbraco.UmbNav.Api), run the following command in your instance of Visual Studio.
PM> Install-Package Our.Umbraco.UmbNav.Api
## Umbraco Cloud Supported
UmbNav fully supports Umbraco Cloud including the content synchroniser, it has been fully tested transferring and restoring between environments.
### Documentation
After installing the package, you will have a new property editor called UmbNav in the Umbraco backoffice, typically this would get added to your sites "Site Settings" or "Home" node.
Check out the integration guide [integration guide](docs/integration-guide.md) to learn how to embed the package in your site.
### Screenshots
### Contribution guidelines
To raise a new bug, create an issue on the GitHub repository. To fix a bug or add new features, fork the repository and send a pull request with your changes. Feel free to add ideas to the repository's issues list if you would to discuss anything related to the package.
### Who do I talk to?
This project is maintained by [Aaron Sadler](https://aaronsadler.uk) and contributors. If you have any questions about the project please contact me through [Twitter](https://twitter.com/AaronSadlerUK), or by raising an issue on GitHub.
## License
Copyright © 2022 [UmbHost Limited](https://umbhost.net), and other contributors
Licensed under the MIT License.
As per the spirit of the MIT Licence, feel free to fork and do what you wish with the source code, all I ask is that if you find a bug or add a feature please create a to PR this repository.