Skip to content
This repository has been archived by the owner on Jul 22, 2021. It is now read-only.

Latest commit

 

History

History
94 lines (50 loc) · 4.9 KB

README.md

File metadata and controls

94 lines (50 loc) · 4.9 KB

Umbraco MeganavV8

No longer maintained

Please upgrade to UmbNav-V8

Getting started

This package is supported on Umbraco 8.6+.

Installation

MeganavV8 is available from Our Umbraco, NuGet, or as a manual download directly from GitHub.

NuGet package repository

To install UI from NuGet, run the following command in your instance of Visual Studio.

PM> Install-Package AaronSadler.MegaNavV8.Web

To install Core from NuGet, run the following command in your instance of Visual Studio.

PM> Install-Package AaronSadler.MegaNavV8.Core

To install api from NuGet, run the following command in your instance of Visual Studio.

PM> Install-Package AaronSadler.MegaNavV8.Api

Umbraco Cloud Supported

MegaNavV8 fully supports Umbraco Cloud including the content synchroniser,it has been fully tested transferring and restoring between environments.

Configuration

Since v8.2.0 it is possible to disable the Umbraco Cloud content sync, simply add the relevant AppSetting below into your Web.Config

To fully disable sync, making the transfer and restore options redundant, simple add the following AppSetting (true | false)

<add key="DisableUmbracoCloudSync" value="true" />

To partially disable sync so that the menu is transferred but not the dependencies, use the below AppSetting (true | false)

<add key="DisableUmbracoCloudDependencySync" value="true" />

Usage

After installing the package, you will have a new property editor called MegaNavV8 in the Umbraco backoffice.

Here you can configure the "Max depth" of the navigation - the maximum number of levels deep at which an editor can place nav items. You also have the option to prevent nav items where the umbracoNaviHide property has been set from rendering on the front-end - these items will still appear in the backoffice but not on your website, you can still edit or change them as you wish. By default both of these settings are left unset.

Now in V8 you can set the querystring / anchor in a seperate input box the same way as the MultiUrlPicker.

Now your Data Type is ready, we need to add it to a Document Type. This is done in the usual way - you will find Meganav appears in the "pickers" section when selecting a property to add.

Meganav Property Editor

Wow! That was easy! You now have a shiny new navigation picker setup for your content editors to enjoy.

In the backoffice, the design of Meganav closely follows the other pickers in Umbraco to ensure your editor's experience is as familiar as possible.

Meganav

Click and drag an item to change it's position within the navigation; drop it wherever you choose. Unpublished items will appear faded out and will not show on the front-end of the website. If you have the "Remove NaviHide Items" setting enabled, any items where the umbracoNaviHide property has been set on the selected content node will appear with a red outline in the backoffice and will also not show on the front-end.

Meganav Edit Item

When editing a navigation item you have the flexibility to modify how the link behaves on the front-end. Entering text into the "Link Title" field will display in place of the select content's name. Changing the "Target" property alters how the link opens when clicked; either in the current window, a new tab, or a new browser window.

Integration

Meganav was designed to be as clean and simple for developers as it is for content editors.

Check out the integration guide to learn how to embed the package in your site.

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 and contributors. If you have any questions about the project please contact me through Twitter, or by raising an issue on GitHub.

Contributors

A special #h5yr to the orignal author

License

Copyright © 2020 Callum Whyte & Aaron Sadler, and other contributors

Licensed under the MIT License.