Extension:Bootstrap/pl
Status wydania: stabilne |
|
|---|---|
| Realizacja | Skórka |
| Opis | Provides the Bootstrap 5 web front-end framework |
| Autor(zy) | Stephan Gambke (F.trott dyskusja ) |
| Opiekun(owie) | Professional Wiki |
| Ostatnia wersja | 6.0.0 (2026年05月19日) |
| MediaWiki | 1.43+ |
| PHP | 8.1+ |
| Zmiany w bazie danych | Nie |
| Composer | mediawiki/bootstrap |
| Licence | Licencja GNU General Public License 3.0 lub nowsza |
| Pobieranie | GitHub:
Uwaga: README on GitHub Changelog on GitHub |
The Bootstrap extension provides the Bootstrap 5 (documentation) web front-end framework to MediaWiki. It can be activated directly or used from skins or extensions.
Instalacja
See the installation instructions for information on how to install this extension.
Użycie
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(), andaddAllBootstrapModules() - set SCSS variables using
setScssVariable()andsetScssVariables() - 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; }
Zobacz też
- 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
- Extensions by Professional Wiki/pl
- Stable extensions/pl
- Skin extensions/pl
- Extensions supporting Composer/pl
- SetupAfterCache extensions/pl
- GPL licensed extensions/pl
- Extensions in GitHub version control/pl
- All extensions/pl
- Extensions included in BlueSpice/pl
- Extensions included in Canasta/pl
- Extensions included in Miraheze/pl
- Extensions included in MyWikis/pl
- Extensions included in ProWiki/pl
- Extensions included in semantic::core/pl