The release of DNN 7.1 brings about a major change in URL management within the DNN Platform. This is the version that incorporated much of the Url Master codebase, and introduced many new functions and features around URLs. These are all laid out as per the original iFinity Acquisition blog post that was written late last year.
This blog post is designed to provide a guide for those people who have been using the Url Master module and are now looking to upgrade their DNN site to DNN 7.1.
There are two choices for people in this category:
1. Continue to use the Url Master module to provide the URL functionality for their site
2. Switch over to using the new ‘Advanced’ URL functionality in the DNN Platform
The first thing to note is that a new version of Url Master has been released for using DNN 7.1. This is Url Master version 2.8. This contains important UI fixes related to the new jQuery version bundled with DNN 7.1, as well as a new feature to migrate settings and configuration from Url Master to the ‘Advanced’ URL mode of DNN 7.1.
Download Url Master 2.8 from the Downloads page, or from the DNN Store.
Regardless of your intention in terms of whether you fall into category (1) or (2) you should update your Url Master version to 2.8. This is a free upgrade for anyone who already has a license for any version from 2.0 through to 2.7. The upgrade can be done before or after you have upgraded your DNN site to 7.1.
Continuing to use the Url Master module with a DNN 7.1 Site
There are no issues to using the latest version of Url Master with DNN 7.1. The module works as normal, and, as before, all of the settings and configuration are held separately to the core DNN settings and configuration.
While the Url Master module will not be enhanced at all going forward, it is expected to remain compatible with DNN for the foreseeable future, and there is no plan to force existing users to stop using the Url Master module.
For people in this category, just upgrade to version 2.8 for the UI fixes and continue to use the Url Master module as normal.
This advice applies both to the DNN Platform (formerly DotNetNuke Community Edition) and those who are now using Evoq Content (formerly DotNetNuke Professional Edition).
If you are currently leveraging any of the Url Master custom module providers, you will have to stay with using Url Master until a 7.1 compatible version of your specific provider can be made. These providers are all open-source now, so it is possible to convert the Url Master module providers over to DNN 7.1 Extension URL providers if you have access to development resources.
Switching over from Url Master to the Advanced URL functionality in DNN 7.1
If you are planning to start using the new Advanced URL functionality in DNN 7.1, and you have an existing license for the Url Master module, there is a conversion path. This converts all of the Url Master redirects, portal alias settings and configuration settings over to the DNN format. The Advanced functionality is heavily based on the Url Master codebase, but they are not exactly the same. Many changes have been made in order to properly integrate the product into the DNN Core.
Therefore, I suggest that people test the switch-over carefully, and make sure that they have checked that redirects, third-party modules, and all other URL-related functionality works correctly. I strongly recommend that people do this in a ‘localhost’ test environment if they have the capability. If not, you must take a backup immediately prior to doing the conversion and be prepared to revert to the backed-up version of the site if the tests do not pass.
This process applies both to the DNN Platform (formerly DotNetNuke Community Edition) and those who have upgraded DotNetNuke Professional Edition to Evoq Content. While the DNN Platform has very few UI configuration locations for the Advanced URL Settings, the functionality is fully operational once the Url Master settings are converted.
Please note : you need to have a fully licensed version of Url Master in order to activate the conversion functionality, except if you are running on ‘localhost’, in which case it will work with an unlicensed version.
The actual process of conversion is very simple:
1. Upgrade your Url Master version to 2.8
2. Go to the Host->Friendly Url Settings page, and find the ‘Convert to DNN Advanced Urls’ button
3. This will load the Conversion Dialog:
Click ‘Start Conversion’ when you are ready to do the conversion.
4. The conversion process will run, and then show a summary of the changes made:
The figures in the boxes apply to the entire DNN installation. Check through the numbers to do a ‘sanity check’ and make sure that the figures seem correct. You can then close the dialog – the conversion is complete and your site is now activated in DNN ‘Advanced’ mode. Note that because this requires a web.config change, the site will automatically restart when the process is complete. The ‘close’ button triggers a page refresh to complete this process.
5. Check functionality on your site to make sure that the conversion has worked correctly. A brief set of tests should include:
- Basic site operation : all public URLs work as expected
- Edit Mode : does the Edit Mode functionality work as before?
- Any third-party module functionality : do blog posts, forum threads, e-commerce pages, photo galleries etc load up correctly?
- Login/Logoff functions : are you able to login and log out as normal?
- 404 Handling : if you had 404 handling configured, check that the 404 error handling works as expected.
- Admin/Host Urls : are you able to do basic functions like search for a user, save site settings, etc?
- Custom Urls : do custom redirects you had configured in Url Master still work OK? Are any custom URLs showing for pages correctly?
- Site Alias redirects : does the site respond correctly in terms of alias redirects (like example.com –> www.example.com)
- User Profile pages : if you had vanity user profile URLs activated, do they still work correctly? Are the profile pictures showing correctly, can users post updates, edit their profiles?
This is only a brief list to get you thinking; you should execute a comprehensive test plan to make sure the site is working as expected. Your SEO depends on making sure there are no surprises and everything is working as before. In the vast majority of cases, there should be no difference in behaviour or functionality, but it is imperative that this be tested and confirmed. While I have tested this functionality to make sure a like-for-like conversion of settings is working as expected, it is impossible to test the entire universe of Url Master installations.
6. When the conversion is finished, it’s up to you whether or not you uninstall the Url Master module. You may wish to keep it installed as a backup for the short term in case you find a problem with the conversion process. You can run the conversion process as many times as you like – it has been designed to be run repeatedly without causing any issue, to allow for iterative checks. Each time it is run, the settings are taken from the Url Master configuration and applied to the DNN install – thus any changes in the DNN installation may be overwritten each time you do this.
Note: Anyone using Custom Module Providers for the Url Master module – the settings specific to Custom Module Providers are not converted during this process. Any Custom Module providers will have to be replaced like-for-like with a DNN 7.1 specific Extension Url Provider which provides the same functionality, and the settings specific to that provider will have to be carried across.
Getting Support and Help
If you find any issues with the conversion process, please log them in the Url Master support forum.
This is the last scheduled release of the Url Master module, and it will removed from sale very soon. There has been a very long process in the making to get to this point in time, and I’m very happy that the ideas and concepts I developed and pushed over many years are now going out to a very large install base. It’s the end of the road for the Url Master module, but the start of a whole new URL journey for the DNN Platform, and there are even more innovations and improvements yet to come.