Extension:Bootstrap

PW

The Professional Wiki team maintains this extension professionally.

Professional Wiki provides official support for MediaWiki LTS releases only. It may work with other MediaWiki releases.

MediaWiki 拡張機能マニュアル

Bootstrap リリースの状態: 安定
実装	外装
説明	Provides the Bootstrap 4 web front-end framework
作者	Stephan Gambke (F.trottトーク)
メンテナー	Professional Wiki
最新バージョン	5.0.0 (2024-04-26)
互換性の方針	長期間サポート リリースであるすべての MediaWiki リリースについて、拡張機能に対応するブランチが存在します。
MediaWiki	1.39+
PHP	8.0+
データベースの変更	いいえ
Composer	mediawiki/bootstrap
ライセンス	GNU 一般公衆利用許諾書 3.0 以降
ダウンロード	GitHub: プロジェクトのページ git リポジトリの URL [ヘルプ ] コミット履歴 注: 地域化の更新は translatewiki.net からは提供されません。 README on GitHub Changelog on GitHub
使用するフック 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.

インストール

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

使用法

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

関連項目

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