Extension:Bootstrap

This page is a translated version of the page Extension:Bootstrap and the translation is 100% complete.

PW
L'équipe Professional Wiki maintient cette extension de manière professionnelle.
Professional Wiki fournit le support officiel uniquement pour les versions LTS de MediaWiki. Il peut fonctionner avec d'autres versions de MediaWiki.
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.2 (2023-06-06)
Politique de compatibilité Pour chaque version de MediaWiki qui est une version avec support à long terme (LTE - Long Term Support) il existe une branche correspondante dans l'extension.
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
README on GitHub
Changelog on GitHub
Téléchargements trimestriels 0

L'extension Bootstrap fournit l'environnement de l'interface utilisateur web Bootstrap 4 (documentation) à MediaWiki. Il peut être activé directement ou utilisé à partir des habillages ou des extensions.

Installation

Voir les instructions d'installation pour plus d'informations sur la façon d'installer cette extension.

Utilisation

A partir d'un habillage

Utiliser \Bootstrap\BootstrapManager::getInstance() pour obtenir le singleton gérant l'environnement de Bootstrap.

Avec l'objet renvoyé,

  • ajouter les modules Bootstrap à l'aide de addBootstrapModule(), addCoreBootstrapModules() et addAllBootstrapModules()
  • définir les variables SCSS en utilisant setScssVariable() et setScssVariables()
  • ajouter les fichiers de style à l'aide de addStyleFile()
  • ajouter les fichiers gérant le cache à l'aide de addCacheTriggerFile()

Enfin, pour ajouter les styles Bootstrap et le JavaScript de la page, utiliser $out->addModuleStyles( 'ext.bootstrap.styles' ) pour les styles et $out->addModules( 'ext.bootstrap.scripts' ) pour les scripts.

Voir l'habillage Chameleon pour obtenir un exemple sur la manière d'inclure les styles Bootstrap dans un habillage.

De manière isolée

Pour activer simplement les styles Bootstrap sur toutes les pages, ajouter le code suivant à votre fichier LocalSettings.php :

$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

Si l'extension Universal Language Selector (ULS) est installée, l'installation de l'extension Bootstrap fera que le menu déroulant de ULS apparaîtra désordonné et cassera le fonctionnement de sa barre de recherche (voir la copie d'écran sur GitHub). Cependant, cela peut être corrigé en ajoutant le code suivant à MediaWiki:Common.css :

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

.uls-search {
        display: block;
}

Voir aussi

Sites web
Habillages et extensions
  • habillage Chameleon utilisant cette extension
  • habillage Medik utilisant également Bootstrap
  • extension BootstrapComponents utilisant cette extension et permettant aux éditeurs d'utiliser potentiellement son balisage wiki interne
Billets de blog