ReReplacer - search and replace for Joomla! | NoNumber!

Web Design •
Web Development •
Joomla! Extensions •

Home » Free Joomla! Extensions » ReReplacer

...search and replace in Joomla!

component

plugin

version 2.6.5
Licence: GNU/GPL

GNU/GPL

With ReReplacer you can replace whatever you want in your entire site.

If you use ReReplacer, please post a rating and a review at the Joomla! Extensions Directory.

Description

With ReReplacer you can replace whatever you want in your entire site.

It can work on the entire output of your site, so you can also do replacements in things like the meta tags.

Regular Expressions

You have the ability to use powerful regular expressions to search and replace. This opens up endless possibilities, You can do virtually everything with ReReplacer.

For documentation on regular expressions, ReReplacer comes with a Regular Expressions Cheat Sheet (under the Syntax Help button). For more on regular expressions, I recommend Regular-Expressions.info

Handle with care!

Because you can replace/remove all kinds of things, you can potentially break your site. It is not wise replacing words like 'html', 'body' or (parts of) words that are used in inline scripts.

However, the cool thing is: all replacements are not permanent. So when you turn off the plugin or remove the replacement, your website is back to the original state.

Also, there are some nifty features enabling you to replace stuff without replacing in fragile areas like in tags and outside the html body.

Examples

You can download an Example Pack with a couple of ready to use examples. You can change these to your liking and add as many new items as you want.

Some idea's where you can use ReReplacer for:

Filter bad words on your site (Example Pack 1).
Replace smiley tags by images ( [:wink:] becomes ) (Example Pack 1).
Temporarily hide text from your website, without actually removing it (Example Pack 1).
Remove redundant whitespace from your code, making your website load faster (Example Pack 1).
Use abbreviations in your content and replace them with the full text (J! becomes Joomla!).
Quickly place whole blocks of text by only typing one word. Like you can use [stats] and replace it with a piece of Google Statistics code. Or [footer] to put a fixed bit of text under articles. You can change the replacement in one place (in ReReplacer) and your whole website is updated!
Create your own custom tags ([mytag]some text[/mytag] becomes some text).
Tweak the output of Joomla! without changing the core files.
etc...

Example codes

Custom Remove Tag
Everything between is removed from the final output.
Search	\{remove\}.*?\{/remove\}
Replace	leave empty
Settings	Regular Expressions: yes

Add links to words
Changes words with a certain syntax and gives them a link. In this case, all words that end with _profile are linked to a profile link. And _profile is stripped from the word.
Search	([a-zA-Z0-9_-]*)_profile
Replace	<a href="/profiles/\1">\1</a>
Settings	Regular Expressions: yes

If you have or need any more examples, please e-mail me!

Syntax

Here is an overview of extra codes you can/should use in different situations.

Syntax	Description	Input example	Output example
[[comma]]	Use instead of a comma. Use normal comma's to create lists.	[[comma]]	,
[[space]]	Use for leading or trailing spaces (otherwise they will get stripped).	[[space]]
[[counter]]	This places the number of the occurrence. If your search is found, say, 4 times, the count will show respectively 1 to 4.	[[counter]]	1
[[random:...-...]]	This places a random number within the given range.	[[random:0-100]]	70
[[date:...]]	Date using php strftime() format.	[[date:%A, %d %B %Y]]	Wednesday, 17 February 2010
[[user:id]]	The id number of the user (returns empty if not logged in)	[[user:id]]	123
[[user:username]]	The login name of the user (returns empty if not logged in)	[[user:username]]	peter
[[user:name]]	The name of the user (returns empty if not logged in)	[[user:name]]	Peter van Westen

For documentation on regular expressions, ReReplacer comes with a Regular Expressions Cheat Sheet (under the Syntax Help button). For more on regular expressions, I recommend Regular-Expressions.info

Screenshots

Admin: ReReplacer - items list

Admin: ReReplacer - new item

Admin: ReReplacer system plugin

Installing

