Utseende:Vector/2022

MediaWiki-manual för utseenden - kategori

Vector 2022 Utgivningsstatus: stabil
Kompatibilitetspolicy	Släpp av ögonblicksbilder tillsammans med MediaWiki. Master är inte bakåtkompatibel.
Composer	mediawiki/vector-skin
Licens	GNU General Public License 2.0 eller senare
Ladda ner	Ladda ner utseende Git [?]: Download Git master browse repository (Phabricator · GitHub) commit history repository contributors (GitHub) code review
Exempel	enwiki viwiki testwiki
Parametrar $wgVectorDefaultSkinVersionForExistingAccounts $wgVectorDefaultSkinVersionForNewAccounts $wgVectorFontSizeConfigurableOptions $wgVectorLanguageInHeader $wgVectorLanguageInMainPageHeader $wgVectorMaxWidthOptions $wgVectorNightModeOptions $wgVectorPromoteAddTopic $wgVectorResponsive $wgVectorTableOfContentsCollapseAtCount $wgVectorTypeahead $wgVectorUseIconWatch $wgVectorWebABTestEnrollment $wgVectorWrapTablesTemporary
Krokar som använts GetPreferences LocalUserCreated SkinPageReadyConfig
Kvartalsnedladdningar	0
Offentliga wikier som använder	14,010 (Ranked 2nd)
Offentliga wikier som använder standardutseendet	5,943
Översätt utseendet $2 om det finns tillgängligt på translatewiki.net
Vagrant-roll	vector
Ärenden	Öppna ärenden · Rapportera en bugg

Vector 2022 är den andra utvecklingen av MediaWikis utseende Vector och utvecklas som del av projektet Stationära förbättringar. Den har paketerats i MediaWiki sedan MediaWiki 1.38 . Den är standardutseendet för flera Wikimedia-projekt.

Vector 2022 skiljer sig från de flesta utseenden i att den inte har sin egen kodbas utan istället är en del utseendet Vector och att de båda laddas ner tillsammans.

Version MediaWiki 1.38 of this skin marked official 3rd party support.

Note that sites running MediaWiki 1.36 or 1.37 that use Vector 2022 will hit challenges when upgrading to the 1.38 release. See T299104 and Extension:WikimediaMaintenance for more details.

Installation

Utseendet följer med i MediaWiki 1.38 och framåt. The remaining configuration instructions must still be followed.

• Ladda ner och placera filen/filerna i en katalog som heter Vector i din skins/-mapp.
• Lägg till följande kod längst ner i din LocalSettings.php -fil.

  wfLoadSkin( 'Vector' );
  

• Configure as required.
• Klart - Ta dig till Special:Version på din wiki för att bekräfta att tillägget har installerats ordentligt.

Valfria beroenden

Vector 2022 kan använda sig av följande tillägg om de installerats, men inga är obligatoriska:

• UniversalLanguageSelector – för språkbytesknappen
• PageImages – för att inkludera en bild för alla sidor (om det finns) i sökrutan
• ShortDescription – för att inkludera en beskrivning för alla sidor i sökrutan (Wikimedias projekt har liknande funktionalitet, men använder inte detta tillägg)

Configuration

Göra Vector 2022 till standardutseende

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

$wgDefaultSkin = 'vector-2022';

Features

Dark mode

MediaWiki-version:

1.43

Vector 2022 features a night mode (aka dark mode), which has three possible states:

• day – also known as light mode
• night – also known as dark mode
• os – also known as automatic. This mode will automatically adapt to the state of the operating system or browser

Night mode is gated by a feature flag. To enable it, set $wgVectorNightMode as follows:

$wgVectorNightMode['beta'] = true;
$wgVectorNightMode['logged_out'] = true;
$wgVectorNightMode['logged_in'] = true;

When enabled, the default theme mode is day. To change the default theme for all users to automatic mode or night mode, you set the default for the user option with either:

$wgDefaultUserOptions['vector-theme'] = 'os';
// or 
$wgDefaultUserOptions['vector-theme'] = 'night';

Please note that your content has to be night mode compatible. You might want to read the recommendations for Wikimedia wikis .

Configurability

Note that Vector 2022 has several unstable feature flags, which may disappear at any time. Most of these feature flags relate to incomplete features. It is not recommended to change 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 is shown on the main page in the header.
• $wgVectorTypeahead - Associative array with configuration keys for API URLs and options such as showDescription and showThumbnail (both booleans).

Pinning

Vector 2022 allows control over whether various menus appear pinned in the sidebar or collapsed into the header. These options can be configured both by users in their preferences and by administrators as default settings.

The following pinning options are available:

• vector-main-menu-pinned – Controls the main navigation menu position
  • 1 (default) – Menu is pinned in the left sidebar
  • 0 – Menu is collapsed into header hamburger icon
• vector-page-tools-pinned – Controls the page tools menu position
  • 1 (default) – Tools are pinned in the right sidebar
  • 0 – Tools are collapsed into header icon
• vector-toc-pinned – Controls the table of contents position
  • 1 (default) – Table of contents is pinned in the left sidebar
  • 0 – Table of contents is collapsed into a floating button
• vector-appearance-pinned – Controls the appearance menu position
  • 1 (default) – Appearance options are pinned in the sidebar
  • 0 – Appearance options are collapsed into header icon

To change any of these defaults for logged in users, add the corresponding lines to LocalSettings.php:

Note this will not work for anonymous users due until T366999 is worked on.

// Example: Collapse all menus
$wgDefaultUserOptions['vector-main-menu-pinned'] = 0;
$wgDefaultUserOptions['vector-page-tools-pinned'] = 0;
$wgDefaultUserOptions['vector-toc-pinned'] = 0;
$wgDefaultUserOptions['vector-appearance-pinned'] = 0;

Workarounds

Varning:

This code should never be run on Wikimedia production sites as it causes the page to be re-rendered which can impact SEO as well as user experience.

To pin the sidebar for anonymous users by default, this code can be added at the beginning of MediaWiki:Common.js (see live example):

if (!mw.config.get('wgUserName')) {
	const observer = new MutationObserver((mutationsList, observer) => {
		for (const mutation of mutationsList) {
			if (mutation.target.classList.contains('vector-animations-ready')) {
				document.querySelector( '[data-event-name="pinnable-header.vector-main-menu.pin"]' ).click()
				observer.disconnect();
				break;
			}
		}
	});
	
	observer.observe(document.documentElement, { attributes: true, attributeFilter: ['class'] });
}

If you also want to pin the tools for anonymous users by default, you can add the following line of code (after line 5):

document.querySelector( '[data-event-name="pinnable-header.vector-page-tools.pin"]' ).click()

See also

• Design documentation