{ext-header User Guide}

1) What is DB Replacer?

DB Replacer is Joomla! administrator component that enables you to search and replace in any table in your database.

To replace a certain string in your database table, you just need to:

  1. go to DB Replacer in your Joomla! administrator
  2. select proper content table and table column(s)
  3. input the search and replace text
  4. click on ‘Replace’

DB Replacer gives you a preview of what is going to be replaced, so you know what you are doing before actually replacing anything.

2) Using DB Replacer

Using DB Replacer is quite straightforward. Open DB Replacer from the component menu in the Joomla! administrator. You will be presented with the following component interface:

DB Replacer

2.1) Tables

TablesIn the Tables select box you will see the list of all database tables from which you can choose one table in which you want to make the changes.

2.2) Columns

ColumnsAfter selecting the table, the Columns select box will be populated. You can choose one or more columns here. To select multiple columns, keep the Control/Command key pressed when selecting.

2.3) Search & Replace

Search & ReplaceEnter the existing text to be replaced in the Search text box.

Once you enter some text in this field, the Preview table below will only show the rows which contain your search string.

Enter the new replacement text in the Replace text box.

The Preview table will show you a preview of the replacement. The search string will be marked red and the replacement will be marked green.

Preview

If you are satisfied with the Preview result, simply click on the Replace button to apply the changes.

You can search and replace in up to 1000 rows at one time (up to 50 in FREE version).
WE RECOMMEND not setting the default row count limit too high (around 100). Replacing in too many rows at once can make your page time out, depending on server and database settings.

2.4) Case sensitivity

If you need to make changes where case sensitivity is required, you can check “Case sensitive” checkbox. Now the replacements will only be done where the search matches exactly.

For instance, ‘Joomla’ will not match ‘joomla’ or ‘JOOMLA’.

2.5) Regular Expressions

The PRO version of DB Replacer also supports Regular Expressions searches and replacements.

This gives you great power to search for dynamic values and use (parts of) the searched text in the replacement.

For example, if you want to make all prices with syntax $123.00 bold, you can search for:

(\$[0-9]+\.[0-9][0-9])

and replace with:

<strong>\1</strong>

This will make $1.00 and $999.00 bold, but ignore $1 and $999.

When the Regular Expressions option is checked, you will also be able to search in UTF-8 mode. This can help you when using special characters or certain character sets.

For more info on Regular Expressions: http://www.regular-expressions.info/reference.html
For testing them: http://gskinner.com/RegExr

2.6) Where clause

WhereWith the PRO version of DB Replacer you can limit the search via a custom WHERE clause.

The WHERE clause is used to extract only those records that fulfill specific criteria.

This field follows the default MySQL WHERE syntax. For instance, if you only want to search and replace in records that have an id between 100 and 200, you can enter:

id > 100 AND id < 200

3) Options

In the toolbar, on the right, you will see the 'Options' button.

Options

When you click on that, a modal window will open with a couple of options for DB Replacer.

Here is an overview of the available options. All descriptions are available in the tooltips of the options.

{ext-load-languages com_dbreplacer}

{text DBR_IGNORE_TABLES} {text DBR_IGNORE_TABLES_DESC}
{text DBR_DEFAULT_TABLE}
[onlypro]
{text DBR_DEFAULT_TABLE_DESC}
{text DBR_DEFAULT_COLUMNS}
[onlypro]
{text DBR_DEFAULT_COLUMNS_DESC}

{text DBR_MAXIMUM_ROW_COUNT}
[onlypro]

{text DBR_MAXIMUM_ROW_COUNT_DESC}
Choose from: 50, 100, 200, 500, 1000
{text DBR_SHOW_WARNING} {text DBR_SHOW_WARNING_DESC}

3.1) Permissions

The Joomla core permission settings to control access to the different actions. For more information on how these permissions work, see the Joomla docs:
Access Control List Tutorial : Component Options & Permissions

{ext-guide-general}

{ext-header FAQs}

Is it possible to multi select tables in one database?

No, not possible with DB Replacer. You can only search and replace in 1 table at a time.

To do replaces in multiple tables you will have to repeat the replace process for each table.

Another method is to execute your own custom sql command on your database directly, via phpMyAdmin for instance.

How can I replace empty or NULL values

You can match empty, NULL or 0000-00-00 date values by simply placing NULL in the search area.

How can I replace the entire value

You can match the entire value of a field by placing a single asterisk * in the search area.

Where can I find more information on Regular Expressions?

For more info on Regular Expressions: http://www.regular-expressions.info/reference.html
For testing them: http://gskinner.com/RegExr

{ext-faqs-general}