Erweiterung:Bootstrap

PW

Das Team von Professional Wiki wartet diese Erweiterung professionell.

Professional Wiki bietet offizielle Unterstützung nur für MediaWiki LTS-Releases. Sie kann mit anderen MediaWiki-Veröffentlichung kompatibel sein.

MediaWiki-Erweiterungen

Bootstrap Freigabestatus: stabil
Einbindung	Benutzeroberfläche
Beschreibung	Provides the Bootstrap 4 web front-end framework
Autor(en)	Stephan Gambke (F.trottDiskussion)
Betreuer	Professional Wiki
Letzte Version	5.0.0 (2024-04-26)
Kompatibilitätspolitik	Für jede MediaWiki-Version, die ein Long Term Support Release ist, existiert ein entsprechender Zweig in der Erweiterung.
MediaWiki	1.39+
PHP	8.0+
Datenbankänderungen	Nein
Composer	mediawiki/bootstrap
Lizenz	GNU General Public License 3.0 oder neuer
Herunterladen	GitHub: Projektseite Git-Repositorium-URL [Hilfe ] Änderungsgeschichte Hinweis: No localisation updates are provided by translatewiki.net . README on GitHub Changelog on GitHub
Verwendete Hooks SetupAfterCache

The Bootstrap extension provides the Bootstrap 4 (documentation) web front-end framework to MediaWiki. It can be activated directly or used from skins or extensions.

Installation

See the installation instructions for information on how to install this extension.

Verwendung

Within a skin

Use \Bootstrap\BootstrapManager::getInstance() to get the singleton managing the Bootstrap framework.

With the returned object:

• add Bootstrap modules using addBootstrapModule(), addCoreBootstrapModules(), and addAllBootstrapModules()
• set SCSS variables using setScssVariable() and setScssVariables()
• add style files using addStyleFile()
• add cache trigger files using addCacheTriggerFile()

Finally, to add the Bootstrap styles and javascript to the page, use $out->addModuleStyles( 'ext.bootstrap.styles' ) for styles and $out->addModules( 'ext.bootstrap.scripts' ) for scripts.

For an example of how to include Bootstrap styles in a skin, have a look at the Chameleon skin.

Standalone

To enable Bootstrap styles on all pages, add the following code to your "LocalSettings.php" file:

$wgHooks['SetupAfterCache'][] = function(){
	\Bootstrap\BootstrapManager::getInstance()->addAllBootstrapModules();
	return true;
};

$wgHooks['ParserAfterParse'][]=function( Parser &$parser, &$text, StripState &$stripState ){
	$parser->getOutput()->addModuleStyles( ['ext.bootstrap.styles'] );
	$parser->getOutput()->addModules( ['ext.bootstrap.scripts'] );
	return true;
};

Known issues

Effect on Universal Language Selector

If you have the Universal Language Selector (ULS) extension installed, installing the Bootstrap extension will make the ULS's dropdown-menu look disordered and break its search bar (screenshot on GitHub). However, this can be fixed by adding the following code to MediaWiki:Common.css:

.uls-language-list {
        display: block;
}

.uls-search {
        display: block;
}

Siehe auch

Websites

• the Bootstrap framework homepage
• the SASS/SCSS homepage
• the Bootstrap for MediaWiki wiki — Examples and Demos

Skins and Extensions

• the Chameleon skin that uses this extension
• the Medik skin that also uses Bootstrap
• the BootstrapComponents extension that uses this extension and lets editors utilize its potential inside wiki markup

Blog post

• Enhance Your MediaWiki with Bootstrap — Blog post about improving your wiki by integrating it with Bootstrap and its components; published January 20, 2024