Skin: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 | |||
Example | https://en.wikipedia.org/ https://vi.wikipedia.org/ https://test.wikipedia.org/ |
||
|
|||
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 yourskins/
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:
- Extension:UniversalLanguageSelector - for the language switch button
- Extension:PageImages - if you want to include an image for the page (if available) in the new search bar
- Extension:ShortDescription - if you want to include a description for the page in the new search bar (Wikimedia projects do not use this; the description comes from the Wikibase extensions)
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).