Extension:Bootstrap/pl
Bootstrap Status wydania: stabilne |
|
---|---|
Realizacja | Skórka |
Opis | Provides the Bootstrap 4 web front-end framework |
Autor(zy) | Stephan Gambke (F.trotttalk) |
Opiekun(owie) | Professional Wiki |
Ostatnia wersja | 4.6.2 (2023-06-06) |
Polityka zgodności | For every MediaWiki release that is a Long Term Support release there is a corresponding branch in the extension. |
MediaWiki | 1.29+ |
PHP | 5.6+ |
Zmiany w bazie danych | Nie |
Composer | mediawiki/bootstrap |
Licencja | GNU General Public License 3.0 or later |
Pobieranie | GitHub:
<translate> Note:</translate> README on GitHub Changelog on GitHub |
Quarterly downloads | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
Public wikis using | Lua error in Module:Extension at line 172: bad argument #1 to 'inNamespace' (unrecognized namespace name 'skin'). |
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.
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 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;
};
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
File:OOjs UI icon information-progressive.svg | <translate> This extension is included in the following wiki farms/hosts and/or packages:</translate>
<translate> This is not an authoritative list.</translate> <translate> Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here.</translate> <translate> Always check with your wiki farms/hosts or bundle to confirm.</translate> |
- Pages with script errors
- Extensions by Professional Wiki/pl
- Pages with broken file links
- Stable extensions/pl
- Skin extensions/pl
- Extensions with manual MediaWiki version
- Extensions supporting Composer/pl
- GPL licensed extensions/pl
- Extensions in GitHub version control/pl
- SetupAfterCache extensions/pl
- All extensions/pl
- Extensions not in ExtensionJson