Update configuration

Any custom configuration of the Goto plugin should be copied to new 'document url' CMS services. The names and values of the configuration properties have not changed, only their location in the repository. The old Goto plugin configuration should be removed.

1. Open the console

2. Copy the properties of

   /hippo:configuration/hippo:workflows/goto/button/frontend:renderer/host.preview

   to

   /hippo:configuration/hippo:frontend/cms/cms-services/previewSiteDocumentUrlService

3. Copy the properties of

   /hippo:configuration/hippo:workflows/goto/button/frontend:renderer/host.live

   to

   /hippo:configuration/hippo:frontend/cms/cms-services/liveSiteDocumentUrlService

4. Remove the value 'goto' from the multi-string property 'workflow.categories' in these nodes:

   • /hippo:configuration/hippo:frontend/cms/cms-preview/workflowPlugin
   • /hippo:configuration/hippo:frontend/cms/cms-compare/workflowPlugin

5. Delete the node

   /hippo:configuration/hippo:workflows/goto

6. Save the changes

The 'Website actions' menu in the document editor of the CMS should now be gone. The new 'View' menu should use the copied configuration (e.g. open documents in the correct preview and live environment).

 Note: if the configuration of the goto plugin was part of your project content (e.g. loaded by some hippoecm-extension.xml file), you should mimic the manual 'copy' actions described above in there as well. The wiki contains an example of how to easily override the existing configuration using the new advanced XML import.

Remove the plugin from your project

The Goto plugin should be removed from your project as well.

1. Replace configuration of the goto plugin in your hippoecm-extension.xml files with configuration for the new document url services (i.e. mimic in code the manual 'copy' actions described above).

2. Delete the following artifacts from your Maven poms:

   • org.onehippo.forge:goto-addon-frontend
   • org.onehippo.forge:goto-addon-repository
   • org.onehippo.forge:goto-hst-redirect-filter

   Warning: do NOT remove the artifact org.onehippo.cms7:hippo-cms-gotolink, which renders the unrelated 'To the documents' button in the CMS.

3. Remove the following snippets from the web.xml file of your site:

     <filter>
       <filter-name>HstUuidToUrlRedirectFilter</filter-name>
       <filter-class>org.onehippo.forge.go.container.HstUuidToUrlRedirectFilter</filter-class>
     </filter>
   

   and

     <filter-mapping>
       <filter-name>HstUuidToUrlRedirectFilter</filter-name>
       <url-pattern>/previewfromcms</url-pattern>
       <dispatcher>REQUEST</dispatcher>
     </filter-mapping>
   

   (HST >= 2.21.01 recognizes /previewfromcms without the need for a separate filter)