Difference between revisions of "Reference:Replace Text"

{{BSExtensionInfobox
        
        |desc=provides a form to let administrators do string replacements on the entire wiki, for both page contents and page titles.
        
        |status=stable
        
        |developer=Yaron Koren, Niklas Laxström
        
        |type=MediaWiki
        
        |edition=BlueSpice pro
        
        |compatible=MediaWiki
        
        |category=Administration
        
        |docu=https://www.mediawiki.org/wiki/Extension:Replace_Text
        
        }}
        
        __NOTOC__
        
        '''ReplaceText''' extension from MediaWiki provides features to change text passages in articles or article titles. With a form, the existing text and the wanted text can be typed in. The extension searches for this words or text passages and replaces it automatically. For this purpose, also filters and configurations are available. In addition to this, also complex text changes can be done by using placeholders and regular expressions.  
        
        
        
        
        <div id="box-info" style="width: 98%; margin: 20px 0; border: solid 1px #ffae00; padding: 8px; background-color: #ffe4ab;">
        
        [[Image:Icon-note.png|left]]<span style="text-transform: uppercase; color: #ffae00; font-size: 16px; font-weight: bold;"> Hint</span><div color:="" 000="">
        
        The MediaWiki extension '''ReplaceText''' can be used with both MediaWiki and BlueSpice. The extension is available for download in our  [http://shop.blue-spice.org BlueSpice Marketplace].
        
        
        </div>
        
        
        </div>
        
        
        
        Strictly speaking, there are two forms. In the '''first form''' you can:
        
        
        
        * Type in the already exiting, to be changed text.
        
        * Type in the wanted, new text.
        
        * Activate the checkbox for the usage of placeholders or regular expressions.
        
        * Choose the namespaches, in which the changes should take place.
        
        * Select additional filters for categories or page prefixes.
        
        * Activate replacement for text or titles.
        
        
        
        
        
        If you made all your entries and configurations in this form, you will be led to the '''second form''' by clicking on the "Continue" button. All found articles and article titles, which contain the substitutional parts, will be listed there. Uncheck the boxes of the articles, which should not be changed.
        
        
        
        
        <br />Moreover, there are two further options for configuration. Changes on the article title will be realized by moving the original page - according to the wiki principle. Due to this, there are some configurations for the moved page. Decide if: 
        
        
        
        * there should be a redirect from the moved page to the new one
        
        * this page should be added to your [[WatchList|watchlist]]
        
        
        
        Confirm your choice with the "Replace" button to trigger the automatic replacement of the text passages. The last step is a confirmation from the system, which shows you what has been replaced and in how many articles this has been done. 
        
        
        
        ==Usage of regular expressions==
        
        To use regular expressions for replacing text, the corresponding box in the first form must be checked to activate the functionality. Only a subset of the regular expressions of PHP and MySQL can be used. The following characters can be used:
        
        
        
        
        <pre>( ) . * + ? [ ] |  as well as $1, $2 etc.</pre>
        
        If the characters should be interpreted as real characters and not as part of a regular expression, a "\" must be added beforehand (like in the second example below: the dot is interpretet as a dot).
        
        
        
        '''Examples:'''
        
        
        
        {| class=" cuscosky"
        
        |-
        
        ||'''Search String'''
        
        ||'''Replace String'''
        
        ||'''Behaviour'''
        
        |-
        
        ||<tt>a(.*)c</tt>
        
        ||<tt>ac$1</tt>
        
        ||Places all characters between a nad c at the end, e.g.:<br />azioc to aczio
        
        |-
        
        ||<tt>([0-9]*)\.([0-9]*)</tt>
        
        ||<tt>$1,$2</tt>
        
        ||Replaces the dot between the two numerical orders with a comma, e.g.:<br />2465.8924 zu 2465,8924
        
        |}
        
        === ===
        
        If you want to move a text part, which is placed between two numerical orders, you would type in the following regular expression according to the example given above: <br /><br />'''Search String:''' 123(.*)456
        
        
        
        '''Replace String: '''$1123456
        
        
        
        to move the text from the middle to the beginning.
        
        
        
        Due to the fact that a numerical order follows, the placeholder ($1) can not be used like meantioned above. In this case, the placeholder must be put in brackets to explicitly assign the numbering:<br /><br />'''Replace String:''' {$1}123456
        
        
        
        
        
        
        
        ==Useful links==
        
        
        * For more information please visit [https://en.wikipedia.org/wiki/Regular_expression Article about "Regular expression" from Wikipedia].
        
        
        
        
        
        
        
        
        
        
        
        [[de:{{FULLPAGENAME}}]][[en:{{FULLPAGENAME}}]][[Category:Extension]]