Rename Culturally Insensitive Terms
This page lists configuration and code changes required to align with updated terminology in brXM version 15. Update your project to use the new terms as described below.
Bootstrap YAML Source Changes
Several configuration property names have changed. If your project’s bootstrap YAML sources override or append values to these properties, update the property names accordingly.
| Old configuration property | New configuration property |
|---|---|
/hippo:configuration/hippo:frontend/settings/@whitelisted.classes.for.package.resources | @allowed.classes.for.package.resources |
/hippo:configuration/hippo:frontend/cms/cms-static/editorManagerPlugin/cluster.options/@blackListedNodeTypeNames | @blockedNodeTypeNames |
Renamed web.xml Context Parameter Name
The CMS web application’s web.xml descriptor may include a context parameter for cross-origin request domains. The parameter name has changed. If your project uses this parameter, update it to the new name.
| Old Parameter Name | New Parameter Name |
|---|---|
accepted-origin-whitelist | accepted-origin-allowlist |
Renamed Configuration Files
The following configuration file has been renamed. If your project includes this file, update its name.
Note:
If the only change in your webfiles is this filename update, the change will not be detected during deployment on existing environments.
To work around this, either modify any other webfile in addition, or rename the repository node/webfiles/site/hst-whitelist.txtusing the console after deployment.
| Location | Old Filename | New Filename |
|---|---|---|
/repository-data/webfiles/src/main/resources/[site] | hst-whitelist.txt | hst-allowlist.txt |
Public Java Constant Changes
The following public Java constants have been renamed. If your project references any of these constants, update the references to use the new names.
| Class Name | Old Constant Name | New Constant Name |
|---|---|---|
org.hippoecm.frontend.plugins.cms.edit.EditorManagerPlugin | BLACK_LISTED_NODE_TYPE_NAMES | BLOCKED_NODE_TYPE_NAMES |
org.hippoecm.hst.core.container.WebFileValve | WHITE_LIST_CONTENT_PATH | ALLOWLIST_CONTENT_PATH |
org.hippoecm.frontend.Main | ACCEPTED_ORIGIN_WHITELIST | ACCEPTED_ORIGIN_ALLOWLIST |
Renamed Java Classes
The following public Java classes have new names. Update all references in your project code to use the new class names.
| Old Class Name | New Class Name |
|---|---|
org.hippoecm.frontend.WhitelistedClassesResourceGuard | org.hippoecm.frontend.AllowedClassesResourceGuard |
org.onehippo.cms7.services.htmlprocessor.filter.WhitelistHtmlFilter | org.onehippo.cms7.services.htmlprocessor.filter.AllowlistHtmlFilter |
org.hippoecm.hst.core.webfiles.WhitelistReader | org.hippoecm.hst.core.webfiles.AllowlistReader |
Renamed Methods on Public Classes
The following methods on public Java classes and interfaces have been renamed. Update all references in your project code to use the new method names.
| Class Name | Old Method Name | New Method Name |
|---|---|---|
org.hippoecm.repository.security.domain.QFacetRule | isHierarchicalWhiteListRule | isHierarchicalAllowlistRule |
org.onehippo.cms7.services.htmlprocessor.HtmlProcessorConfig | setWhitelistElements | setAllowlistElements |
org.onehippo.cms7.services.htmlprocessor.HtmlProcessorConfig | getWhitelistElements | getAllowlistElements |
org.hippoecm.hst.core.webfiles.WhitelistReader | getWhitelist | getAllowlist |