What's New in Cascade CMS

New Velocity methods

May 02, 2022

New Property Tool methods

We've added several new class type utility methods to check whether an Object is a given type:

• isString
• isList
• isMap
• isArray
• isSet
• isIterable

Example:

$_PropertyTool.isIterable($category.selectedFieldItems)
## Expected output: true

New List Tool method

A new List Tool method allows you to randomize the order of a List. Example:

$_ListTool.shuffle(["A","B","C"])
## Example output: [B, A, C]

New Number Tool method

A new Number Tool method allows you to test if an Object is a number. Example:

$_NumberTool.isNumeric("3")
## Expected output: true

New Serializer Tool method

A new Serializer Tool method allows you to convert a Map to a JSON String. Example:

#set ($a = {"test": "testing", "array": [1, 2, 3]})
$_SerializerTool.toJson($a)
## Expected output:
{"test":"testing","array":[1,2,3]}

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

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.