devot:eeDevoted to ExpressionEngine

This plugin works pretty much the same as the php str_replace() function:
http://www.php.net/manual/en/function.str-replace.php and the preg_replace() function:
http://www.php.net/manual/en/function.preg-replace.php

ExpressionEngine strips the white space from the beginning and the end of each parameter. Because of this,
if you want to replace something with a space, use the string “:SPACE:” instead.
If you want to use a double quote in a parameter value, use the string “:QUOTE:” instead.
If you want to use slash in a parameter value, use the string “:SLASH:” instead.
If you want to use left curly brace in a parameter value, use the string “:LD:” instead.
If you want to use right curly brace in a parameter value, use the string “:RD:” instead.

PARAMETERS

1) find - Required. Allows you to specify what strings should be found. You can specify
several strings using pipeline character.

2) replace - Optional. Allows you to specify what strings should replace the strings found.
You can specify several strings using pipeline character. In case you leave this parameter undefined,
the strings found will be replaced with empty string.

3) multiple - Optional. Allows you to specify if you seach for several strings (value “yes”), or
for just one string (value “no”). Default is “no”.

4) casesensitive - Optional. Allows you to specify if you want to do casesensitive replace (value “yes”)
or caseinsensitive replace (value “no”). Default is “yes”.

5) regex - Optional. Allows you to specify regular expression. The value of this param must be “yes” in case the value
of the param “find” is a regular expression.

6) regex_limit - Optional. The maximum possible of regex replacements. Default value is -1 (no limit).

VARIABLE PAIRS

{replace_area}{/replace_area} - Optional. allows you to specify area in which the plugin should do find-replace
operations.

Each parameter can be used not only inside exp:replace_plus tag but also inside {replace_area}
variable pair. In case parameter is defined both inside exp:replace_plus tag and inside {replace_area}
variable pair, the value of the latter overrides the value of the former.

{replace_area}{/replace_area} can be nested. This feature can be handy in cases initial find-replace produces
unwanted results. Those unwanted results can be corrected by wrapping one variable pair inside another pair having
different “find” and “replace” parameters.

EXAMPLES

# Replace A with B:

{exp:replace_plus find="you" replace="we"}
  text you want processed
{/exp:replace_plus}

Result: text we want processed

# Replace A with B inside {replace_area} and {/replace_area} variable pair:

{exp:replace_plus find="you" replace="we"}
text you want processed
{replace_area}
text you want processed
{/replace_area}
text you want processed
{/exp:replace_plus}

Result:

text you want processed
text we want processed
text you want processed

# Replace A with B inside several {replace_area}{/replace_area} variable pairs:

{exp:replace_plus}
text you want processed
{replace_area find="you" replace="we"}
text you want processed
{/replace_area}
{replace_area find="you" replace="I"}
text you want processed
{/replace_area}
text you want processed
{/exp:replace_plus}

Result:

text you want processed
text we want processed
text I want processed
text you want processed

# Replace A with B inside {replace_area}{/replace_area} variable pair and
correct unwanted results by wrapping it within another {replace_area}{/replace_area} variable pair:

{exp:replace_plus}
text you want processed
{replace_area find=":SPACE:>:SPACE:" replace=">"}
{replace_area find="<|>" replace="<|>"}
{if total results > 0}
<p>text you want processed</p>
{/if}
{/replace_area}
{/replace_area}
text you want processed
{/exp:replace_plus}

Result:

text you want processed
<p>text you want processed</p>
text you want processed

# Replace A with a space:

{exp:replace_plus find="o" replace=":SPACE:"}
  text you want processed
{/exp:replace_plus}

Result:
text y u want pr cessed

# Replace a space with nothing

{exp:replace_plus find=":SPACE:"}
  text you want processed
{/exp:replace_plus}

Result:

textyouwantprocessed

# Replace A, B and C with D:

{exp:replace_plus find="a|e|i|o|u" replace="X" multiple="yes"}
  text you want processed
{/exp:replace_plus}

Result:

tXxt yXX wXnt prXcXssXd

# Replace A, B and C with X, Y and Z:

{exp:replace_plus find="text|you|want" replace="words|we|have" multiple="yes"}
  text you want processed
{/exp:replace_plus}

Result:

words we have processed

# Regular Expression find and replace:

{exp:replace_plus find="\w+" replace="*" regex="yes"}
  text you want processed
{/exp:replace_plus}

Result:

* * * *

# Regular Expression find and replace with backreference:

{exp:replace_plus find="]*href=QUOTE(.+)QUOTE[^>]*>(.*)<\/a>" replace="$2 ($1)" regex="yes"}
  text you want processed
{/exp:replace_plus}

Result:

text (http://www.foo.com/) you want processed (http://www.bar.com/)

Note: if you want to replace something with nothing, best is to omit the replace parameter altogether.
If you want to find multiple strings, always use the multiple=“yes” parameter, or else it will search
for the literal string, including vertical bars. The multiple parameter has no effect when using a
regular expression find and replace.

This function is case sensitive by default. Use the parameter casesensitive=“no” to ignore case, both
for a normal as for a regular expression find and replace.

When using regex=“yes” it is recommended that you set your Debug Preference (Admin > System Preferences
> Output and Debugging Preferences) to 1, so Super Admins can make sure their regular expressions
aren’t generating server errors.