The ReReplacer package installs/updates all necessary extensions, like components, module and plugins. (If the package contains plugins, they will be published after install, so you won't have to do that by hand.)

The package makes use of a special installer. This checks to see if it needs to install the extension(s) or update them. So you can just run this package through the Joomla installer without having to uninstall the older version.

You might experience problems during install for certain setups. In that case you can install the extension(s) manually. Please read the INSTALL.txt in the package...

If you run into any problems, please report this on the forum or let me know via the contact form.

Need more help?

If you need more help, please take a look in the forum.
If you can't find your answer there, please post your question. I am very willing to help!

>> NoNumber! Forum

Changelog

  + = Added    ! = Removed    ^ = Changed    # = Fixed
 
17-Feb-2010 : v2.6.5
  ^ Optimized some code
  ! Removed show/hide option for Syntax Help (now always shows)
  # Fixed some stuff in the Syntax Help text
  # Fixed issue with data tags also being handled outside replacement
  # Fixed issue with ordering columns not working
  # Fixed issue with errors about registry for php 5.0.5
  # Fixed issue with error about redeclaring clone function on php 4
 
09-Feb-2010 : v2.6.4
  # Fixed issue with wrong database table being created on new installation in v2.6.3
 
08-Feb-2010 : v2.6.3
  + Added assignment to PHP evaluation
  + Added tooltips to assignment settings
  # Fixed issue with slashes not being removed from text searches
 
30-Jan-2010 : v2.6.2 (sorry for yet another update)
  # Fixed issue with search areas not showing (also causing problems on saving items)
 
30-Jan-2010 : v2.6.1
  ^ Changed layout of item edit screen
  # Fixed issue with database error on some setups (regarding licenses)
  # Fixes syntax of older database records
 
29-Jan-2010 : v2.6.0
  + Added extra variables to use in replacement (date, user details, random number)
  + Added more assignment filters (components, date, url, users, k2 categories)
  + Added option to choose AND / OR method of assignments matching
  + Added support for APLite admin template
  + Added Commercial License Code support
  + Added option to set publish state of imported items
  ^ Improved some code to make it lighter
  ^ Reduced number of database queries
  ^ Improved syntax help text
  ^ Renamed limits to assignments (also in params)
  ^ Only 1 'Else' replace field instead of 1 per assignment group
  ^ Moved functions to helper file
  ^ Moved elements to seperate global plugin (also used by other extensions)
  ^ Changed file encoding to UTF-8
  # Fixed issue with regex searches not matching when special whitespace in output
  # Fixed issue with deprecated syntax for php 5.3+
  # Fixed issue with order of execution for items with same ordering number
  # Fixed issue with foreach() error sometimes happening
  # Fixed issue with search/replace texts loosing the slash (\) after saving/copying
  # Fixed issue with preg_match_all error in some cases (when article author is not set)
 
27-Aug-2009 : v2.5.2
  # Fixed issue with installation not working!
 
26-Aug-2009 : v2.5.1
  # Fixed issue with missing element files (causing errors)
 
26-Aug-2009 : v2.5.0
  + Added option to limit by menu item (itemid)
  + Added option to limit by site language
  # Fixed issue with textareas not being selectable because of resize option
  # Fixed issue with special characters in list view (description, search, replace)
 
07-Aug-2009 : v2.4.1
  # Fixed issue with errors in feeds when using K2
  # Fixed issue with RR tags sometimes showing
 
08-July-2009 : v2.4.0
  ^ Changed sliding toggle option (in admin settings) to work better in IE8
  # Fixed issue with limiting on sections/categories not working correctly
  # Fixed issues with php4 incompatibility
 
04-July-2009 : v2.3.1
  + Added option to disable ReReplacer temporarily via url &disable_rereplacer=1
  + Added replace for zip
  ^ Seriously speeded up execution of replacements/code
  # Fixed issue with minor error in version check
 
26-June-2009 : v2.3.0
  ^ Changed the Regular Expressions Cheat Sheet pdf to a png (to make package lighter)
  ^ Changed the textarea element (made it resizable)
  ^ Changed the way options are shown/hidden
  ^ Changed auto installer
  # Fixed issue with update notification not working correctly
  # Fixed issue with limiting on categories/sections not working correctly
 
05-June-2009 : v2.2.11
  # Fixed issue with option Enable in tags: No resulting in blank page
  # Fixed potential errors in pdf pages
 
02-June-2009 : v2.2.10
  # Fixed issue with remaining RR codes in page
 
01-June-2009 : v2.2.9
  + Added uninstallation of plugin when component is uninstalled
  ^ Made code more stable and faster
  # Fixed issue with sometime leaving :BODY: codes in page
  
 28-May-2009 : v2.2.8
  # Fixed issue with replacements in articles not being done before content plugins (since v2.2.5)
 
27-May-2009 : v2.2.7
  # Really fixed issue with articles with page breaks!
  
 27-May-2009 : v2.2.6
  # Fixed issue with articles with page breaks
 
26-May-2009 : v2.2.5
  # Fixed update of the admin icon for older versions
  # Fixed tag selection not working properly
  # Fixed issue with replacements being done multiple times
  # Fixed issue with replacements not being done correctly in feeds and pdfs
 
11-May-2009 : v2.2.4
  + Added some styles to support the AdminPraise2 administrator template
  # Fixed issue with replacements not working in non-content forms
     (now only content edit forms are protected)
  # Fixed issue with exported items sometimes being checked out
  # Fixed issue with replacements going over areas multiple times
 
28-Apr-2009 : v2.2.3
  + Added possibility to protect areas from replacements through  tags
  + Added option to enable/disable replacement in articles title
  + Added option to enable/disable replacement in the name of the articles author
  ^ Changed different administrator elements
  ^ No longer replaces stuff in any adminForm (prevents problems with editors)
  # Fixed issue with error on option to limit by sections / categories in administrator
  # Fixed issue with area 'articles' not working
  # Fixed issue with error about editor if item is being edited
 
21-Apr-2009 : v2.2.2
  ^ Changed different administrator elements
  # Fixed issue with ReReplacer not working correctly with editor text areas
  # Fixed issue with version check giving conflicts (with other NoNumber! extensions)
 
17-Apr-2009 : v2.2.1
  + Added option to limit by sections / categories
  # Fixed issue with using dollar signs in the replacement
  # Fixed issue with installer giving error white screen on some setups
  # Fixed issue with templates path not being found on some setups (used in limit templates)
 
31-Mar-2009 : v2.2.0
  + Added import / export functionality
  + Added checks for certain parameter fields (like minimum length of for 'between'-fields)
  + Added a counter variable to use in the replacements (\#)
  + Added a Regular Expressions Cheat Sheet (pdf) for extra help
  + Added confirmation alert before deleting items
  ^ Changed installation procedure (automatic installer/updater)
  ^ Changed the way ReReplacer protects areas where the replacement should not be done
  ^ Changed the way the limit to tags works (more logical)
  ^ Changed 'repeat' option to a 'thorough' option
  ^ Changed some field types in administrator (i.e. expand button with text areas)
  ^ Moved Dutch language from main to separate package
  ^ Moved examples from main to separate package
  ^ Changed update notification
  ! Removed update icon in administrator toolbar
  # Fixed issue with using '\n' in the textfield (now isn't replaced by an enter on save)
  # Fixed error when plugin is installed but component is not
 
14-Jan-2009 : v2.1.9
  + Added option to enable search in feeds
 
15-Dec-2008 : v2.1.8
  # Fixed issue with replacements not working when using article navigation
 
26-Nov-2008 : v2.1.7
  # Fixed issue with more than 20 replacer items still not working
 
25-Nov-2008 : v2.1.6
  # Fixed issue with unicode characters
  # Fixed issue with more than 20 replacer items not working
  # Fixed some minor bugs
 
11-Nov-2008 : v2.1.5
  # Fixed broken images (icons)
  ^ Changed update notification
 
21-Oct-2008 : v2.1.4
  # Fixed installation error!
 
21-Oct-2008 : v2.1.3
  ^ Changed way the update checking works
  # Replacements will no longer be done in frontend editor area
 
7-Oct-2008 : v2.1.2
  + Added extra update notification in Admin menu bar
  + Added option in plugin to turn update notification off
  # Fixed some issues with installing and uninstalling
 
7-Oct-2008 : v2.1.1
  + Added option to limit search to certain user group levels
  + Added option to limit search to certain templates
  + Added option to replace between give (html) codes
  ^ Changed parameter order
  ! Removed dodgy example ('Move scripts...')
  # Changed dodgy example ('Remove whitespace...', a bit safer now)
  # Fixed issue with language file not loading for messages on install
  # Fixed issue with userid not being set correctly (when saving items)
 
26-Sept-2008 : v2.1.0
  ^ Changed a lot of code to standardize syntax
  # Fixed issue with not being able to use certain variables (like $text)
 
24-Sept-2008 : v2.0.6
  # Fixed issue with replacements in area articles not working
 
23-Sept-2008 : v2.0.5
  # Fixed issue with title element not being found
  # Fixed issue with Word search not in tags (words next to tags where also not replaced)
  # Removed link to ReReplacer component in the menu items list
 
11-Sept-2008 : v2.0.4
  # Fixed issues with PHP4 setups
  # Fixed undefined variable in plugin file
  # Fixed issue with conflict in administrator when showing lists
  # Fixed some issues with pdf's
  + Added "Active in Admin" option
  + Added special character support for newlines and spaces
  + Added example: "Remove empty tables"
  # Changed example: "Remove whitespace between tags"
 
31-July-2008 : v2.0.3
  + Added "show unpublished items" option in list view
  # Fixed issue with "active in area"->"body" not working
  + Added "active in area"->"content", replacing only in component area
  # Fixed some issues with pdf's
 
30-July-2008 : v2.0.2
  # Fixed more issues with install (mysql4) (argh!)
  + Added "show search and replace fields" option in list view
  # Fixed link to image in css for subfolder Joomla setups
 
29-July-2008 : v2.0.1
  # Fixed some issues with install (mysql4)
 
28-July-2008 : v2.0.0
  ^ Completely recoded. Now it works with a Component and a Plugin (not just a Plugin)
  + Added loads of features / stability / logic :)
  + Added examples
 
07-May-2008 : v1.1.0
  # Fixed issue with sections and categories for the new Joomla 1.5.3
  + Added support for sections and categories
  + Added possibility to not replace in tags or only in certain tag parameters
  + Added case insensitive search option
  ^ Rearranged and renamed the parameters in the plugin administrator
  + Added full language support
 
31-Mar-2008 : v1.0.1
  ^ Recoded to make it more stable and more compliant to Joomla!
  ^ Expanded to 12 regular expressions
  + Added ability to replace only in articles
  + Added ability to turn ReReplacer off through the request (post/get): rr_off=1 turns off all replaces,
     the regular expressions can be turned separately (rr_off_1=1 ... rr_off_12=1)
  # Fixed issue with remove list not working
  # Fixed issue with undefined variable (for PHP4)
  # Fixed baseurl issue with websites not running in root folder
 
10-Mar-2008 : v1.0.0
  + First release

Commercial License

ReReplacer is completely free and you DON'T need a Commercial License Code to use it.

However, if you use the extensions on websites you make for / sell to your customer, I would appreciate it if you purchase a License Code.
The License Code will remove the license message from the extensions administrator screens.

Note: If you don't want to pay for the License Code and want to continue to use the extension for free, please do. You will just have to ignore the license message in the administrator.

Note: If you have donated before and feel you should get some reduction on the price, please contact me about it... we'll sort it out :)

more information...

>> Purchase Commercial License Code >>

Really no difference?

Here you can see the difference between the use of the extensions without and with Commercial License Code.

	WITHOUT Commercial License Code	WITH Commercial License Code
Full version download	YES	YES
Full functionality	YES	YES
Message in administrator
Encrypted	NO	NO
Free updates	YES	YES
Free support	YES	YES
Free RSS news subscription	YES	YES
Free holiday to Barbados	NO	NO

Download

Downloads

Packages
ReReplacer (v2.6.5) [auto-installer]	299 KB	Feb 17

Language Packs
ReReplacer (v2.5.x) - Language Pack (Dutch) [auto-installer]	19.3 KB	Aug 2009

Others
ReReplacer - Example Pack 1 (v2.6.0)	7.6 KB	Jan 29

More downloads...