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

Vector 2022 Release status: stable
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	Download skin Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review
Example	https://en.wikipedia.org/ https://vi.wikipedia.org/ https://test.wikipedia.org/
Parameters
Quarterly downloads	693 (Ranked 1st)
Public wikis using	14,010 (Ranked 2nd)
Public wikis using as default skin	5,943
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.

Installation

• 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 file:

  wfLoadSkin( 'Vector' );
  

•  Done - Navigate to Special:Version on your wiki to verify that the skin is successfully installed.

Optional dependencies

Vector 2022 can make use of the following extensions if they are installed, though none are required:

• UniversalLanguageSelector - for the language switch button
• PageImages - to include an image for each page (if available) in the search bar
• ShortDescription - to include a description for each page in the search bar (Wikimedia projects have similar functionality, but not using this extension)

Making Vector 2022 the default skin

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 release

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 parameters

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.

$wgVectorMaxWidthOptions

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

$wgVectorLanguageInMainPageHeader

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

$wgVectorWvuiSearchOptions

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

See also

• Design documentation