The attached add-on files may be out of date. Please visit Devot-ee for the latest versions.
Hi,
I have tweaked Lodewijk Schutte’s Find and Replace plugin. The result is a new plugin called ” Find and Replace Plus”.
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. Also in a parameter values use aliases for some other characters:
“:QUOTE:” for double quote, “:SLASH:” for slash, “:LD:” for left curly brace and “:RD:” right curly brace.
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.
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="<a[^>]*href=QUOTE(.+)QUOTE[^>]*>(.*)<\/a>" replace="$2 ($1)" regex="yes"}
<a href="http://www.foo.com/">text</a> you want <a href="http://www.bar.com/">processed</a>
{/exp:replace_plus}
Result: text (http://www.foo.com/) you want processed (http://www.bar.com/)
Note: 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.
Changelog:
-1.3 // Variable pair {replace_area_start}{replace_area_end} changed into {replace_area}{/replace_area}. Added support for parameters inside {replace_area}{/replace_area} variable pair. Added support for nesting of {replace_area}{/replace_area}variable pairs.
-1.2 // Added more aliases for characters which are illegal or problematic to use inside parameters’ values.
-1.1 // Added support for multiple {replace_area_start}{replace_area_end} variable pairs.
-1.0 // Initial release.
Continued in the next post
Seems to be working now. Thanks again.
