Keyword replacements can be modified using a variety of keyword modifiers to further configure the returned values. These modifiers are represented as extensions added to existing standard keyword replacements, denoted by a caret (^) character followed by the modifier keyword and any necessary modifier  arguments.  For example,  if the keyword replacement %asset_contents^maxwords:10% was used, the first ten words of the body of the asset will be displayed.

Multiple modifiers can be used on a single keyword replacement, separated by the caret character. For example, %item_price^subtract:2^multiply:10%. This keyword replacement would subtract two from the item price value before multiplying the new value by ten.

You can use keyword replacements as modifier arguments using the special replace_keywords modifier. For more information, refer to the Using Keyword Replacements as Argument Values section in this chapter.

Keyword modifiers are also supported on the keyword replacements available for use within Simple Edit Layouts. For more information, refer to the Simple Edit Layout chapter of the Simple Edit Layouts manual.

Available Keyword Modifiers

The keyword modifiers available are as follows:

[
  {"asset_name":"About Us","asset_type":"Standard Page"},
  {"asset_name":"Services","asset_type":"Standard Page"},
  {"asset_name":"Products","asset_type":"Standard Page"}
]    

Array Based Modifiers

Using array based modifiers directly on a keyword, such as ^index and ^count, only work on keyword values that actually produce an array or JSON object to start with.

If you are using these modifiers on array or JSON strings, such as JSON stored in a metadata text field, you must first use the ^json_decode modifier to convert the string to a JSON object:

%asset_metadata_details^json_decode^index:address^index:city%

Using Regular Expression in Modifiers

When using regular expression values on the replace and contains keyword modifiers, the following characters are supported: \s (whitespace characters) [a-z A-Z] [0-9] [|~!@#$*={}+;.,'"]

Example: % asset_metadata_foo^replace:(\s):_% (This will remove any white space, as understood by PHP, and replace them with an underscore).

The following characters need to be escaped with a backslash: [ ] - ( ) :

The following characters needs to be double escaped with two backslashes: ^ e.g. ^replace:\\^:caret

Example: % asset_metadata_foo^replace:[~!@#$\(\)*\-={}\[\]+;.,'"]:_% (replaces any of the character provided with an underscore).

The following characters are not supported in regex on this keyword modifier: & (is converted to &amp;) < (is converted to &lt;) > (is converted to &gt;)

The following characters are used within the Squiz Matrix keyword system and, as such, are also not supported in regex on this keyword modifier: %

Pre Keyword Evaluation Modifiers

Reserved Chars

%asset_name^eq:\^:caret:other%

%asset_name^replace:\\^:caret%

%asset_name^replace:\::colon%

Using Keyword Replacement Values as Modifier Arguments

%asset_metadata_show_price^replace_keywords:eq:1:{asset_metadata_price}%

%asset_name^replace_keywords:replace:{asset_name^maxchars:1}:ABC%

 %asset_metadata_show_price^eq:1:{asset_metadata_price}%

 %asset_metadata_show_price^eq:1:\{asset_metadata_price\}%