Upgrade the Navigation widget from Feather 1.1.50.2

This article guides you through resolving potential issues when upgrading the Navigation widget of your Feather project to version 1.1.60.2.

Issue

You may experience problems when upgrading the Navigation widget if you meet the following conditions:

1. You are using Feather version 1.1.50.2.
2. You are using the Navigation widget on one or more pages.
3. You chose to display Custom selection of pages... in the Navigation widget.
4. You have upgraded Feather to version 1.1.60.2.

As a result, the Navigation widget is not displaying pages. In addition, when opening the designer, there are no selected pages under the option Custom selection of pages....

Reason

In Feather version 1.1.60.2, in the Telerik.Sitefinity.Frontend.Navigation.Mvc.Controllers.NavigationController class, the SerializedSelectedPageIds property is changed to SerializedSelectedPages. This causes a breaking change in the database.

Solution

To resolve the issue, you need to apply all required changes to the database by executing an upgrade code. Follow this procedure:

1. Download the UpgradeNavigation.zip file.
2. Unzip the content of the archive into your project's SitefinityWebApp directory.
3. Include the new files in the project and build it.
   NOTE: You must have a reference to the Telerik.Sitefinity.Frontend.Navigation.dll, located in the bin folder of the project.
4. Navigate to [your-site-URL address]/upgradenav.aspx.
5. Click the Upgrade button.

As a result, after executing the upgrade code, all navigation widgets work properly without any issues.