امتداد:Bootstrap

From mediawiki.org
This page is a translated version of the page Extension:Bootstrap and the translation is 100% complete.
الدليل المرجعي لامتدادات ميدياويكي
OOjs UI icon advanced-invert.svg
Bootstrap
حالة الإصدار مستقر
تنفيذ سمات
بيان يقدم بنية Bootstrap 4 web للواجهة الأمامية
المؤلف/المؤلفون Stephan Gambke (F.trottنقاش)
القائم/القائمون بالصيانة Professional Wiki
آخر إصدار 4.6.0 (2022-03-30)
سياسة التوافق النسخة الرئيسية تحافظ على التوافق مع الإصدارات السابقة.
MediaWiki 1.29+
PHP 5.6+
تغييرات قاعدة البيانات لا
Composer mediawiki/bootstrap
ترخيص رخصة جنو العمومية 3.0 أو ما بعدها
التنزيل
README on GitHub
Changelog on GitHub
تنزيلات ربع سنوية 0 (Ranked 172nd)
استخدام مواقع الويكي العمومية 380 (Ranked 338th)

يقدم امتداد Bootstrap Bootstrap 4(نسخة 4.6.1) وهي بنية وب للواجهة الأمامية في برمجيات ميدياويكي. يمكن تفعيلها مباشرة أو أن تستخدم من السمات أو الامتدادات.

التثبيت

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

المشكلات المعروفة

أثر ذلك على أداة اختيار اللغة العامة

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

انظر أيضا


This extension is professionally maintained by the Professional Wiki team.