What's New in Cascade CMS

New link rewriting options

Oct 22, 2020

We've introduced new link rewriting options that can be configured under Site Settings. Choose whether internal links within the same site are written as absolute, relative, or site relative links by default.

These settings can be overridden at the asset level which replaces the "Maintain site-relative links in content" option.

User API Keys

Aug 14, 2020

New user API keys provide a secure way to call Web Services/REST API operations from external scripts and applications. Your API key is unique to your user account and can be used to authenticate with Web Services scripts and applications in place of a traditional username and password.

Once generated, you can regenerate or revoke your API key at any time. Read more about API keys in our knowledgebase: User and Account Settings

Image file dimensions in API and Index Block XML

Aug 14, 2020

Image file dimensions are now available via Cascade API and Index Blocks. If applicable, an image file's height and width will be included in Index Block XML or can be accessed with a new dimensions property when working with an API object.

Having image dimensions available dynamically can be useful when creating responsive images with a srcset attribute.

For more information, check out our API changelog.

New Velocity tools and methods

Aug 14, 2020

New Regex Tool

A new Regex Tool allows you to compile regular expressions for comparison and matching use. Example:

$_RegexTool.compile("^[a-zA-Z0-9]*$")

#set ($text = "A string to search for links containing the pattern https:// .")
#set ($patternString = ".*https://.*")
#set ($pattern = $_RegexTool.compile($patternString))
#set ($matcher = $pattern.matcher($text))
#set ($matches = $matcher.matches())
## Expected output: true

New String Tool methods

If you need to create unique IDs for elements such as element id attributes, you can now generate universally unique identifiers with the .generateUUID() method. Example:

$_StringTool.generateUUID()
## Sample output: 29ecf0f3-7db4-41b5-94a2-3e170338c3b5

We've also added a new method to build Strings. Example:

#set ($stringBuilder = $_StringTool.getStringBuilder())
#set ($_void = $stringBuilder.append("foo"))
#set ($_void = $stringBuilder.append("+"))
#set ($_void = $stringBuilder.append("bar"))
$stringBuilder
## Sample output: foo+bar

New Escape Tool methods

We've added several new methods to unescape HTML, JavaScript, and XML markup. Examples:

$_EscapeTool.unescapeHtml('Here is a String with an escaped ampersand (&).')
## Expected output: Here is a String with an escaped ampersand (&).

$_EscapeTool.unescapeJavaScript('if (i === \"foo\")')
## Expected output: if (i === "foo").

$_EscapeTool.unescapeHtml('<foo>bar</foo>')
## Expected output: <foo>bar</foo>

For more information about tools and methods available in Velocity, see our Velocity Tools page.