OpenWGA 7.1 - Updating to OpenWGA 7.1

Tasks after the update

Ensure title path URLs in desired mode

Title path URLs on OpenWGA apps are URLs to content documents that contain the documents title and also the titles of parent documents in the URL, for the sake of better readability and search engine optimization. Each app can choose to use title path URLs on its configuration in OpenWGA admin client.

Title path URLs can be displayed in two modes:

  • In mode "Include document keys" which adds the key of the addressed document to the end of the URL. The key is then used to lookup the document. For example:
    • https://www.openwga.com/home/customers~ff80808127b9f0890127e2516d2d3014.en.html
  • In plain title mode, where the URL only consists of the titles. Here the titles themselves are used to lookup the document. For example:
    • https://www.openwga.com/home/customers.en.html

Generally OpenWGA recommends using the newer mode "Include document keys", as it is more reliable and performant. It is robust against title changes and makes it easy for OpenWGA to lookup the document whereas the plain title mode requires OpenWGA to do a complicated evaluation of the titles from the URL against the titles from the content documents. It must fail once a title gets changed after the URLs creation.

Because of this the mode "Include document keys" becomes default with OpenWGA 7.1.

If you however want your apps to still generate title path URLs in in plain title mode for any reason you should ensure that the mode "Include document keys" is disabled:

  • Open the web app configuration of each app in OpenWGA admin client
  • In section "Publishing settings" ensure that option "Title path URLs: Include document keys" is visible and deactivated.
  • If it is not displayed or activated edit the apps configuration. The option will automatically be added if not yet available. Uncheck it and save your settings.
Note: This setting only influences how URLs are generated by OpenWGA. It does not influence which URL types are parsed. Even with mode "Include document keys" enabled OpenWGA will be able to parse title path URLs that were generated without this mode and provide the respective pages as usual. It is not necessary to keep the plain title mode just in order to keep old URLs valid.