Skin:Vector/2022

This skin comes with MediaWiki 1.38 and above. Thus you do not have to download it again. However, you still need to follow the other instructions provided.
MediaWiki skins manual - category
OOjs UI icon layout-ltr.svg
Vector 2022
Release status: stable
Sticky header logged in.png
Compatibility policy Snapshots releases along with MediaWiki. Master is not backwards compatible.
Composer mediawiki/vector-skin
License GNU General Public License 2.0 or later
Download
Example https://en.wikipedia.org/
https://vi.wikipedia.org/
https://test.wikipedia.org/
Parameters
Quarterly downloads 891 (Ranked 1st)
Public wikis using 15,890 (Ranked 1st)
Public wikis using as default skin 6,923
Translate the Vector skin if it is available at translatewiki.net
Vagrant role vector
Issues : Open tasks · Report a bug

Vector 2022 is the second evolution of the MediaWiki Vector skin and is in development as part of the Desktop improvements project. It has been bundled in MediaWiki since MediaWiki 1.38 . It is the default skin for various Wikimedia projects.

Vector 2022 differs from most skins in that it does not have its own code base; rather, its code is part of the Vector skin's, and the two are downloaded together.

InstallationEdit

  • Download and place the file(s) in a directory called Vector in your skins/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
wfLoadSkin( 'Vector' );
  •   Done - Navigate to Special:Version on your wiki to verify that the skin is successfully installed.

Optional dependenciesEdit

Vector 2022 makes use of the following extensions, though none are hard requirements:

Making Vector 2022 the default skinEdit

For MediaWiki versions 1.38 and higher, add the following to LocalSettings.php to make Vector 2022 the default skin:

$wgDefaultSkin = 'vector-2022';

For versions 1.36 and 1.37, you should instead add the following:

$wgVectorResponsive = true;
$wgVectorDefaultSkinVersion = '2';

Note about 1.38 releaseEdit

The 1.38 release marked official 3rd party support for the skin; however, between 1.36 and 1.38, the skin was available at 3rd parties' own risk.

If a site running MediaWiki 1.36 or 1.37 is using Vector 2022, it will hit challenges when upgrading to the 1.38 release. This is unavoidable, and one of the reasons why the use of this skin was discouraged prior to 1.38.

If the site allowed users to opt into the new experience, these users will be served legacy Vector after the upgrade, and will need to revisit Special:Preferences to update their skin preference to Vector 2022.

For large wikis, where a change in skin may be disruptive to logged-in users, you may want to consider writing a maintenance script to upgrade existing database preferences. See T299104 and Extension:WikimediaMaintenance for more details.

Configuration parametersEdit

Note that Vector has several unstable feature flags, which may disappear at any time. Most of these feature flags relate to incomplete features. We do not recommend changing any feature flag from its default value unless listed here.

$wgVectorMaxWidthOptionsEdit

Can be used to configure whether the max-width applies. Relatively stable at this point.

$wgVectorLanguageInMainPageHeaderEdit

Controls whether the language button shows on the main page in the header.

$wgVectorWvuiSearchOptionsEdit

Associative array with keys showDescription and showThumbnail (both booleans).