search-regex
Last commit date
build
5 days ago
includes
5 days ago
changelog.txt
1 year ago
license.txt
18 years ago
readme.txt
5 days ago
search-regex-loader.php
6 months ago
search-regex.php
5 days ago
readme.txt
176 lines
| 1 | === Search Regex === |
| 2 | Contributors: johnny5 |
| 3 | Donate link: http://searchregex.com/donation/ |
| 4 | Tags: search, replace, regex, regular expression, database |
| 5 | Tested up to: 7.0 |
| 6 | Stable tag: 3.4.3 |
| 7 | License: GPLv3 |
| 8 | |
| 9 | Search Regex adds a powerful set of search and replace functions to WordPress posts, pages, custom post types, and other data. |
| 10 | |
| 11 | == Description == |
| 12 | |
| 13 | Search Regex adds a powerful set of search and replace functions to WordPress posts, pages, custom post types, and other data sources. These go beyond the standard searching capabilities, and allow you to search and replace almost any data stored on your site. In addition to simple searches you have the full power of PHP's regular expressions at your disposal. |
| 14 | |
| 15 | You can use this to do things like: |
| 16 | - Help migrate a site from one domain to another |
| 17 | - Update URLs in links and images |
| 18 | - Perform site-wide changes |
| 19 | |
| 20 | Search filters can be created to match any column of any WordPress table. For example: |
| 21 | - Find all posts in a category |
| 22 | - Find all post meta data without a post |
| 23 | - Find all posts in a date range |
| 24 | |
| 25 | Search Regex handles small and large sites. |
| 26 | |
| 27 | Search Regex has been tested with PHP from 7.4 to 8.4. |
| 28 | |
| 29 | == What can I search? == |
| 30 | |
| 31 | You can search: |
| 32 | - Posts |
| 33 | - Pages |
| 34 | - Any custom post type |
| 35 | - Comments (including spam) |
| 36 | - Users |
| 37 | - Meta data |
| 38 | - WordPress options |
| 39 | |
| 40 | Full regular expression support is provided, and you can capture data and use it in the replacement. |
| 41 | |
| 42 | == Actions == |
| 43 | |
| 44 | A variety of actions can be performed on matching results: |
| 45 | - Modify and replace the result |
| 46 | - Delete the result |
| 47 | - Export to CSV and SQL |
| 48 | - Perform custom PHP action |
| 49 | |
| 50 | == Modify and Replace Data == |
| 51 | |
| 52 | Results can be individually modified by clicking on the item to change, and using the popup modifier. |
| 53 | |
| 54 | Bulk modifications can be performed against all matching results. |
| 55 | |
| 56 | The types of modification depend on the data being changed: |
| 57 | - Numbers can be added or subtracted to existing numbers |
| 58 | - Hours, days, weeks, and months, can be added to dates |
| 59 | - Tags and categories can be added, removed, and substitued |
| 60 | |
| 61 | Custom shortcodes are supported that allow dynamic data to be included: |
| 62 | - Add the current date and time, in any format, to content |
| 63 | - Insert data from other columns. For example, insert the category into the title |
| 64 | - Transform existing data. For example, convert case, change underscores to dashes. |
| 65 | |
| 66 | == Example uses == |
| 67 | |
| 68 | Some ideas for potential uses: |
| 69 | - Delete all comments that match a phrase |
| 70 | - Add a category to all matching posts |
| 71 | - Remove orphaned meta data |
| 72 | |
| 73 | == Support == |
| 74 | |
| 75 | Please submit bugs, patches, and feature requests to: |
| 76 | |
| 77 | [https://github.com/johngodley/search-regex](https://github.com/johngodley/search-regex) |
| 78 | |
| 79 | Please submit translations to: |
| 80 | |
| 81 | [https://translate.wordpress.org/projects/wp-plugins/search-regex](https://translate.wordpress.org/projects/wp-plugins/search-regex) |
| 82 | |
| 83 | == Installation == |
| 84 | |
| 85 | The plugin is simple to install: |
| 86 | |
| 87 | 1. Download `search-regex.zip` |
| 88 | 1. Unzip |
| 89 | 1. Upload `search-regex` directory to your `/wp-content/plugins` directory |
| 90 | 1. Go to the plugin management page and enable the plugin |
| 91 | 1. Configure the options from the `Tools/Search Regex` page |
| 92 | |
| 93 | You can find full details of installing a plugin on the [plugin installation page](https://searchregex.com/support/installation/). |
| 94 | |
| 95 | == Translations == |
| 96 | |
| 97 | Translations are provided by WordPress itself. You can update the translations by going to the Dashboard > Updates section of WP admin. |
| 98 | |
| 99 | == Screenshots == |
| 100 | |
| 101 | 1. Search options |
| 102 | 2. Inline search and replace |
| 103 | 3. Inline editor |
| 104 | |
| 105 | == Documentation == |
| 106 | |
| 107 | Full documentation can be found on the [Search Regex](http://searchregex.com/) site. |
| 108 | |
| 109 | == Upgrade Notice == |
| 110 | |
| 111 | = 2.0 = |
| 112 | * Entirely new rewrite of the plugin. Requires minimum PHP 5.6 and is compatible with all versions (tested up to 8.0). |
| 113 | |
| 114 | = 3.0 = |
| 115 | * Major update adding advanced search filters, modifications to any column, and a variety of actions (including exporting to SQL). |
| 116 | |
| 117 | = 3.1.0 = |
| 118 | * Set PHP 7.0 and WP 6.4 as the baseline. Plugin now uses WP supplied translations |
| 119 | |
| 120 | = 3.2 = |
| 121 | * Set PHP 7.2 as the minimum |
| 122 | |
| 123 | = 3.3 = |
| 124 | * Set PHP 7.4 as the minimum |
| 125 | |
| 126 | == Changelog == |
| 127 | |
| 128 | = 3.4.3 - July 25th 2026 = |
| 129 | * Sanitise CSV exports |
| 130 | * Fix 'run action' |
| 131 | |
| 132 | = 3.4.2 - May 31st 2026 = |
| 133 | * Better older PHP compatibility |
| 134 | * Improve UTF8 collation searching |
| 135 | * Improve WP 7.0 admin styling |
| 136 | |
| 137 | = 3.4.1 - February 28th 2026 = |
| 138 | * Fix problem with export data |
| 139 | |
| 140 | = 3.4 - February 14th 2026 = |
| 141 | * Include term description in searches |
| 142 | |
| 143 | = 3.3.1 - January 16th 2026 = |
| 144 | * Fix replace all with regex |
| 145 | * Fix presets on page load |
| 146 | * Fix crash when adding a modification |
| 147 | * Fix missing source param from column context |
| 148 | * Add browser extension error detection |
| 149 | * Add mid-update cache clearing detection |
| 150 | |
| 151 | = 3.3.0 - January 11th 2026 = |
| 152 | * Add a simple/advanced mode toggle |
| 153 | * Add delete confirmation dialog |
| 154 | * Improve case-sensitive search to properly handle emojis and multi-byte characters |
| 155 | * Improved client code |
| 156 | * Use PHP autoloading for better performance |
| 157 | * Bump minimum PHP to 7.4 |
| 158 | |
| 159 | = 3.2 - December 22nd 2025 = |
| 160 | * Add WP CLI functions |
| 161 | * Variety of small fixes and improvements |
| 162 | * Update for WordPress 6.9 |
| 163 | * Bump PHP minimum to 7.2 |
| 164 | |
| 165 | = 3.1.2 - December 29th 2024 = |
| 166 | * Fix crash when loading from a preset with an 'includes any' |
| 167 | |
| 168 | = 3.1.1 - November 23rd 2024 = |
| 169 | * Update for WordPress 6.7 |
| 170 | |
| 171 | = 3.1.0 - August 8th 2024 = |
| 172 | * Update for latest WP |
| 173 | * Fix export of regular expression result |
| 174 | * Switch to WP core translations |
| 175 | * See changelog.txt for more details |
| 176 |