Example configurations¶

In this section you will find some examples how ext:replacer can be used.

Replace pattern only within tags using a regex¶

It is even possible to replace content just within a specific tag like a parameter.

Replace content within a paragraph

Code:

config.tx_replacer {
  search {
    10 = #(<p[^>]*>.*?)SEARCH(.*?<\/p>)#
    10.enable_regex = 1
  }

  replace {
    10 = $1REPLACE$2
  }
}

Original:

<p class="example">SEARCH</p>

Replaced by:

<p class="example">REPLACE</p>

Replace links for CDN usage¶

The example TypoScript replaces typo3temp, typo3conf, uploads and fileadmin occurrences with CDN links.

CDN example:

Code:

config.tx_replacer {
  search {
    10 = /"\/?(fileadmin|typo3temp|uploads)/
    10.enable_regex = 1
  }

  replace {
    10 = "https://cdn.tld/$1
  }
}

Original:

<script src="/typo3temp/assets/compressed/example-3b0e5471d7c4492019f42b9ea637ce4e.js"></script>

Replaced by:

<script src="https://cdn.tld/typo3temp/assets/compressed/example-3b0e5471d7c4492019f42b9ea637ce4e.js"></script>

Use stdWrap for search and replacement¶

You can use stdWrap functionality if you need a more dynamic way to search and replace content. The main step is equal with the basic configuration like above. You can also use a regex as search pattern and a stdWrap as replacement at the same time!

Use page title as replacement

Code:

config.tx_replacer {
  search {
    10 = ###TITLE###
  }

  replace {
    10.stdWrap.field = title
  }
}

Use page modification date as replacement

Code:

config.tx_replacer {
  search {
    10 = ###TIMESTAMP###
  }

  replace {
    # this will replace the timestamp marker in the template with generated value
    10.stdWrap {
    # format like 2017-05-31 09:08
    field = tstamp
    date = Y-m-d H:i
  }
}

More Example with page modification data

The following code can be used to wrap the search parameter with strong tag and the md5 hash of page title.

Code:

config.tx_replacer {
  search {
    10 = hash value to be replaced
  }

  replace {
    10.wrap = <strong>|</strong>
    #replacement will be md5 hash of current page title
    10.field = title
    10.hash = md5
  }
}

We can replace the value in the search key with hash value of the search key by configuring the current property of stdWrap. Here is an example below.

Code:

config.tx_replacer {
  search {
    10 = hash value to be replaced
    10.setContentToCurrent = 1
  }

  replace {
    # replacement will be md5 hash of search key - "hash value to be replaced"
    10.current = 1
    10.wrap = <strong>|</strong>
    10.hash = md5
  }
}

Take a look into the stdWrap documentation for more information.