- Code repository: https://github.com/collective/slc.quickchange/
- Questions and comments to info (at) syslab (dot) com
This package adds a view @@search-replace, that lets the user perform search & replace operations. Available options:
- Recursive: If selected, not only the current object, but all children are searched as well
- For all languages: search not only the current object, but all translations of it as well (LinguaPlone is required)
- Use regular expression syntax: don't perform literal string matching, but use python's regex
- Ignore case: case insensitive search (only for regex)
- Dotall: search multiple lines (only for regex)
And there are two actions:
- Search only: will list all matching documents found, nothing gets modified
- Replace: do the actual replacement
Imagine you have to change URLs that point to an old domain. Plus, the site structure has changed, so you need to re-order the elements of the path.
For the new link, we need to change the domain, and also put the language-folder as first element:
For the search term, we use:
The contents of the brackets are availabe as variables in the order of their appearance, like 1, 2 etc.
For the replacement term, we use:
That means, as first element after the domain, we take the second bracket (the language folder), then the first, and lastly the third.
Instead of numbers, you can also use named backreferences. This makes sense when a numbered backreference collides with the code of a symbol. Suppose you want to replace the number 12,500 with 13,000 and also allow for the fact that other languages may use "." as delimiter. The regex for search:
will not yield the desired result, since "\100" is interpreted as '@'. A named backreference prevents this. Example for the search pattern:
and the corresponding replacement pattern:
If in doubt, look at the regex documentation :-)
This package only works and makes sense if you have LinguaPlone installed.
Add "slc.quickchange" to the eggs section of your buildout configuration. After running buildout and restarting your instance, go to the Site Setup -> Add-on Products, choose slc.quickchange and click "install".
An new entry named "Search and replace" will then appear in the Actions drop-down menu of all objects.
Beware, you can wreak havoc with this tool if you don't know what you're doing. There is no documentation apart from this little text and the source code...
Copyright European Agency for Health and Safety at Work and Syslab.com GmbH.
slc.quickchange development was funded by the European Agency for Health and Safety at Work.
slc.quickchange is licensed under the GNU Lesser Generic Public License, version 2 or later and EUPL version 1.1 only. The complete license texts can be found in docs/LICENSE.GPL and docs/LICENSE.EUPL.