Extension:Bootstrap

Manuel des extensions MediaWiki

Bootstrap État de la version : stable
Implémentation	Habillage
Description	Fournit l'environnement de l'interface utilisateur web Bootstrap 4
Auteur(s)	Stephan Gambke (F.trottdiscussion)
Maintenance	Professional Wiki
Dernière version	4.6.0 (2022-03-30)
Politique de compatibilité	Le master conserve la compatibilité arrière.
MediaWiki	1.29+
PHP	5.6+
Modifie la base de données	Non
Composer	mediawiki/bootstrap
Licence	Licence publique générale GNU v3.0 ou supérieur
Téléchargement	GitHub: page du projet URL du dépôt git [aide ] historique des validations Note : Aucune mise à jour de localisation n'est fournie par translatewiki.net . README on GitHub Changelog on GitHub
Accroches utilisées SetupAfterCache
Quarterly downloads	0
Public wikis using	380 (Ranked 338th)

L'extension Bootstrap fournit le framework web front-end Bootstrap 4 (version 4.6.1) à MediaWiki. Il peut être activé directement ou utilisé à partir des habillages ou des extensions.

Installation

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

Utilisation

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 on how to include Bootstrap styles in a skin have a look at the Chameleon skin.

Standalone

To simply 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;
};

Problèmes connus

Conséquences sur le Sélecteur universel de langues

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;
}

Voir aussi

• the Bootstrap framework homepage
• the SASS/SCSS homepage
• the Chameleon skin that uses this extension
• the BootstrapComponents extension that uses this extension and lets editors utilize its potential inside wiki markup

This extension is professionally maintained by the Professional Wiki team.