Editing Manual/Upgrading (section)

== Adapt your <tvar name=1><code>LocalSettings.php</code></tvar> == <!--T:151-->

<!--T:152-->
If you use the same <tvar name=localsettings><code>LocalSettings.php</code></tvar> from the old version, you may need to adapt it to how new versions handle it:

=== Skin registration === <!--T:153-->
</translate>

<translate>
<!--T:154-->
Since MediaWiki 1.24, bundled skins like Vector, Monobook, Modern and CologneBlue are no longer part of MediaWiki core, and they need to be registered explicitly in <tvar name=localsettings><code>LocalSettings.php</code></tvar> to use them, otherwise MediaWiki will warn that you don't have installed skins.

<!--T:155-->
This is what you need to add to <tvar name=localsettings><code>LocalSettings.php</code></tvar> when upgrading from versions older than 1.24 and want to have available one of those skins:
</translate>

<syntaxhighlight lang="php">
wfLoadSkin( 'Vector' );
wfLoadSkin( 'MonoBook' );
wfLoadSkin( 'Modern' );
wfLoadSkin( 'CologneBlue' );
</syntaxhighlight>

<translate>
<!--T:158-->
Other skins may still not be adapted to the new [[<tvar name=skinreg>Special:MyLanguage/Manual:Extension registration</tvar>|skin registration]] system, so refer to the documentation page about each skin to see how to register it properly in case of problems.

=== Extension registration === <!--T:159-->
</translate>

<translate>
<!--T:160-->
Since MediaWiki 1.25, extensions use a new [[<tvar name=extreg>Special:MyLanguage/Manual:Extension registration</tvar>|extension registration]] system.

<!--T:161-->
Previously your <tvar name=1><code>LocalSettings.php</code></tvar> would include something like:
</translate>

<syntaxhighlight lang="php">
require_once "$IP/extensions/Cite/Cite.php";
require_once "$IP/extensions/Gadgets/Gadgets.php";
require_once "$IP/extensions/ImageMap/ImageMap.php";
require_once "$IP/extensions/InputBox/InputBox.php";
require_once "$IP/extensions/Nuke/Nuke.php";
require_once "$IP/extensions/ParserFunctions/ParserFunctions.php";
require_once "$IP/extensions/Poem/Poem.php";
require_once "$IP/extensions/SyntaxHighlight_GeSHi/SyntaxHighlight_GeSHi.php";
require_once "$IP/extensions/WikiEditor/WikiEditor.php";
</syntaxhighlight>

<translate>
<!--T:162-->
This can be converted to:
</translate>

<syntaxhighlight lang="php">
wfLoadExtension( 'Cite' );
wfLoadExtension( 'Gadgets' );
wfLoadExtension( 'ImageMap' );
wfLoadExtension( 'InputBox' );
wfLoadExtension( 'Nuke' );
wfLoadExtension( 'ParserFunctions' );
wfLoadExtension( 'Poem' );
wfLoadExtension( 'SyntaxHighlight_GeSHi' );
wfLoadExtension( 'WikiEditor' );
</syntaxhighlight>

<translate><!--T:163--> Extensions are being adapted to use the new extension registration system.</translate>
<translate><!--T:164--> Extensions that are not adapted should use the old way of installing them.</translate>
<translate><!--T:165--> Refer to the installation instructions on the extension's page for more information.</translate>

<translate>
=== Remove <tvar name=1>DefaultSettings.php</tvar> line (if necessary) === <!--T:584-->
</translate>

<translate><!--T:585--> Older versions of MediaWiki automatically generated a line in <tvar name=1>LocalSettings.php</tvar> calling <tvar name=2></tvar>.</translate>
<translate><!--T:586--> As of Version 1.38, this line is deprecated and does not work with many extensions.</translate>
<translate><!--T:587--> It needs to be removed.</translate>

<translate><!--T:588--> Delete the following line:</translate>
<syntaxhighlight lang="php">
require_once( "$IP/includes/DefaultSettings.php" );
</syntaxhighlight>

<translate>
===Remove RenameUser from <tvar name=1>LocalSettings.php</tvar>=== <!--T:603-->
</translate>

<translate><!--T:604--> If you are upgrading to 1.40 or above, <tvar name=1></tvar> has been merged into core.</translate>
<translate><!--T:605--> If present, this line must be deleted from <tvar name=1>LocalSettings.php</tvar> or the update will fail.</translate>

<syntaxhighlight lang="php">
wfLoadExtension( 'Renameuser' );
</syntaxhighlight>

<translate>
===Remove Interwiki from <tvar name=1>LocalSettings.php</tvar>=== <!--T:608-->
</translate>

<translate><!--T:609--> If you are upgrading to 1.44 or above, <tvar name=1></tvar> has been merged into core.</translate>
<translate><!--T:610--> If present, this line must be deleted from <tvar name=1>LocalSettings.php</tvar>.</translate>

<syntaxhighlight lang="php">
wfLoadExtension( 'Interwiki' );
</syntaxhighlight>

<translate>
<!--T:611-->
Please be sure to check  for some Interwiki settings that have been removed or renamed.

=== Other variables === <!--T:166-->
</translate>
<translate><!--T:167--> Some variables may be obsolete or even removed.</translate>
<translate><!--T:168--> Having them in <tvar name=localsettings><code>LocalSettings.php</code></tvar> '''usually''' won't have any effect.</translate>
<translate><!--T:169--> New variables may be added in newer versions, or some existing variables changed their type.</translate>
<translate><!--T:170--> We usually try to use sane defaults for them, and in case of type change, be backward compatible.</translate>
<translate><!--T:171--> In any case, take a look at the release notes to see those changes.</translate>

<translate>