CINXE.COM

<!DOCTYPE html> <html class="client-nojs vector-feature-language-in-header-disabled vector-feature-language-in-main-page-header-disabled vector-feature-sticky-header-disabled vector-feature-page-tools-pinned-disabled vector-feature-toc-pinned-clientpref-1 vector-feature-main-menu-pinned-disabled vector-feature-limited-width-clientpref-1 vector-feature-limited-width-content-enabled vector-feature-custom-font-size-clientpref-1 vector-feature-appearance-pinned-clientpref-1 vector-feature-night-mode-disabled skin-theme-clientpref-day vector-toc-available" lang="en" dir="ltr"> <head> <meta charset="UTF-8"> <title>Extension:Gadgets - MediaWiki</title> <script>(function(){var className="client-js vector-feature-language-in-header-disabled vector-feature-language-in-main-page-header-disabled vector-feature-sticky-header-disabled vector-feature-page-tools-pinned-disabled vector-feature-toc-pinned-clientpref-1 vector-feature-main-menu-pinned-disabled vector-feature-limited-width-clientpref-1 vector-feature-limited-width-content-enabled vector-feature-custom-font-size-clientpref-1 vector-feature-appearance-pinned-clientpref-1 vector-feature-night-mode-disabled skin-theme-clientpref-day vector-toc-available";var cookie=document.cookie.match(/(?:^|; )mediawikiwikimwclientpreferences=([^;]+)/);if(cookie){cookie[1].split('%2C').forEach(function(pref){className=className.replace(new RegExp('(^| )'+pref.replace(/-clientpref-\w+$|[^\w-]+/g,'')+'-clientpref-\\w+( |$)'),'$1'+pref+'$2');});}document.documentElement.className=className;}());RLCONF={"wgBreakFrames":false,"wgSeparatorTransformTable":["",""],"wgDigitTransformTable":["",""], "wgDefaultDateFormat":"dmy","wgMonthNames":["","January","February","March","April","May","June","July","August","September","October","November","December"],"wgRequestId":"c0dcee43-8fa2-463c-81a4-1545008a2851","wgCanonicalNamespace":"Extension","wgCanonicalSpecialPageName":false,"wgNamespaceNumber":102,"wgPageName":"Extension:Gadgets","wgTitle":"Gadgets","wgCurRevisionId":6854487,"wgRevisionId":6854487,"wgArticleId":17182,"wgIsArticle":true,"wgIsRedirect":false,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":["Extensions with release branches compatibility policy","Extensions with manual MediaWiki version","Extensions bundled with MediaWiki 1.18","Stable extensions","Personalization extensions","Special page extensions","API extensions","GPL licensed extensions","Extensions in Wikimedia version control","BeforePageDisplay extensions","CodeEditorGetPageLanguage extensions","ContentHandlerDefaultModelFor extensions","DeleteUnknownPreferences extensions", "GetPreferences extensions","PageDeleteComplete extensions","PageSaveComplete extensions","PreferencesGetIcon extensions","PreferencesGetLegend extensions","ResourceLoaderRegisterModules extensions","UserGetDefaultOptions extensions","GetUserPermissionsErrors extensions","WgQueryPages extensions","All extensions","Extensions used on Wikimedia","Extensions included in BlueSpice","Extensions included in Canasta","Extensions available as Debian packages","Extensions included in Fandom","Extensions included in Miraheze","Extensions included in MyWikis","Extensions included in ProWiki","Extensions included in semantic::core","Extensions included in ShoutWiki","Extensions included in Telepedia","Extensions included in wiki.gg","Extensions included in WikiForge","Gadgets","JavaScript"],"wgPageViewLanguage":"en","wgPageContentLanguage":"en","wgPageContentModel":"wikitext","wgRelevantPageName":"Extension:Gadgets","wgRelevantArticleId":17182,"wgIsProbablyEditable":true, "wgRelevantPageIsProbablyEditable":true,"wgRestrictionEdit":[],"wgRestrictionMove":[],"wgNoticeProject":"mediawiki","wgCiteReferencePreviewsActive":true,"wgMediaViewerOnClick":true,"wgMediaViewerEnabledByDefault":true,"wgVisualEditor":{"pageLanguageCode":"en","pageLanguageDir":"ltr","pageVariantFallbacks":"en"},"wgMFDisplayWikibaseDescriptions":{"search":true,"watchlist":true,"tagline":false,"nearby":true},"wgWMESchemaEditAttemptStepOversample":false,"wgWMEPageLength":20000,"wgInternalRedirectTargetUrl":"/wiki/Extension:Gadgets","wgTranslatePageTranslation":"source","wgCentralAuthMobileDomain":false,"wgEditSubmitButtonLabelPublish":true,"wgULSPosition":"personal","wgULSisCompactLinksEnabled":true,"wgVector2022LanguageInHeader":false,"wgULSisLanguageSelectorEmpty":false,"wgWikibaseItemId":"Q21676981","wgCheckUserClientHintsHeadersJsApi":["brands","architecture","bitness","fullVersionList","mobile","model","platform","platformVersion"]};RLSTATE={"ext.globalCssJs.user.styles":"ready", "site.styles":"ready","user.styles":"ready","ext.globalCssJs.user":"ready","user":"ready","user.options":"loading","ext.translate.tag.languages":"ready","ext.pygments":"ready","skins.vector.search.codex.styles":"ready","skins.vector.styles":"ready","skins.vector.icons":"ready","jquery.tablesorter.styles":"ready","jquery.makeCollapsible.styles":"ready","ext.translate.edit.documentation.styles":"ready","ext.translate":"ready","ext.wikimediamessages.styles":"ready","ext.visualEditor.desktopArticleTarget.noscript":"ready","ext.uls.pt":"ready","wikibase.client.init":"ready","ext.wikimediaBadges":"ready"};RLPAGEMODULES=["mediawiki.action.view.redirect","ext.pygments.view","mediawiki.page.media","site","mediawiki.page.ready","jquery.tablesorter","jquery.makeCollapsible","mediawiki.toc","skins.vector.js","ext.centralNotice.geoIP","ext.centralNotice.startUp","ext.translate.pagetranslation.uls","ext.urlShortener.toolbar","ext.centralauth.centralautologin","mmv.bootstrap", "ext.visualEditor.desktopArticleTarget.init","ext.visualEditor.targetLoader","ext.echo.centralauth","ext.eventLogging","ext.wikimediaEvents","ext.navigationTiming","ext.uls.compactlinks","ext.uls.interface","wikibase.client.vector-2022","ext.checkUser.clientHints","wikibase.sidebar.tracking"];</script> <script>(RLQ=window.RLQ||[]).push(function(){mw.loader.impl(function(){return["user.options@12s5i",function($,jQuery,require,module){mw.user.tokens.set({"patrolToken":"+\\","watchToken":"+\\","csrfToken":"+\\"}); }];});});</script> <link rel="stylesheet" href="/w/load.php?lang=en&modules=ext.pygments%2Ctranslate%2CwikimediaBadges%7Cext.translate.edit.documentation.styles%7Cext.translate.tag.languages%7Cext.uls.pt%7Cext.visualEditor.desktopArticleTarget.noscript%7Cext.wikimediamessages.styles%7Cjquery.makeCollapsible.styles%7Cjquery.tablesorter.styles%7Cskins.vector.icons%2Cstyles%7Cskins.vector.search.codex.styles%7Cwikibase.client.init&only=styles&skin=vector-2022"> <script async="" src="/w/load.php?lang=en&modules=startup&only=scripts&raw=1&skin=vector-2022"></script> <meta name="ResourceLoaderDynamicStyles" content=""> <link rel="stylesheet" href="/w/load.php?lang=en&modules=site.styles&only=styles&skin=vector-2022"> <meta name="generator" content="MediaWiki 1.44.0-wmf.4"> <meta name="referrer" content="origin"> <meta name="referrer" content="origin-when-cross-origin"> <meta name="robots" content="max-image-preview:standard"> <meta name="format-detection" content="telephone=no"> <meta property="og:image" content="https://upload.wikimedia.org/wikipedia/commons/9/94/Screenshot-gadgets-tools.png"> <meta property="og:image:width" content="1200"> <meta property="og:image:height" content="825"> <meta property="og:image" content="https://upload.wikimedia.org/wikipedia/commons/9/94/Screenshot-gadgets-tools.png"> <meta property="og:image:width" content="800"> <meta property="og:image:height" content="550"> <meta property="og:image:width" content="640"> <meta property="og:image:height" content="440"> <meta name="viewport" content="width=1120"> <meta property="og:site_name" content="MediaWiki"> <meta property="og:title" content="Extension:Gadgets - MediaWiki"> <meta property="og:type" content="website"> <link rel="preconnect" href="//upload.wikimedia.org"> <link rel="alternate" media="only screen and (max-width: 640px)" href="//m.mediawiki.org/wiki/Extension:Gadgets"> <link rel="alternate" type="application/x-wiki" title="Edit" href="/w/index.php?title=Extension:Gadgets&action=edit"> <link rel="apple-touch-icon" href="/static/apple-touch/mediawiki.png"> <link rel="icon" href="/static/favicon/mediawiki.ico"> <link rel="search" type="application/opensearchdescription+xml" href="/w/rest.php/v1/search" title="MediaWiki (en)"> <link rel="EditURI" type="application/rsd+xml" href="//www.mediawiki.org/w/api.php?action=rsd"> <link rel="canonical" href="https://www.mediawiki.org/wiki/Extension:Gadgets"> <link rel="license" href="https://creativecommons.org/licenses/by-sa/4.0/"> <link rel="alternate" type="application/atom+xml" title="MediaWiki Atom feed" href="/w/index.php?title=Special:RecentChanges&feed=atom"> <link rel="dns-prefetch" href="//meta.wikimedia.org" /> <link rel="dns-prefetch" href="//login.wikimedia.org"> </head> <body class="skin--responsive skin-vector skin-vector-search-vue mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-102 ns-subject mw-editable page-Extension_Gadgets rootpage-Extension_Gadgets skin-vector-2022 action-view"><a class="mw-jump-link" href="#bodyContent">Jump to content</a> <div class="vector-header-container"> <header class="vector-header mw-header"> <div class="vector-header-start"> <nav class="vector-main-menu-landmark" aria-label="Site"> <div id="vector-main-menu-dropdown" class="vector-dropdown vector-main-menu-dropdown vector-button-flush-left vector-button-flush-right" > <input type="checkbox" id="vector-main-menu-dropdown-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-main-menu-dropdown" class="vector-dropdown-checkbox " aria-label="Main menu" > <label id="vector-main-menu-dropdown-label" for="vector-main-menu-dropdown-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet cdx-button--icon-only " aria-hidden="true" ><span class="vector-icon mw-ui-icon-menu mw-ui-icon-wikimedia-menu"></span> <span class="vector-dropdown-label-text">Main menu</span> </label> <div class="vector-dropdown-content"> <div id="vector-main-menu-unpinned-container" class="vector-unpinned-container"> <div id="vector-main-menu" class="vector-main-menu vector-pinnable-element"> <div class="vector-pinnable-header vector-main-menu-pinnable-header vector-pinnable-header-unpinned" data-feature-name="main-menu-pinned" data-pinnable-element-id="vector-main-menu" data-pinned-container-id="vector-main-menu-pinned-container" data-unpinned-container-id="vector-main-menu-unpinned-container" > <div class="vector-pinnable-header-label">Main menu</div> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-pin-button" data-event-name="pinnable-header.vector-main-menu.pin">move to sidebar</button> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-unpin-button" data-event-name="pinnable-header.vector-main-menu.unpin">hide</button> </div> <div id="p-navigation" class="vector-menu mw-portlet mw-portlet-navigation" > <div class="vector-menu-heading"> Navigation </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="n-mainpage-description" class="mw-list-item"><a href="/wiki/MediaWiki" title="Visit the main page [z]" accesskey="z"><span>Main page</span></a></li><li id="n-mw-download" class="mw-list-item"><a href="/wiki/Download"><span>Get MediaWiki</span></a></li><li id="n-mw-extensions" class="mw-list-item"><a href="/wiki/Special:MyLanguage/Category:Extensions"><span>Get extensions</span></a></li><li id="n-blog-text" class="mw-list-item"><a href="https://techblog.wikimedia.org/"><span>Tech blog</span></a></li><li id="n-mw-contribute" class="mw-list-item"><a href="/wiki/Special:MyLanguage/How_to_contribute"><span>Contribute</span></a></li> </ul> </div> </div> <div id="p-support" class="vector-menu mw-portlet mw-portlet-support" > <div class="vector-menu-heading"> Support </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="n-help" class="mw-list-item"><a href="/wiki/Special:MyLanguage/Help:Contents" title="The place to find out"><span>User help</span></a></li><li id="n-mw-faq" class="mw-list-item"><a href="/wiki/Special:MyLanguage/Manual:FAQ"><span>FAQ</span></a></li><li id="n-mw-manual" class="mw-list-item"><a href="/wiki/Special:MyLanguage/Manual:Contents"><span>Technical manual</span></a></li><li id="n-mw-supportdesk" class="mw-list-item"><a href="/wiki/Project:Support_desk"><span>Support desk</span></a></li><li id="n-mw-communication" class="mw-list-item"><a href="/wiki/Special:MyLanguage/Communication"><span>Communication</span></a></li> </ul> </div> </div> <div id="p-development" class="vector-menu mw-portlet mw-portlet-development" > <div class="vector-menu-heading"> Development </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="n-mw-developerportal" class="mw-list-item"><a href="https://developer.wikimedia.org/"><span>Developer portal</span></a></li><li id="n-svn-statistics" class="mw-list-item"><a href="/wiki/Development_statistics"><span>Code statistics</span></a></li> </ul> </div> </div> <div id="p-mediawiki.org" class="vector-menu mw-portlet mw-portlet-mediawiki_org" > <div class="vector-menu-heading"> mediawiki.org </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="n-portal" class="mw-list-item"><a href="/wiki/Project:Help" title="About the project, what you can do, where to find things"><span>Community portal</span></a></li><li id="n-recentchanges" class="mw-list-item"><a href="/wiki/Special:RecentChanges" title="A list of recent changes in the wiki [r]" accesskey="r"><span>Recent changes</span></a></li><li id="n-mw-translate" class="mw-list-item"><a href="/wiki/Special:LanguageStats"><span>Translate content</span></a></li><li id="n-randompage" class="mw-list-item"><a href="/wiki/Special:Random" title="Load a random page [x]" accesskey="x"><span>Random page</span></a></li><li id="n-mw-discussion" class="mw-list-item"><a href="/wiki/Project:Village_Pump"><span>Village pump</span></a></li><li id="n-Sandboxlink-portlet-label" class="mw-list-item"><a href="/wiki/Project:Sandbox"><span>Sandbox</span></a></li> </ul> </div> </div> <div id="p-lang" class="vector-menu mw-portlet mw-portlet-lang" > <div class="vector-menu-heading"> In other languages </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> </ul> <div class="after-portlet after-portlet-lang"><span class="wb-langlinks-add wb-langlinks-link"><a href="https://www.wikidata.org/wiki/Special:EntityPage/Q21676981#sitelinks-wikipedia" title="Add interlanguage links" class="wbc-editpage">Add links</a></span></div> </div> </div> </div> </div> </div> </div> </nav> <a href="/wiki/MediaWiki" class="mw-logo"> <img class="mw-logo-icon" src="/static/images/icons/mediawikiwiki.svg" alt="" aria-hidden="true" height="50" width="50"> <span class="mw-logo-container skin-invert"> <img class="mw-logo-wordmark" alt="MediaWiki" src="/static/images/mobile/copyright/mediawikiwiki-wordmark.svg" style="width: 7.5em; height: 1.125em;"> </span> </a> </div> <div class="vector-header-end"> <div id="p-search" role="search" class="vector-search-box-vue vector-search-box-collapses vector-search-box-show-thumbnail vector-search-box-auto-expand-width vector-search-box"> <a href="/wiki/Special:Search" class="cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet cdx-button--icon-only search-toggle" title="Search MediaWiki [f]" accesskey="f"><span class="vector-icon mw-ui-icon-search mw-ui-icon-wikimedia-search"></span> <span>Search</span> </a> <div class="vector-typeahead-search-container"> <div class="cdx-typeahead-search cdx-typeahead-search--show-thumbnail cdx-typeahead-search--auto-expand-width"> <form action="/w/index.php" id="searchform" class="cdx-search-input cdx-search-input--has-end-button"> <div id="simpleSearch" class="cdx-search-input__input-wrapper" data-search-loc="header-moved"> <div class="cdx-text-input cdx-text-input--has-start-icon"> <input class="cdx-text-input__input" type="search" name="search" placeholder="Search MediaWiki" aria-label="Search MediaWiki" autocapitalize="sentences" title="Search MediaWiki [f]" accesskey="f" id="searchInput" > <span class="cdx-text-input__icon cdx-text-input__start-icon"></span> </div> <input type="hidden" name="title" value="Special:Search"> </div> <button class="cdx-button cdx-search-input__end-button">Search</button> </form> </div> </div> </div> <nav class="vector-user-links vector-user-links-wide" aria-label="Personal tools"> <div class="vector-user-links-main"> <div id="p-vector-user-menu-preferences" class="vector-menu mw-portlet" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="ca-uls" class="mw-list-item active user-links-collapsible-item"><a data-mw="interface" href="#" class="uls-trigger cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet"><span class="vector-icon mw-ui-icon-wikimedia-language mw-ui-icon-wikimedia-wikimedia-language"></span> <span>English</span></a> </li> </ul> </div> </div> <div id="p-vector-user-menu-userpage" class="vector-menu mw-portlet emptyPortlet" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> </ul> </div> </div> <nav class="vector-appearance-landmark" aria-label="Appearance"> <div id="vector-appearance-dropdown" class="vector-dropdown " title="Change the appearance of the page's font size, width, and color" > <input type="checkbox" id="vector-appearance-dropdown-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-appearance-dropdown" class="vector-dropdown-checkbox " aria-label="Appearance" > <label id="vector-appearance-dropdown-label" for="vector-appearance-dropdown-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet cdx-button--icon-only " aria-hidden="true" ><span class="vector-icon mw-ui-icon-appearance mw-ui-icon-wikimedia-appearance"></span> <span class="vector-dropdown-label-text">Appearance</span> </label> <div class="vector-dropdown-content"> <div id="vector-appearance-unpinned-container" class="vector-unpinned-container"> </div> </div> </div> </nav> <div id="p-vector-user-menu-notifications" class="vector-menu mw-portlet emptyPortlet" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> </ul> </div> </div> <div id="p-vector-user-menu-overflow" class="vector-menu mw-portlet" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="pt-sitesupport-2" class="user-links-collapsible-item mw-list-item user-links-collapsible-item"><a data-mw="interface" href="https://donate.wikimedia.org/?utm_source=donate&utm_medium=sidebar&utm_campaign=spontaneous&uselang=en" class=""><span>Donate</span></a> </li> <li id="pt-createaccount-2" class="user-links-collapsible-item mw-list-item user-links-collapsible-item"><a data-mw="interface" href="/w/index.php?title=Special:CreateAccount&returnto=Extension%3AGadgets" title="You are encouraged to create an account and log in; however, it is not mandatory" class=""><span>Create account</span></a> </li> <li id="pt-login-2" class="user-links-collapsible-item mw-list-item user-links-collapsible-item"><a data-mw="interface" href="/w/index.php?title=Special:UserLogin&returnto=Extension%3AGadgets" title="You are encouraged to log in; however, it is not mandatory [o]" accesskey="o" class=""><span>Log in</span></a> </li> </ul> </div> </div> </div> <div id="vector-user-links-dropdown" class="vector-dropdown vector-user-menu vector-button-flush-right vector-user-menu-logged-out" title="More options" > <input type="checkbox" id="vector-user-links-dropdown-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-user-links-dropdown" class="vector-dropdown-checkbox " aria-label="Personal tools" > <label id="vector-user-links-dropdown-label" for="vector-user-links-dropdown-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet cdx-button--icon-only " aria-hidden="true" ><span class="vector-icon mw-ui-icon-ellipsis mw-ui-icon-wikimedia-ellipsis"></span> <span class="vector-dropdown-label-text">Personal tools</span> </label> <div class="vector-dropdown-content"> <div id="p-personal" class="vector-menu mw-portlet mw-portlet-personal user-links-collapsible-item" title="User menu" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="pt-sitesupport" class="user-links-collapsible-item mw-list-item"><a href="https://donate.wikimedia.org/?utm_source=donate&utm_medium=sidebar&utm_campaign=spontaneous&uselang=en"><span>Donate</span></a></li><li id="pt-createaccount" class="user-links-collapsible-item mw-list-item"><a href="/w/index.php?title=Special:CreateAccount&returnto=Extension%3AGadgets" title="You are encouraged to create an account and log in; however, it is not mandatory"><span class="vector-icon mw-ui-icon-userAdd mw-ui-icon-wikimedia-userAdd"></span> <span>Create account</span></a></li><li id="pt-login" class="user-links-collapsible-item mw-list-item"><a href="/w/index.php?title=Special:UserLogin&returnto=Extension%3AGadgets" title="You are encouraged to log in; however, it is not mandatory [o]" accesskey="o"><span class="vector-icon mw-ui-icon-logIn mw-ui-icon-wikimedia-logIn"></span> <span>Log in</span></a></li> </ul> </div> </div> <div id="p-user-menu-anon-editor" class="vector-menu mw-portlet mw-portlet-user-menu-anon-editor" > <div class="vector-menu-heading"> Pages for logged out editors <a href="/wiki/Help:Introduction" aria-label="Learn more about editing"><span>learn more</span></a> </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="pt-anoncontribs" class="mw-list-item"><a href="/wiki/Special:MyContributions" title="A list of edits made from this IP address [y]" accesskey="y"><span>Contributions</span></a></li><li id="pt-anontalk" class="mw-list-item"><a href="/wiki/Special:MyTalk" title="Discussion about edits from this IP address [n]" accesskey="n"><span>Talk</span></a></li> </ul> </div> </div> </div> </div> </nav> </div> </header> </div> <div class="mw-page-container"> <div class="mw-page-container-inner"> <div class="vector-sitenotice-container"> <div id="siteNotice"></div> </div> <div class="vector-column-start"> <div class="vector-main-menu-container"> <div id="mw-navigation"> <nav id="mw-panel" class="vector-main-menu-landmark" aria-label="Site"> <div id="vector-main-menu-pinned-container" class="vector-pinned-container"> </div> </nav> </div> </div> <div class="vector-sticky-pinned-container"> <nav id="mw-panel-toc" aria-label="Contents" data-event-name="ui.sidebar-toc" class="mw-table-of-contents-container vector-toc-landmark"> <div id="vector-toc-pinned-container" class="vector-pinned-container"> <div id="vector-toc" class="vector-toc vector-pinnable-element"> <div class="vector-pinnable-header vector-toc-pinnable-header vector-pinnable-header-pinned" data-feature-name="toc-pinned" data-pinnable-element-id="vector-toc" > <h2 class="vector-pinnable-header-label">Contents</h2> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-pin-button" data-event-name="pinnable-header.vector-toc.pin">move to sidebar</button> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-unpin-button" data-event-name="pinnable-header.vector-toc.unpin">hide</button> </div> <ul class="vector-toc-contents" id="mw-panel-toc-list"> <li id="toc-mw-content-text" class="vector-toc-list-item vector-toc-level-1"> <a href="#" class="vector-toc-link"> <div class="vector-toc-text">Beginning</div> </a> </li> <li id="toc-Installation" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Installation"> <div class="vector-toc-text"> <span class="vector-toc-numb">1</span> <span>Installation</span> </div> </a> <ul id="toc-Installation-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Usage" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Usage"> <div class="vector-toc-text"> <span class="vector-toc-numb">2</span> <span>Usage</span> </div> </a> <button aria-controls="toc-Usage-sublist" class="cdx-button cdx-button--weight-quiet cdx-button--icon-only vector-toc-toggle"> <span class="vector-icon mw-ui-icon-wikimedia-expand"></span> <span>Toggle Usage subsection</span> </button> <ul id="toc-Usage-sublist" class="vector-toc-list"> <li id="toc-Definition_format" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#Definition_format"> <div class="vector-toc-text"> <span class="vector-toc-numb">2.1</span> <span>Definition format</span> </div> </a> <ul id="toc-Definition_format-sublist" class="vector-toc-list"> <li id="toc-Using_Gadget_Definition_Namespace" class="vector-toc-list-item vector-toc-level-3"> <a class="vector-toc-link" href="#Using_Gadget_Definition_Namespace"> <div class="vector-toc-text"> <span class="vector-toc-numb">2.1.1</span> <span>Using Gadget Definition Namespace</span> </div> </a> <ul id="toc-Using_Gadget_Definition_Namespace-sublist" class="vector-toc-list"> </ul> </li> </ul> </li> <li id="toc-Options" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#Options"> <div class="vector-toc-text"> <span class="vector-toc-numb">2.2</span> <span>Options</span> </div> </a> <ul id="toc-Options-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-User_rights" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#User_rights"> <div class="vector-toc-text"> <span class="vector-toc-numb">2.3</span> <span>User rights</span> </div> </a> <ul id="toc-User_rights-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Pages" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#Pages"> <div class="vector-toc-text"> <span class="vector-toc-numb">2.4</span> <span>Pages</span> </div> </a> <ul id="toc-Pages-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Sections" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#Sections"> <div class="vector-toc-text"> <span class="vector-toc-numb">2.5</span> <span>Sections</span> </div> </a> <ul id="toc-Sections-sublist" class="vector-toc-list"> </ul> </li> </ul> </li> <li id="toc-Popular_gadgets" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Popular_gadgets"> <div class="vector-toc-text"> <span class="vector-toc-numb">3</span> <span>Popular gadgets</span> </div> </a> <ul id="toc-Popular_gadgets-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-See_also" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#See_also"> <div class="vector-toc-text"> <span class="vector-toc-numb">4</span> <span>See also</span> </div> </a> <ul id="toc-See_also-sublist" class="vector-toc-list"> </ul> </li> </ul> </div> </div> </nav> </div> </div> <div class="mw-content-container"> <main id="content" class="mw-body"> <header class="mw-body-header vector-page-titlebar"> <nav aria-label="Contents" class="vector-toc-landmark"> <div id="vector-page-titlebar-toc" class="vector-dropdown vector-page-titlebar-toc vector-button-flush-left" > <input type="checkbox" id="vector-page-titlebar-toc-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-page-titlebar-toc" class="vector-dropdown-checkbox " aria-label="Toggle the table of contents" > <label id="vector-page-titlebar-toc-label" for="vector-page-titlebar-toc-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet cdx-button--icon-only " aria-hidden="true" ><span class="vector-icon mw-ui-icon-listBullet mw-ui-icon-wikimedia-listBullet"></span> <span class="vector-dropdown-label-text">Toggle the table of contents</span> </label> <div class="vector-dropdown-content"> <div id="vector-page-titlebar-toc-unpinned-container" class="vector-unpinned-container"> </div> </div> </div> </nav> <h1 id="firstHeading" class="firstHeading mw-first-heading"><span class="mw-page-title-namespace">Extension</span><span class="mw-page-title-separator">:</span><span class="mw-page-title-main">Gadgets</span></h1> <div class="mw-indicators"> <div id="mw-indicator-phabricator-project" class="mw-indicator"><div class="mw-parser-output"><div class="mw-parser-output"><style data-mw-deduplicate="TemplateStyles:r6605561">.mw-parser-output .tpl-badge{background-color:var(--background-color-progressive-subtle,#eaf3ff);color:var(--color-base,#202122);border-radius:10px;display:inline-block;font-size:90%;padding:5px 8px}</style><div class="tpl-badge"><a href="/wiki/Special:MyLanguage/Phabricator" title="Special:MyLanguage/Phabricator">Issue tracker</a>: <a href="https://phabricator.wikimedia.org/tag/mediawiki-extensions-gadgets/" class="extiw" title="phab:tag/mediawiki-extensions-gadgets/"><b>#mediawiki-extensions-gadgets</b></a></div></div></div></div> </div> </header> <div class="vector-page-toolbar"> <div class="vector-page-toolbar-container"> <div id="left-navigation"> <nav aria-label="Namespaces"> <div id="p-associated-pages" class="vector-menu vector-menu-tabs mw-portlet mw-portlet-associated-pages" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="ca-nstab-extension" class="selected vector-tab-noicon mw-list-item"><a href="/wiki/Extension:Gadgets" title="View the subject page [c]" accesskey="c"><span>Extension</span></a></li><li id="ca-talk" class="vector-tab-noicon mw-list-item"><a href="/wiki/Extension_talk:Gadgets" rel="discussion" title="Discussion about the content page [t]" accesskey="t"><span>Discussion</span></a></li> </ul> </div> </div> <div id="vector-variants-dropdown" class="vector-dropdown emptyPortlet" > <input type="checkbox" id="vector-variants-dropdown-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-variants-dropdown" class="vector-dropdown-checkbox " aria-label="Change language variant" > <label id="vector-variants-dropdown-label" for="vector-variants-dropdown-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet" aria-hidden="true" ><span class="vector-dropdown-label-text">English</span> </label> <div class="vector-dropdown-content"> <div id="p-variants" class="vector-menu mw-portlet mw-portlet-variants emptyPortlet" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> </ul> </div> </div> </div> </div> </nav> </div> <div id="right-navigation" class="vector-collapsible"> <nav aria-label="Views"> <div id="p-views" class="vector-menu vector-menu-tabs mw-portlet mw-portlet-views" > <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="ca-view" class="selected vector-tab-noicon mw-list-item"><a href="/wiki/Extension:Gadgets"><span>Read</span></a></li><li id="ca-edit" class="vector-tab-noicon mw-list-item"><a href="/w/index.php?title=Extension:Gadgets&action=edit" title="Edit the source code of this page [e]" accesskey="e"><span>Edit</span></a></li><li id="ca-history" class="vector-tab-noicon mw-list-item"><a href="/w/index.php?title=Extension:Gadgets&action=history" title="Past revisions of this page [h]" accesskey="h"><span>View history</span></a></li> </ul> </div> </div> </nav> <nav class="vector-page-tools-landmark" aria-label="Page tools"> <div id="vector-page-tools-dropdown" class="vector-dropdown vector-page-tools-dropdown" > <input type="checkbox" id="vector-page-tools-dropdown-checkbox" role="button" aria-haspopup="true" data-event-name="ui.dropdown-vector-page-tools-dropdown" class="vector-dropdown-checkbox " aria-label="Tools" > <label id="vector-page-tools-dropdown-label" for="vector-page-tools-dropdown-checkbox" class="vector-dropdown-label cdx-button cdx-button--fake-button cdx-button--fake-button--enabled cdx-button--weight-quiet" aria-hidden="true" ><span class="vector-dropdown-label-text">Tools</span> </label> <div class="vector-dropdown-content"> <div id="vector-page-tools-unpinned-container" class="vector-unpinned-container"> <div id="vector-page-tools" class="vector-page-tools vector-pinnable-element"> <div class="vector-pinnable-header vector-page-tools-pinnable-header vector-pinnable-header-unpinned" data-feature-name="page-tools-pinned" data-pinnable-element-id="vector-page-tools" data-pinned-container-id="vector-page-tools-pinned-container" data-unpinned-container-id="vector-page-tools-unpinned-container" > <div class="vector-pinnable-header-label">Tools</div> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-pin-button" data-event-name="pinnable-header.vector-page-tools.pin">move to sidebar</button> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-unpin-button" data-event-name="pinnable-header.vector-page-tools.unpin">hide</button> </div> <div id="p-cactions" class="vector-menu mw-portlet mw-portlet-cactions emptyPortlet vector-has-collapsible-items" title="More options" > <div class="vector-menu-heading"> Actions </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="ca-more-view" class="selected vector-more-collapsible-item mw-list-item"><a href="/wiki/Extension:Gadgets"><span>Read</span></a></li><li id="ca-more-edit" class="vector-more-collapsible-item mw-list-item"><a href="/w/index.php?title=Extension:Gadgets&action=edit" title="Edit the source code of this page [e]" accesskey="e"><span>Edit</span></a></li><li id="ca-more-history" class="vector-more-collapsible-item mw-list-item"><a href="/w/index.php?title=Extension:Gadgets&action=history"><span>View history</span></a></li> </ul> </div> </div> <div id="p-tb" class="vector-menu mw-portlet mw-portlet-tb" > <div class="vector-menu-heading"> General </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="t-whatlinkshere" class="mw-list-item"><a href="/wiki/Special:WhatLinksHere/Extension:Gadgets" title="A list of all wiki pages that link here [j]" accesskey="j"><span>What links here</span></a></li><li id="t-recentchangeslinked" class="mw-list-item"><a href="/wiki/Special:RecentChangesLinked/Extension:Gadgets" rel="nofollow" title="Recent changes in pages linked from this page [k]" accesskey="k"><span>Related changes</span></a></li><li id="t-upload" class="mw-list-item"><a href="//commons.wikimedia.org/wiki/Special:UploadWizard" title="Upload files [u]" accesskey="u"><span>Upload file</span></a></li><li id="t-specialpages" class="mw-list-item"><a href="/wiki/Special:SpecialPages" title="A list of all special pages [q]" accesskey="q"><span>Special pages</span></a></li><li id="t-permalink" class="mw-list-item"><a href="/w/index.php?title=Extension:Gadgets&oldid=6854487" title="Permanent link to this revision of this page"><span>Permanent link</span></a></li><li id="t-info" class="mw-list-item"><a href="/w/index.php?title=Extension:Gadgets&action=info" title="More information about this page"><span>Page information</span></a></li><li id="t-cite" class="mw-list-item"><a href="/w/index.php?title=Special:CiteThisPage&page=Extension%3AGadgets&id=6854487&wpFormIdentifier=titleform" title="Information on how to cite this page"><span>Cite this page</span></a></li><li id="t-urlshortener" class="mw-list-item"><a href="/w/index.php?title=Special:UrlShortener&url=https%3A%2F%2Fwww.mediawiki.org%2Fwiki%2FExtension%3AGadgets"><span>Get shortened URL</span></a></li><li id="t-urlshortener-qrcode" class="mw-list-item"><a href="/w/index.php?title=Special:QrCode&url=https%3A%2F%2Fwww.mediawiki.org%2Fwiki%2FExtension%3AGadgets"><span>Download QR code</span></a></li> </ul> </div> </div> <div id="p-coll-print_export" class="vector-menu mw-portlet mw-portlet-coll-print_export" > <div class="vector-menu-heading"> Print/export </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="coll-create_a_book" class="mw-list-item"><a href="/w/index.php?title=Special:Book&bookcmd=book_creator&referer=Extension%3AGadgets"><span>Create a book</span></a></li><li id="coll-download-as-rl" class="mw-list-item"><a href="/w/index.php?title=Special:DownloadAsPdf&page=Extension%3AGadgets&action=show-download-screen"><span>Download as PDF</span></a></li><li id="t-print" class="mw-list-item"><a href="/w/index.php?title=Extension:Gadgets&printable=yes" title="Printable version of this page [p]" accesskey="p"><span>Printable version</span></a></li> </ul> </div> </div> <div id="p-wikibase-otherprojects" class="vector-menu mw-portlet mw-portlet-wikibase-otherprojects" > <div class="vector-menu-heading"> In other projects </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> <li id="t-wikibase" class="wb-otherproject-link wb-otherproject-wikibase-dataitem mw-list-item"><a href="https://www.wikidata.org/wiki/Special:EntityPage/Q21676981" title="Link to connected data repository item [g]" accesskey="g"><span>Wikidata item</span></a></li> </ul> </div> </div> </div> </div> </div> </div> </nav> </div> </div> </div> <div class="vector-column-end"> <div class="vector-sticky-pinned-container"> <nav class="vector-page-tools-landmark" aria-label="Page tools"> <div id="vector-page-tools-pinned-container" class="vector-pinned-container"> </div> </nav> <nav class="vector-appearance-landmark" aria-label="Appearance"> <div id="vector-appearance-pinned-container" class="vector-pinned-container"> <div id="vector-appearance" class="vector-appearance vector-pinnable-element"> <div class="vector-pinnable-header vector-appearance-pinnable-header vector-pinnable-header-pinned" data-feature-name="appearance-pinned" data-pinnable-element-id="vector-appearance" data-pinned-container-id="vector-appearance-pinned-container" data-unpinned-container-id="vector-appearance-unpinned-container" > <div class="vector-pinnable-header-label">Appearance</div> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-pin-button" data-event-name="pinnable-header.vector-appearance.pin">move to sidebar</button> <button class="vector-pinnable-header-toggle-button vector-pinnable-header-unpin-button" data-event-name="pinnable-header.vector-appearance.unpin">hide</button> </div> </div> </div> </nav> </div> </div> <div id="bodyContent" class="vector-body" aria-labelledby="firstHeading" data-mw-ve-target-container> <div class="vector-body-before-content"> <div id="siteSub" class="noprint">From mediawiki.org</div> </div> <div id="contentSub"><div id="mw-content-subtitle"></div></div> <div id="mw-content-text" class="mw-body-content"><div class="mw-pt-translate-header noprint nomobile" dir="ltr" lang="en"><a href="/w/index.php?title=Special:Translate&group=page-Extension%3AGadgets&action=page&filter=&action_source=translate_page" title="Special:Translate">Translate this page</a></div><div class="mw-content-ltr mw-parser-output" lang="en" dir="ltr"><div class="mw-pt-languages noprint navigation-not-searchable" lang="en" dir="ltr"><div class="mw-pt-languages-label">Languages:</div><ul class="mw-pt-languages-list"><li><a href="/wiki/Extension:Gadgets/de" class="mw-pt-progress mw-pt-progress--med" title="Extension:Gadgets (26% translated)" lang="de" dir="ltr">Deutsch</a></li> <li><span class="mw-pt-languages-ui mw-pt-languages-selected mw-pt-progress mw-pt-progress--complete" lang="en" dir="ltr">English</span></li> <li><a href="/wiki/Extension:Gadgets/dtp" class="mw-pt-progress mw-pt-progress--low" title="Extension:Gadgets/dtp (3% translated)" lang="dtp" dir="ltr">Kadazandusun</a></li> <li><a href="/wiki/Extension:Gadgets/tr" class="mw-pt-progress mw-pt-progress--med" title="Extension:Gadgets (65% translated)" lang="tr" dir="ltr">Türkçe</a></li> <li><a href="/wiki/Extension:Gadgets/es" class="mw-pt-progress mw-pt-progress--complete" title="Extensión:Accesorios (100% translated)" lang="es" dir="ltr">español</a></li> <li><a href="/wiki/Extension:Gadgets/fr" class="mw-pt-progress mw-pt-progress--complete" title="Extension:Gadgets (100% translated)" lang="fr" dir="ltr">français</a></li> <li><a href="/wiki/Extension:Gadgets/lt" class="mw-pt-progress mw-pt-progress--low" title="Extension:Gadgets/lt (2% translated)" lang="lt" dir="ltr">lietuvių</a></li> <li><a href="/wiki/Extension:Gadgets/pl" class="mw-pt-progress mw-pt-progress--low" title="Extension:Gadgets/pl (5% translated)" lang="pl" dir="ltr">polski</a></li> <li><a href="/wiki/Extension:Gadgets/pt" class="mw-pt-progress mw-pt-progress--high" title="Extension:Gadgets/pt (81% translated)" lang="pt" dir="ltr">português</a></li> <li><a href="/wiki/Extension:Gadgets/fi" class="mw-pt-progress mw-pt-progress--low" title="Extension:Gadgets/fi (1% translated)" lang="fi" dir="ltr">suomi</a></li> <li><a href="/wiki/Extension:Gadgets/sv" class="mw-pt-progress mw-pt-progress--low" title="Extension:Gadgets (14% translated)" lang="sv" dir="ltr">svenska</a></li> <li><a href="/wiki/Extension:Gadgets/cs" class="mw-pt-progress mw-pt-progress--low" title="Rozšíření:Gadgets (2% translated)" lang="cs" dir="ltr">čeština</a></li> <li><a href="/wiki/Extension:Gadgets/ru" class="mw-pt-progress mw-pt-progress--med" title="Расширение:Гаджеты (32% translated)" lang="ru" dir="ltr">русский</a></li> <li><a href="/wiki/Extension:Gadgets/uz-cyrl" class="mw-pt-progress mw-pt-progress--low" title="Kengaytma:Gadjetlar (4% translated)" lang="uz-Cyrl" dir="ltr">ўзбекча</a></li> <li><a href="/wiki/Extension:Gadgets/ar" class="mw-pt-progress mw-pt-progress--complete" title="امتداد:إضافات (100% translated)" lang="ar" dir="rtl">العربية</a></li> <li><a href="/wiki/Extension:Gadgets/bn" class="mw-pt-progress mw-pt-progress--low" title="এক্সটেনশন:গ্যাজেটসমূহ (12% translated)" lang="bn" dir="ltr">বাংলা</a></li> <li><a href="/wiki/Extension:Gadgets/th" class="mw-pt-progress mw-pt-progress--med" title="ส่วนขยาย:อุปกรณ์เสริม (35% translated)" lang="th" dir="ltr">ไทย</a></li> <li><a href="/wiki/Extension:Gadgets/zh" class="mw-pt-progress mw-pt-progress--high" title="Extension: (85% translated)" lang="zh" dir="ltr">中文</a></li> <li><a href="/wiki/Extension:Gadgets/ja" class="mw-pt-progress mw-pt-progress--med" title="Extension:Gadgets (57% translated)" lang="ja" dir="ltr">日本語</a></li> <li><a href="/wiki/Extension:Gadgets/ko" class="mw-pt-progress mw-pt-progress--med" title="확장기능:가젯 (19% translated)" lang="ko" dir="ltr">한국어</a></li></ul></div> <style data-mw-deduplicate="TemplateStyles:r6651107">.mw-parser-output .note{background-position:left 7px top 50%;padding:0.5em 0.5em 0.5em 40px;margin:0.5em 0;overflow:hidden;background-color:#f8f9fa;color:#333;background-repeat:no-repeat;border:1px solid #ddd}.mw-parser-output .note-inline{display:inline-block;vertical-align:middle}.mw-parser-output .note-info{background-color:#eaf3ff;color:#333;background-image:url("https://upload.wikimedia.org/wikipedia/commons/e/ec/OOjs_UI_icon_information-progressive.svg");background-size:25px;border-color:#a3caff;padding-left:40px;min-height:25px}.mw-parser-output .note-reminder{background-color:#fff9ea;color:#333;background-image:url("https://upload.wikimedia.org/wikipedia/commons/a/a8/OOjs_UI_icon_lightbulb-yellow.svg");background-size:25px;border-color:#fc3;min-height:25px}.mw-parser-output .note-warn{background-color:#fff9ea;color:#333;background-image:url("https://upload.wikimedia.org/wikipedia/commons/3/3b/OOjs_UI_icon_alert-warning.svg");background-size:25px;border-color:#fc3;min-height:25px}.mw-parser-output .note-error{background-color:#fee7e6;color:#333;background-image:url("https://upload.wikimedia.org/wikipedia/commons/b/bf/OOjs_UI_icon_notice-destructive.svg");background-size:25px;border-color:#c33;min-height:25px}@media screen{html.skin-theme-clientpref-night .mw-parser-output .note{background-color:transparent;color:inherit}}@media screen and (prefers-color-scheme:dark){html.skin-theme-clientpref-os .mw-parser-output .note{background-color:transparent;color:inherit}}</style><div role="note" class="note note-info">This extension <a href="/wiki/Special:MyLanguage/MediaWiki_1.18#Bundled_extensions" title="Special:MyLanguage/MediaWiki 1.18">comes with MediaWiki 1.18</a> and above. Thus you do not have to download it again. However, you still need to follow the other instructions provided.</div> <style data-mw-deduplicate="TemplateStyles:r6651102">.mw-parser-output .infobox{box-sizing:border-box;border:2px solid var(--border-color-base,#a2a9b1);width:280px;border-collapse:collapse;border-spacing:0;background-color:white;color:#333;clear:right;float:right;margin:0 0 0.5em 0.5em}.mw-parser-output .infobox-rtl{clear:left;float:left;margin:0 0.5em 0.5em 0}.mw-parser-output .infobox th{text-align:left;padding:0.2em 0.5em;vertical-align:top}.mw-parser-output .infobox-rtl th{text-align:right}@media(max-width:719px){body.mediawiki .mw-parser-output .infobox{float:none;clear:both;width:100%;margin:0 0 .5em 0}}.mw-parser-output .infobox td{border:none;padding:0.2em 0.5em;vertical-align:top}.mw-parser-output .infobox-header{background-color:#a2a9b1;color:#FFF;text-align:left}.mw-parser-output .infobox-header a{color:#FFF}.mw-parser-output .infobox-header td,.mw-parser-output .infobox-header th{padding:0.5em 0.5em}.mw-parser-output .infobox-header img{padding:0 0.2em 0 0.5em}@media screen{html.skin-theme-clientpref-night .mw-parser-output .infobox{background-color:inherit;color:inherit}}@media screen and (prefers-color-scheme:dark){html.skin-theme-clientpref-os .mw-parser-output .infobox{background-color:inherit;color:inherit}}</style><style data-mw-deduplicate="TemplateStyles:r5577029">.mw-parser-output .ext-infobox>tbody>tr>td:first-child{vertical-align:top}.mw-parser-output .ext-infobox>tbody>tr>td abbr{white-space:nowrap}.mw-parser-output .ext-infobox .mw-collapsible-header,.mw-parser-output .ext-infobox .mw-collapsible-toggle{font-weight:bold}.mw-parser-output .ext-infobox .mw-collapsible-content{margin-top:.2em;padding-top:.2em}.mw-parser-output .ext-infobox-header>th,.mw-parser-output .ext-infobox caption,.mw-parser-output .ext-infobox-image,.mw-parser-output .ext-infobox-translate{text-align:center}.mw-parser-output .ext-infobox-name{font-size:130%;line-height:100%}.mw-parser-output .ext-infobox-type{min-width:7em}</style><style data-mw-deduplicate="TemplateStyles:r6424453">.mw-parser-output .ext-status-unstable,.mw-parser-output .ext-status-unstable td{border-color:#d33}.mw-parser-output .ext-status-unstable .ext-infobox-header{background-color:#d33;color:#fff}.mw-parser-output .ext-status-unstable .ext-infobox-header a{color:#fff}.mw-parser-output .ext-status-experimental,.mw-parser-output .ext-status-experimental td{border-color:#ff4500}.mw-parser-output .ext-status-experimental .ext-infobox-header{background-color:#ff4500;color:#FFF}.mw-parser-output .ext-status-experimental .ext-infobox-header a{color:#FFF}.mw-parser-output .ext-status-beta,.mw-parser-output .ext-status-beta td{border-color:#fc3}.mw-parser-output .ext-status-beta .ext-infobox-header{color:#000;background-color:#fc3}.mw-parser-output .ext-status-beta .ext-infobox-header a{color:#000}.mw-parser-output .ext-status-stable,.mw-parser-output .ext-status-stable td{border-color:#00af89}.mw-parser-output .ext-status-stable .ext-infobox-header{background-color:#068468;color:#FFF}.mw-parser-output .ext-status-stable .ext-infobox-header a{color:#fff}.mw-parser-output .ext-status-unmaintained,.mw-parser-output .ext-status-unmaintained td{border-color:#ac6600}.mw-parser-output .ext-status-unmaintained .ext-infobox-header{background-color:#ac6600;color:#FFF}.mw-parser-output .ext-status-unmaintained .ext-infobox-header a{color:#fff}</style> <table class="infobox infobox-ltr ext-infobox ext-status-stable"> <caption><b><a href="/wiki/Special:MyLanguage/Manual:Extensions" title="Special:MyLanguage/Manual:Extensions">MediaWiki extensions manual</a><span style="display:none"><a href="/wiki/Manual:Extensions" title="Manual:Extensions"> </a></span></b></caption> <tbody><tr class="infobox-header ext-infobox-header notheme"> <th colspan="2"><figure class="mw-halign-left" typeof="mw:File"><a href="/wiki/Special:MyLanguage/Template:Extension#Content" title="Special:MyLanguage/Template:Extension"><img src="//upload.wikimedia.org/wikipedia/commons/thumb/1/1b/OOjs_UI_icon_advanced-invert.svg/40px-OOjs_UI_icon_advanced-invert.svg.png" decoding="async" width="40" height="40" class="mw-file-element" srcset="//upload.wikimedia.org/wikipedia/commons/thumb/1/1b/OOjs_UI_icon_advanced-invert.svg/60px-OOjs_UI_icon_advanced-invert.svg.png 1.5x, //upload.wikimedia.org/wikipedia/commons/thumb/1/1b/OOjs_UI_icon_advanced-invert.svg/80px-OOjs_UI_icon_advanced-invert.svg.png 2x" data-file-width="20" data-file-height="20" /></a><figcaption></figcaption></figure> <span class="ext-infobox-name">Gadgets</span><br /> <a href="/wiki/Special:MyLanguage/Extension_status" title="Special:MyLanguage/Extension status">Release status:</a><span style="display:none"><a href="/wiki/Extension_status" title="Extension status"> </a></span> stable</th> </tr> <tr> <td colspan="2" class="ext-infobox-image"><span typeof="mw:File"><a href="/wiki/File:Screenshot-gadgets-tab-vector-skin.png" class="mw-file-description"><img src="//upload.wikimedia.org/wikipedia/commons/9/94/Screenshot-gadgets-tab-vector-skin.png" decoding="async" width="300" height="65" class="mw-file-element" data-file-width="266" data-file-height="58" /></a></span></td> </tr> <tr> <td class="ext-infobox-type"><b><a href="/wiki/Special:MyLanguage/Template:Extension#type" title="Special:MyLanguage/Template:Extension">Implementation</a><span style="display:none"><a href="/wiki/Template:Extension#type" title="Template:Extension"> </a></span></b></td> <td><a href="/wiki/Special:MyLanguage/Manual:Personalization" title="Special:MyLanguage/Manual:Personalization">MyWiki</a><span style="display:none"><a href="/wiki/Manual:Personalization" title="Manual:Personalization"> </a></span>, <a href="/wiki/Special:MyLanguage/Manual:Special_pages" title="Special:MyLanguage/Manual:Special pages">Special page</a><span style="display:none"><a href="/wiki/Manual:Special_pages" title="Manual:Special pages"> </a></span>, <a href="/wiki/Special:MyLanguage/API:Action_API" title="Special:MyLanguage/API:Action API">API</a><span style="display:none"><a href="/wiki/API:Action_API" class="mw-redirect" title="API:Action API"> </a></span> </td></tr><tr> <td><b><a href="/wiki/Special:MyLanguage/Template:Extension#description" title="Special:MyLanguage/Template:Extension">Description</a><span style="display:none"><a href="/wiki/Template:Extension#description" title="Template:Extension"> </a></span></b></td> <td>Allow users to enable JS-based, user-provided gadgets from their preferences page</td> </tr> <tr> <td><b><a href="/wiki/Special:MyLanguage/Template:Extension#username" title="Special:MyLanguage/Template:Extension">Author(s)</a><span style="display:none"><a href="/wiki/Template:Extension#username" title="Template:Extension"> </a></span></b></td> <td>Daniel Kinzler (<a href="/wiki/User:Duesentrieb" title="User:Duesentrieb">Duesentrieb</a><sup><a href="/wiki/User_talk:Duesentrieb" title="User talk:Duesentrieb">talk</a></sup>)</td> </tr> <tr> <td><b><a href="/wiki/Special:MyLanguage/Compatibility#mediawiki_extensions" title="Special:MyLanguage/Compatibility">Compatibility policy</a><span style="display:none"><a href="/wiki/Compatibility#mediawiki_extensions" title="Compatibility"> </a></span></b></td> <td>Snapshots releases along with MediaWiki. Master is not backward compatible.</td> </tr> <tr> <td><a href="/wiki/Special:MyLanguage/Template:Extension#mediawiki" title="Special:MyLanguage/Template:Extension"><b>MediaWiki</b></a><span style="display:none"><a href="/wiki/Template:Extension#mediawiki" title="Template:Extension"> </a></span></td> <td>1.19+ </td> </tr> <tr> <td><b><a href="/wiki/Special:MyLanguage/Template:Extension#license" title="Special:MyLanguage/Template:Extension">License</a><span style="display:none"><a href="/wiki/Template:Extension#license" title="Template:Extension"> </a></span></b></td> <td><a rel="nofollow" class="external text" href="//www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html">GNU General Public License 2.0 or later</a></td> </tr><tr> <td><b>Download</b></td> <td><div class="plainlinks"><a href="/wiki/Special:ExtensionDistributor/Gadgets" title="Special:ExtensionDistributor/Gadgets"><b>Download extension</b></a> <br />Git <sup>[<a href="/wiki/Special:MyLanguage/Download_from_Git" title="Special:MyLanguage/Download from Git">?</a>]</sup>: <ul><li><span class="plainlinks"><a rel="nofollow" class="external text" href="https://github.com/wikimedia/mediawiki-extensions-Gadgets/archive/master.tar.gz">Download Git master</a></span></li> <li><a href="https://gerrit.wikimedia.org/g/mediawiki/extensions/Gadgets" class="extiw" title="git:mediawiki/extensions/Gadgets">browse repository</a> (<a href="https://phabricator.wikimedia.org/diffusion/EGAD" class="extiw" title="phab:diffusion/EGAD">Phabricator</a> · <a rel="nofollow" class="external text" href="https://github.com/wikimedia/mediawiki-extensions-Gadgets">GitHub</a>)</li> <li><a href="https://gerrit.wikimedia.org/g/mediawiki/extensions/Gadgets/%2Blog/master" class="extiw" title="git:mediawiki/extensions/Gadgets/+log/master">commit history</a></li> <li><a rel="nofollow" class="external text" href="https://github.com/wikimedia/mediawiki-extensions-Gadgets/graphs/contributors">repository contributors (GitHub)</a></li> <li><a href="https://gerrit.wikimedia.org/r/q/project:mediawiki/extensions/Gadgets" class="extiw" title="gerrit:q/project:mediawiki/extensions/Gadgets">code review</a></li></ul></div><br /><a href="https://gerrit.wikimedia.org/g/mediawiki/extensions/Gadgets/%2B/HEAD/README.md" class="extiw" title="git:mediawiki/extensions/Gadgets/+/HEAD/README.md">README</a></td> </tr> <tr> <td><b><a href="/wiki/Special:MyLanguage/Template:Extension#example" title="Special:MyLanguage/Template:Extension">Example</a><span style="display:none"><a href="/wiki/Template:Extension#example" title="Template:Extension"> </a></span></b></td> <td>Wikimedia Commons: <a href="https://commons.wikimedia.org/wiki/Special:Gadgets" class="extiw" title="commons:Special:Gadgets">Gadget overview</a>, <a href="https://commons.wikimedia.org/wiki/Special:Preferences#mw-prefsection-gadgets" class="extiw" title="commons:Special:Preferences">user preferences</a> (click "Gadgets"; you need to be logged in of course)</td> </tr> <tr> <td class="mw-collapsible mw-collapsed" colspan="2"> <div class="mw-collapsible-header"><a href="/wiki/Special:MyLanguage/Template:Extension#parameters" title="Special:MyLanguage/Template:Extension">Parameters</a><span style="display:none"><a href="/wiki/Template:Extension#parameters" title="Template:Extension"> </a></span></div> <div class="mw-collapsible-content"> <ul><li><span class="configvariable">$wgGadgetsRepo</span></li> <li><span class="configvariable">$wgSpecialGadgetUsageActiveUsers</span></li></ul></div></td> </tr> <tr> <td class="mw-collapsible mw-collapsed" colspan="2"> <div class="mw-collapsible-header"><a href="/wiki/Special:MyLanguage/Template:Extension#hook" title="Special:MyLanguage/Template:Extension">Hooks used</a><span style="display:none"><a href="/wiki/Template:Extension#hook" title="Template:Extension"> </a></span></div> <style data-mw-deduplicate="TemplateStyles:r6219282">.mw-parser-output .plainlist ul{line-height:inherit;list-style:none none;margin:0}.mw-parser-output .plainlist ul li{margin-bottom:0}</style><div class="plainlist mw-collapsible-content"><ul><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/BeforePageDisplay" title="Special:MyLanguage/Manual:Hooks/BeforePageDisplay">BeforePageDisplay</a><span style="display:none"><a href="/wiki/Manual:Hooks/BeforePageDisplay" title="Manual:Hooks/BeforePageDisplay"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/CodeEditorGetPageLanguage" title="Special:MyLanguage/Manual:Hooks/CodeEditorGetPageLanguage">CodeEditorGetPageLanguage</a><span style="display:none"><a href="/wiki/Manual:Hooks/CodeEditorGetPageLanguage" class="mw-redirect" title="Manual:Hooks/CodeEditorGetPageLanguage"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/ContentHandlerDefaultModelFor" title="Special:MyLanguage/Manual:Hooks/ContentHandlerDefaultModelFor">ContentHandlerDefaultModelFor</a><span style="display:none"><a href="/wiki/Manual:Hooks/ContentHandlerDefaultModelFor" title="Manual:Hooks/ContentHandlerDefaultModelFor"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/DeleteUnknownPreferences" title="Special:MyLanguage/Manual:Hooks/DeleteUnknownPreferences">DeleteUnknownPreferences</a><span style="display:none"><a href="/wiki/Manual:Hooks/DeleteUnknownPreferences" title="Manual:Hooks/DeleteUnknownPreferences"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/GetPreferences" title="Special:MyLanguage/Manual:Hooks/GetPreferences">GetPreferences</a><span style="display:none"><a href="/wiki/Manual:Hooks/GetPreferences" title="Manual:Hooks/GetPreferences"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/PageDeleteComplete" title="Special:MyLanguage/Manual:Hooks/PageDeleteComplete">PageDeleteComplete</a><span style="display:none"><a href="/wiki/Manual:Hooks/PageDeleteComplete" title="Manual:Hooks/PageDeleteComplete"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/PageSaveComplete" title="Special:MyLanguage/Manual:Hooks/PageSaveComplete">PageSaveComplete</a><span style="display:none"><a href="/wiki/Manual:Hooks/PageSaveComplete" title="Manual:Hooks/PageSaveComplete"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/PreferencesGetIcon" title="Special:MyLanguage/Manual:Hooks/PreferencesGetIcon">PreferencesGetIcon</a><span style="display:none"><a href="/wiki/Manual:Hooks/PreferencesGetIcon" title="Manual:Hooks/PreferencesGetIcon"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/PreferencesGetLegend" title="Special:MyLanguage/Manual:Hooks/PreferencesGetLegend">PreferencesGetLegend</a><span style="display:none"><a href="/wiki/Manual:Hooks/PreferencesGetLegend" title="Manual:Hooks/PreferencesGetLegend"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/ResourceLoaderRegisterModules" title="Special:MyLanguage/Manual:Hooks/ResourceLoaderRegisterModules">ResourceLoaderRegisterModules</a><span style="display:none"><a href="/wiki/Manual:Hooks/ResourceLoaderRegisterModules" title="Manual:Hooks/ResourceLoaderRegisterModules"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/UserGetDefaultOptions" title="Special:MyLanguage/Manual:Hooks/UserGetDefaultOptions">UserGetDefaultOptions</a><span style="display:none"><a href="/wiki/Manual:Hooks/UserGetDefaultOptions" title="Manual:Hooks/UserGetDefaultOptions"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/getUserPermissionsErrors" title="Special:MyLanguage/Manual:Hooks/getUserPermissionsErrors">getUserPermissionsErrors</a><span style="display:none"><a href="/wiki/Manual:Hooks/getUserPermissionsErrors" title="Manual:Hooks/getUserPermissionsErrors"> </a></span></li><li><a href="/wiki/Special:MyLanguage/Manual:Hooks/wgQueryPages" title="Special:MyLanguage/Manual:Hooks/wgQueryPages">wgQueryPages</a><span style="display:none"><a href="/wiki/Manual:Hooks/wgQueryPages" title="Manual:Hooks/wgQueryPages"> </a></span></li></ul></div> </td> </tr> <tr> <td title="This only includes downloads from Special:ExtensionDistributor. Other download methods such as git or bundled extensions are not included."><b>Quarterly downloads</b></td> <td>119 (Ranked 48<sup>th</sup>)</td> </tr> <tr> <td title=""><a rel="nofollow" class="external text" href="https://wikiapiary.com/wiki/Extension:Gadgets"><b>Public wikis using</b></a></td> <td>4,529 (Ranked 177<sup>th</sup>)</td> </tr> <tr> <td colspan="2" class="ext-infobox-translate"> <a href="https://translatewiki.net/wiki/Special:Translate/ext-gadgets" class="extiw" title="translatewiki:Special:Translate/ext-gadgets">Translate the Gadgets extension</a> if it is available at translatewiki.net</td> </tr><tr class="mw-empty-elt"> </tr> <tr> <td> <b><a href="/wiki/Special:MyLanguage/Phabricator" title="Special:MyLanguage/Phabricator">Issues</a><span style="display:none"><a href="/wiki/Phabricator" title="Phabricator"> </a></span></b></td> <td><a href="https://phabricator.wikimedia.org/tag/mediawiki-extensions-gadgets" class="extiw" title="phab:tag/mediawiki-extensions-gadgets">Open tasks</a> · <a class="external text" href="https://phabricator.wikimedia.org/maniphest/task/create/?projects=mediawiki-extensions-gadgets">Report a bug</a></td> </tr> </tbody></table> <p>The <b>Gadgets</b> extension allows users to select JavaScript or CSS-based "gadgets" provided by other wiki users. </p><p>Gadgets are made up of JavaScript and/or CSS <a href="/wiki/Special:MyLanguage/snippets" title="Special:MyLanguage/snippets">Snippets</a><span style="display:none"><a href="/wiki/Snippets" title="Snippets"> </a></span> located on pages in the MediaWiki namespace. Each gadget is defined by a line in <a href="/wiki/MediaWiki:Gadgets-definition" title="MediaWiki:Gadgets-definition">MediaWiki:Gadgets-definition</a>, providing a name and description for the gadget, and a list of the JS and CSS snippets that it uses (see the <i><a href="#Usage">Usage</a></i> section below). </p><p>Since Gadgets reside in the MediaWiki namespace (the list defining the gadgets as well as the actual code snippets), only sysops (interface admins from 1.32) can edit the code. This is as it should be: only users especially trusted by the wiki community should be able to edit JavaScript code used by other users since JavaScript can easily be used to hijack accounts or spy on people. </p> <meta property="mw:PageProp/toc" /> <div class="mw-heading mw-heading2"><h2 id="Installation">Installation</h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=1" title="Edit section: Installation"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <ul><li><a href="/wiki/Special:ExtensionDistributor/Gadgets" title="Special:ExtensionDistributor/Gadgets">Download</a> and move the extracted <code>Gadgets</code> folder to your <code>extensions/</code> directory.<br />Developers and code contributors should install the extension <a href="/wiki/Special:MyLanguage/Download_from_Git" title="Special:MyLanguage/Download from Git">from Git</a> instead, using:<code class="mw-code mw-highlight" style="display:block">cd extensions/<br />git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Gadgets</code></li> <li>Add the following code at the bottom of your <a href="/wiki/Special:MyLanguage/Manual:LocalSettings.php" title="Special:MyLanguage/Manual:LocalSettings.php">LocalSettings.php</a><span style="display:none"><a href="/wiki/Manual:LocalSettings.php" title="Manual:LocalSettings.php"> </a></span> file: <div class="mw-highlight mw-highlight-lang-php mw-content-ltr" dir="ltr"><pre><span></span><span class="nx">wfLoadExtension</span><span class="p">(</span> <span class="s1">'Gadgets'</span> <span class="p">);</span> </pre></div></li> <li><span typeof="mw:File"><span><img alt="Yes" src="//upload.wikimedia.org/wikipedia/commons/thumb/f/f6/OOjs_UI_icon_check-constructive.svg/15px-OOjs_UI_icon_check-constructive.svg.png" decoding="async" width="15" height="15" class="mw-file-element" srcset="//upload.wikimedia.org/wikipedia/commons/thumb/f/f6/OOjs_UI_icon_check-constructive.svg/23px-OOjs_UI_icon_check-constructive.svg.png 1.5x, //upload.wikimedia.org/wikipedia/commons/thumb/f/f6/OOjs_UI_icon_check-constructive.svg/30px-OOjs_UI_icon_check-constructive.svg.png 2x" data-file-width="20" data-file-height="20" /></span></span> <b>Done</b> – Navigate to <a href="/wiki/Special:Version" title="Special:Version">Special:Version</a> on your wiki to verify that the extension is successfully installed.</li></ul> <div class="mw-heading mw-heading2"><h2 id="Usage">Usage</h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=2" title="Edit section: Usage"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <figure typeof="mw:File/Thumb"><a href="/wiki/File:Screenshot-gadgets-tools.png" class="mw-file-description"><img src="//upload.wikimedia.org/wikipedia/commons/thumb/9/94/Screenshot-gadgets-tools.png/250px-Screenshot-gadgets-tools.png" decoding="async" width="250" height="172" class="mw-file-element" srcset="//upload.wikimedia.org/wikipedia/commons/thumb/9/94/Screenshot-gadgets-tools.png/375px-Screenshot-gadgets-tools.png 1.5x, //upload.wikimedia.org/wikipedia/commons/9/94/Screenshot-gadgets-tools.png 2x" data-file-width="467" data-file-height="321" /></a><figcaption>Selection of some gadgets at the user preferences in de.wikipedia</figcaption></figure> <p>Once <b><a href="/wiki/MediaWiki:Gadgets-definition" title="MediaWiki:Gadgets-definition">MediaWiki:Gadgets-definition</a></b> is created with at least one valid gadget, a new "Gadgets" section will be shown on <a href="/wiki/Special:Preferences" title="Special:Preferences">Special:Preferences</a> for all users. Users can enable the gadgets they would like to use there. An overview of gadgets currently defined by MediaWiki:Gadgets-definition is also rendered on <b><a href="/wiki/Special:Gadgets" title="Special:Gadgets">Special:Gadgets</a></b>, along with helpful links to the relevant localisation and script/style pages for easy creation or editing. Statistics about gadget preferences are available at <b><a href="/wiki/Special:GadgetUsage" title="Special:GadgetUsage">Special:GadgetUsage</a></b>. </p><p><span class="anchor" id="Format"></span><span class="anchor" id="Using_MediaWiki_Gadgets_Definition"></span> </p> <div class="mw-heading mw-heading3"><h3 id="Definition_format">Definition format</h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=3" title="Edit section: Definition format"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>Each line on the MediaWiki:Gadgets-definition page should start with a "*" (asterisk) character to define a gadget. The line takes the following format: </p> <pre>* mygadget [<i>options</i>] | <i>page names</i> </pre> <p>The first field ("<span style="color:green">mygadget</span>" in the example) is the gadget's <i>internal name</i>. The label for the preferences page comes from an interface message page (<b>MediaWiki:Gadget-<span style="color:green">mygadget</span></b>) where the proper name and a short description can be written, which also allows wikitext markup to be used. </p> <link rel="mw-deduplicated-inline-style" href="mw-data:TemplateStyles:r6651107"><div role="note" class="note note-info">The <i>internal name</i> must begin with a basic Latin letter (<code>[A-Za-z]</code>) and may be followed by any number of letters, digits (<code>[0-9]</code>), hyphens (<code>-</code>), underscores (<code>_</code>), and periods (<code>.</code>). The reason for this limitation is that the internal name must be valid as the name of an <a rel="nofollow" class="external text" href="https://www.w3.org/TR/html4/types.html#type-id">HTML form name</a>, as MediaWiki interface message key, and as ResourceLoader module name.</div> <p>Options format: </p><p><code>[ResourceLoader | option1 | option2 | ... optionN]</code> </p><p>The ResourceLoader flag is required unless the gadget contains only styles. Options that are "flags" only need to have their name written to be turned on. Options that need a value are followed by an equals sign and a comma-separated list of values. All whitespace is optional and may be omitted. </p><p><code>[ResourceLoader | myflag | mykey = value1, value2, value3 ]</code> </p><p>Examples: </p> <pre>* mygadget[ResourceLoader]|mygadget.js|mygadget.css</pre> <p>or </p> <pre>* mygadget[ResourceLoader|package]| mygadget.js | mygadget-Foo.js | mygadget-data.json | mygadget.css</pre> <p>or </p> <pre>* mygadget[ ResourceLoader | rights=foo, bar ] | mygadget.js | mygadget.css</pre> <div class="mw-heading mw-heading4"><h4 id="Using_Gadget_Definition_Namespace">Using Gadget Definition Namespace</h4><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=4" title="Edit section: Using Gadget Definition Namespace"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <style data-mw-deduplicate="TemplateStyles:r4199130">.mw-parser-output .mw-version{border:1px solid #72777d;font-size:80%;line-height:1.2;border-collapse:collapse}.mw-parser-output .mw-version-ltr{float:right;margin:0 0 .5em .5em;text-align:right}.mw-parser-output .mw-version-rtl{float:left;margin:0 .5em .5em 0;text-align:left}.mw-parser-output .mw-version td{padding:.1em .3em}.mw-parser-output .mw-version-versionbox{border:5px solid #00af89;text-align:center}.mw-parser-output .mw-version-versionnumber{font-weight:bold;font-size:180%}.mw-parser-output .mw-version-version .mw-version-versionbox{border-color:#c8ccd1}.mw-parser-output .mw-version.mw-version-version2 .mw-version-versionbox{border-top-color:#c8ccd1;border-right-color:#c8ccd1;border-left-color:#c8ccd1}.mw-parser-output .mw-version-version-unsupported .mw-version-versionbox{border-color:#d33}.mw-parser-output .mw-version.mw-version-version2-unsupported .mw-version-versionbox{border-top-color:#d33;border-right-color:#d33;border-left-color:#d33}.mw-parser-output .mw-version-version-legacy .mw-version-versionbox{border-color:#f93}.mw-parser-output .mw-version.mw-version-version2-legacy .mw-version-versionbox{border-top-color:#f93;border-right-color:#f93;border-left-color:#f93}.mw-parser-output .mw-version-version-stable .mw-version-versionbox,.mw-parser-output .mw-version.mw-version.mw-version-and-later .mw-version-versionbox{border-color:#00af89}.mw-parser-output .mw-version.mw-version-version2-stable .mw-version-versionbox{border-top-color:#00af89;border-right-color:#00af89;border-left-color:#00af89}.mw-parser-output .mw-version-version-future .mw-version-versionbox{border-color:#8080c0}.mw-parser-output .mw-version.mw-version-version2-future .mw-version-versionbox{border-top-color:#8080c0;border-right-color:#8080c0;border-left-color:#8080c0}.mw-parser-output .mw-version-version-alpha .mw-version-versionbox{border-style:dotted}</style> <table class="mw-version mw-version-ltr mw-version-version mw-version-version-legacy"><tbody><tr> <td>MediaWiki version:</td> <td class="mw-version-versionbox" title="MediaWiki 1.41 is a legacy version"><div class="mw-version-versionnumber"><small>≤</small> 1.41</div></td> </tr></tbody></table> <p>There are two ways to define gadgets depending on the <code>$wgGadgetsRepoClass</code>. If It is <code>'MediaWikiGadgetsDefinitionRepo'</code> (the default value), the list of available gadgets is defined on <a href="/wiki/MediaWiki:Gadgets-definition" title="MediaWiki:Gadgets-definition">MediaWiki:Gadgets-definition</a>. In an alternative way, Gadget definitions are defined on pages in the <a href="/wiki/Special:PrefixIndex/Gadget_definition:" title="Special:PrefixIndex/Gadget definition:">Gadget definition</a> namespace when <code>$wgGadgetsRepoClass</code> is set to <code>'GadgetDefinitionNamespaceRepo'</code>. (On MediaWiki 1.39+, the value to use instead is <code class="mw-highlight mw-highlight-lang-php mw-content-ltr" style="" dir="ltr"><span class="s1">'\\MediaWiki\\Extension\\Gadgets\\GadgetDefinitionNamespaceRepo'</span></code>.) </p> <link rel="mw-deduplicated-inline-style" href="mw-data:TemplateStyles:r6651107"><div role="note" class="note note-warn">The migration of existing gadget definitions is not yet supported, so you will lose previously defined gadgets after changing this option.</div> <p>Creation of the <code>Gadget definition:mygadget</code> page and putting in it the below <a href="https://en.wikipedia.org/wiki/JSON" class="extiw" title="w:JSON">JSON</a> code have the same effect as <code>mygadget[ ResourceLoader | rights=foo, bar ] | mygadget.js | mygadget.css</code>. </p> <div class="mw-highlight mw-highlight-lang-json mw-content-ltr" dir="ltr"><pre><span></span><span class="p">{</span> <span class="w"> </span><span class="nt">"settings"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span> <span class="w"> </span><span class="nt">"rights"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"foo"</span><span class="p">,</span><span class="w"> </span><span class="s2">"bar"</span><span class="w"> </span><span class="p">],</span> <span class="w"> </span><span class="nt">"default"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span> <span class="w"> </span><span class="nt">"package"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span> <span class="w"> </span><span class="nt">"hidden"</span><span class="p">:</span><span class="w"> </span><span class="kc">false</span><span class="p">,</span> <span class="w"> </span><span class="nt">"skins"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span> <span class="w"> </span><span class="nt">"actions"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span> <span class="w"> </span><span class="nt">"category"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span> <span class="w"> </span><span class="p">},</span> <span class="w"> </span><span class="nt">"module"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span> <span class="w"> </span><span class="nt">"scripts"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"mygadget.js"</span><span class="w"> </span><span class="p">],</span> <span class="w"> </span><span class="nt">"styles"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span><span class="w"> </span><span class="s2">"mygadget.css"</span><span class="w"> </span><span class="p">],</span> <span class="w"> </span><span class="nt">"datas"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span> <span class="w"> </span><span class="nt">"peers"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span> <span class="w"> </span><span class="nt">"dependencies"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span> <span class="w"> </span><span class="nt">"messages"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span> <span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">""</span> <span class="w"> </span><span class="p">}</span> <span class="p">}</span> </pre></div> <p>In above example, the <code>Gadget:Mygadget.js</code> and the <code>Gadget:mygadget.css</code> are used. </p> <div class="mw-heading mw-heading3"><h3 id="Options">Options</h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=5" title="Edit section: Options"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <table class="wikitable sortable"> <caption>Options </caption> <tbody><tr> <th scope="col">Name </th> <th class="unsortable" scope="col">Parameters </th> <th class="unsortable" scope="col">Description </th> <th scope="col">Since </th></tr> <tr> <td><code>ResourceLoader</code></td> <td><i>None</i></td> <td>Marks gadget's scripts as compatible with <a href="/wiki/Special:MyLanguage/ResourceLoader" title="Special:MyLanguage/ResourceLoader">ResourceLoader</a><span style="display:none"><a href="/wiki/ResourceLoader" title="ResourceLoader"> </a></span>.</td> <td>1.17 (<a href="https://www.mediawiki.org/wiki/Special:Code/MediaWiki/r76527" class="extiw" title="rev:r76527">r76527</a>) </td></tr> <tr> <td><code>dependencies</code> </td> <td>Comma-separated module names </td> <td>These modules will be loaded before the scripts of this gadget execute. See <a href="/wiki/Special:MyLanguage/ResourceLoader/Default_modules" title="Special:MyLanguage/ResourceLoader/Default modules">list of default modules</a>. </td> <td>1.17 (<a href="https://www.mediawiki.org/wiki/Special:Code/MediaWiki/r76639" class="extiw" title="rev:r76639">r76639</a>) </td></tr> <tr> <td><code>rights</code> </td> <td>Comma-separated privilege names </td> <td>Make the gadget available (and visible in preferences) only to users who have the specified <a href="/wiki/Special:MyLanguage/Manual:User_rights#List_of_permissions" title="Special:MyLanguage/Manual:User rights">privileges</a>. </td> <td>1.18 (<a href="https://www.mediawiki.org/wiki/Special:Code/MediaWiki/r85268" class="extiw" title="rev:r85268">r85268</a>) </td></tr> <tr id="hidden"> <td><code>hidden</code> </td> <td><i>None</i> </td> <td>Hide the gadget from the <a href="/wiki/Special:MyLanguage/Help:Preferences" title="Special:MyLanguage/Help:Preferences">Preferences</a> page. This can be used in two ways: <ul><li>Enable a gadget by default without the ability to disable (as a modular alternative to Common.js). Note that you need to add both: <code>hidden | default</code> to load a module for all users.</li> <li>Gadgets that are not meant for end-users but rather are meant to be loaded by other gadgets. For example, to allow two gadgets to re-use the same internal code or to register the "core" part of a gadget that only loads on certain pages.</li></ul> </td> <td>1.28 </td></tr> <tr> <td><code>skins</code> </td> <td>Comma-separated skin names </td> <td>Make the gadget available (and visible in preferences) only to users who use the specified <a href="/wiki/Special:MyLanguage/Manual:Skins" title="Special:MyLanguage/Manual:Skins">skins</a>. Before MediaWiki 1.32 it was taking into consideration the skin set in preferences for the user, not the current displayed one (like when adding <code>?useskin=monobook</code> in the URL, <a href="https://phabricator.wikimedia.org/T199478" class="extiw" title="phabricator:T199478">task T199478</a>). Since 1.39, the ResourceLoader module is not registered on skins the gadget is unavailable on, so the gadget cannot be loaded on those skins as a dependency or using <code>mw.loader.load()</code> either (<a href="https://phabricator.wikimedia.org/T236603" class="extiw" title="phabricator:T236603">task T236603</a>). <link rel="mw-deduplicated-inline-style" href="mw-data:TemplateStyles:r6651107"><div role="note" class="note note-info">Use of <code>skins</code> is a last resort, and should be restricted to specialized code. For example code which relies on DOM manipulation in the absence of standardized APIs and that cannot be implemented using <a href="/wiki/Special:MyLanguage/ResourceLoader/Core_modules" title="Special:MyLanguage/ResourceLoader/Core modules">Core modules</a>.</div> </td> <td>1.19 (<a href="https://www.mediawiki.org/wiki/Special:Code/MediaWiki/r100509" class="extiw" title="rev:r100509">r100509</a>) </td></tr> <tr> <td><code>actions</code> </td> <td>Comma-separated action names </td> <td>Make the gadget available only on the specified page actions. E.g. <code>actions = edit, history</code> to load a gadget only while editing and on history pages. <link rel="mw-deduplicated-inline-style" href="mw-data:TemplateStyles:r6651107"><div role="note" class="note note-info">Specifying <code>edit</code> action will also load it on <code>action=submit</code>. Invalid actions effectively disable the gadget since it can't be run anywhere.</div> </td> <td>1.38 (<a href="https://gerrit.wikimedia.org/r/747112" class="extiw" title="gerrit:747112">gerrit:747112</a>) </td></tr> <tr> <td><code>categories</code> </td> <td>Comma-separated category names </td> <td>Make the gadget available only on the specified categories. E.g. <code>categories = Archived, Maintenance</code> to load a gadget only on pages in the Category:Archived or Category:Maintenance. See also: <a href="/wiki/Special:MyLanguage/Template_gadgets" title="Special:MyLanguage/Template gadgets">Template gadgets</a><span style="display:none"><a href="/wiki/Template_gadgets" title="Template gadgets"> </a></span>. </td> <td>1.42 (<a href="https://gerrit.wikimedia.org/r/1005092" class="extiw" title="gerrit:1005092">gerrit:1005092</a>) </td></tr> <tr> <td><code>namespaces</code> </td> <td>Comma-separated namespace numbers </td> <td>Make the gadget available only on the specified <a href="/wiki/Special:MyLanguage/Manual:Namespace" title="Special:MyLanguage/Manual:Namespace">namespaces</a>. E.g. <code>namespaces = 0, 2</code> to load a gadget only in mainspace and user namespace. </td> <td>1.41 (<a href="https://gerrit.wikimedia.org/r/624517" class="extiw" title="gerrit:624517">gerrit:624517</a>) </td></tr> <tr> <td><code>contentModels</code> </td> <td>Comma-separated content models </td> <td>Make the gadget available on pages with the given content models. E.g. <code>contentModels = wikitext</code> to load a gadget only on wikitext pages. </td> <td>1.41 (<a href="https://gerrit.wikimedia.org/r/922062" class="extiw" title="gerrit:922062">gerrit:922062</a>) </td></tr> <tr> <td><code>default</code> </td> <td><i>None</i></td> <td>Enable the gadget by default for everyone (including IPs). Registered users can still disable it in their preferences. </td> <td>1.18 (<a href="https://www.mediawiki.org/wiki/Special:Code/MediaWiki/r85902" class="extiw" title="rev:r85902">r85902</a>) </td></tr> <tr> <td><code>package</code> </td> <td><i>None</i></td> <td>Mark this gadget as <a href="/wiki/Special:MyLanguage/ResourceLoader/Migration_guide_(users)#Package_Gadgets" title="Special:MyLanguage/ResourceLoader/Migration guide (users)">packaged</a>. Only the first JavaScript page will be executed in this mode. Other pages can be imported by using the require() function. This mode also enables the use of JSON pages, which cannot be included otherwise. </td> <td>1.38 </td></tr> <tr> <td><code>type</code> </td> <td><code>styles</code> (default for CSS-only gadgets) or <code>general</code> (default otherwise) </td> <td>Use <code>styles</code> for modules that only modify styling for elements already on the page (e.g. when customizing the skin, layout, or article content). It will cause the CSS files of the module to be included from the page HTML instead of being loaded via JavaScript. For details, see <a href="/wiki/Special:MyLanguage/ResourceLoader/Migration_guide_(users)#Gadget_type" title="Special:MyLanguage/ResourceLoader/Migration guide (users)">ResourceLoader/Migration guide (users)#Gadget type</a>. <link rel="mw-deduplicated-inline-style" href="mw-data:TemplateStyles:r6651107"><div role="note" class="note note-info">Using <code>styles</code> will <b>not</b> load in any specified JavaScript files. For gadgets that modify styling for elements through both JavaScript <i>and</i> CSS, two individual gadget definitions are required.</div> </td> <td>1.28 </td></tr> <tr> <td><code>peers</code> </td> <td>Comma-separated gadget names </td> <td>These CSS-only gadgets will be loaded with this gadget. These gadgets will be loaded before any <code>dependencies</code>, and their styles will be applied even if JavaScript is disabled. For details, see <a href="/wiki/Special:MyLanguage/ResourceLoader/Migration_guide_(users)#Gadget_peers" title="Special:MyLanguage/ResourceLoader/Migration guide (users)">ResourceLoader/Migration guide (users)#Gadget peers</a>. </td> <td>1.29 </td></tr> <tr> <td><code>supportsUrlLoad</code> <span class="anchor" id="supportsUrlLoad"></span> </td> <td><i>None</i> | true | false </td> <td>Make the gadget available to be loaded with the <code>?withgadget</code> URL query parameter. </td> <td>1.38 </td></tr></tbody></table> <table class="wikitable sortable"> <caption>Removed options </caption> <tbody><tr> <th scope="col">Name </th> <th class="unsortable" scope="col">Parameters </th> <th class="unsortable" scope="col">Description </th> <th scope="col">Since </th> <th scope="col">Removed </th></tr> <tr> <td><code>top</code> </td> <td><i>None</i> </td> <td>Makes the gadget to be <a href="/wiki/Special:MyLanguage/Manual:$wgResourceModules#Details" title="Special:MyLanguage/Manual:$wgResourceModules">top-loaded</a>. This should be used sparingly, but may be needed for some initialization stuff like registering plugins with VisualEditor. </td> <td>1.22 (<a href="https://gerrit.wikimedia.org/r/75506" class="extiw" title="gerrit:75506">gerrit:75506</a>) </td> <td>1.29 </td></tr> <tr> <td><code>requiresES6</code> <span class="anchor" id="requiresES6"></span> </td> <td><i>None</i> </td> <td>Allow use of ES6 syntax (ES2015) in the gadget. Enabling this means server-side syntax validation is skipped for the gadget. Any ES6-requiring gadgets are loaded together in a single web request, which isolates failures due to invalid or unsupported syntax to those gadgets only, without affecting other gadgets and MediaWiki software features. It is recommended to use a tool like ESLint to ensure only valid ES6 syntax is used. Conflicts with <code>default</code>. </td> <td>1.40 (<a href="https://gerrit.wikimedia.org/r/758086" class="extiw" title="gerrit:758086">gerrit:758086</a>) </td> <td>1.42 </td></tr> <tr> <td><code>targets</code> </td> <td><code>desktop</code>, <code>mobile</code> or <code>desktop, mobile</code>(default) </td> <td>Set the <a href="/wiki/Special:MyLanguage/ResourceLoader" title="Special:MyLanguage/ResourceLoader">ResourceLoader</a><span style="display:none"><a href="/wiki/ResourceLoader" title="ResourceLoader"> </a></span> target(s) for the gadget. <link rel="mw-deduplicated-inline-style" href="mw-data:TemplateStyles:r6651107"><div role="note" class="note note-info">Do not use <code>targets</code>, instead use <code>skins</code> where absolutely necessary.</div> </td> <td>1.21 (<a href="https://gerrit.wikimedia.org/r/60954" class="extiw" title="gerrit:60954">gerrit:60954</a>) </td> <td>1.42 </td></tr></tbody></table> <p>You can specify extra dependencies for your gadgets, for example: </p> <pre>* mygadget[ResourceLoader|dependencies=jquery.ui, jquery.effects.clip]|mygadget.js|mygadget.css </pre> <p>Here, we ask ResourceLoader to load modules <code>jquery.ui</code> and <code>jquery.effects.clip</code> with mygadget. Note that gadgets can't depend on scripts from pages, static files, or external URLs, only on modules already registered in ResourceLoader. To make a script from a page depend on another script from a page, each should be a gadget that registers itself as a module in ResourceLoader, then they can be made to have dependencies using the following syntax: </p> <pre>* childgadget[ResourceLoader|dependencies=ext.gadget.parentgadget]|childgadget.js </pre> <p>To enable a gadget by default, use "<code>default</code>": </p> <pre>* mygadget[ResourceLoader|default|dependencies=mediawiki.util]|mygadget.js|mygadget.css </pre> <p>To make the gadget available only to users with appropriate permissions, set the <code>rights</code> option, for example: </p> <pre>* ImprovedDeletion [rights=delete] | ImprovedDeletion.js </pre> <p>It makes the gadget available only to users who can delete pages. </p><p>Note that restrictions are based on <a href="/wiki/Special:MyLanguage/Manual:User_rights#List_of_permissions" title="Special:MyLanguage/Manual:User rights">permissions</a>, not user groups like <a href="/wiki/Special:MyLanguage/Manual:Administrators" title="Special:MyLanguage/Manual:Administrators">administrators</a> or bureaucrats. Here are some real examples: </p> <pre>* <a href="https://en.wikipedia.org/wiki/MediaWiki:Gadget-modrollback" class="extiw" title="w:MediaWiki:Gadget-modrollback">modrollback</a> [ResourceLoader |rights=<a href="/wiki/Manual:Administrators#Rollback" title="Manual:Administrators">rollback</a>] |<a href="/wiki/MediaWiki:Gadget-modrollback.js" title="MediaWiki:Gadget-modrollback.js">modrollback.js</a> * <a href="https://en.wikipedia.org/wiki/MediaWiki:Gadget-geonotice" class="extiw" title="w:MediaWiki:Gadget-geonotice">geonotice</a> [ResourceLoader |default |rights=<a href="/wiki/Special:MyLanguage/Manual:Watchlist" title="Special:MyLanguage/Manual:Watchlist">viewmywatchlist</a>] |geonotice.js * <a href="https://meta.wikimedia.org/wiki/User:Pathoschild/Scripts/Ajax_sysop" class="extiw" title="m:User:Pathoschild/Scripts/Ajax sysop">Ajax_sysop</a> [ResourceLoader |rights=<a href="/wiki/Special:MyLanguage/Help:Patrolling" title="Special:MyLanguage/Help:Patrolling">patrol</a>, <a href="/wiki/Special:MyLanguage/Manual:Administrators#Rollback" title="Special:MyLanguage/Manual:Administrators">rollback</a>, <a href="/wiki/Special:MyLanguage/Manual:Administrators#Rollback" title="Special:MyLanguage/Manual:Administrators">markbotedits</a>, <a href="/wiki/Special:MyLanguage/Manual:Administrators#Deletion" title="Special:MyLanguage/Manual:Administrators">delete</a>]|<a href="https://meta.wikimedia.org/wiki/User:Pathoschild/Scripts/Ajax_sysop.js" class="extiw" title="m:User:Pathoschild/Scripts/Ajax sysop.js">Ajax_sysop.js</a> </pre> <p><br /> </p> <div class="mw-heading mw-heading3"><h3 id="User_rights">User rights</h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=6" title="Edit section: User rights"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <link rel="mw-deduplicated-inline-style" href="mw-data:TemplateStyles:r6651107"><div role="note" class="note note-info">This extension adds two new user rights, <code>gadgets-edit</code> and <code>gadgets-definition-edit</code>, which by default aren't given to any group. <p>You can add the following in your <a href="/wiki/Special:MyLanguage/Manual:LocalSettings.php" title="Special:MyLanguage/Manual:LocalSettings.php">LocalSettings.php</a><span style="display:none"><a href="/wiki/Manual:LocalSettings.php" title="Manual:LocalSettings.php"> </a></span> to provide the appropriate permissions for users who are within the interface-admin group. Editing pages in the Gadget namespace requires the <code>gadgets-edit</code> right and editing pages in the Gadget definition namespace requires the <code>gadgets-definition-edit</code> right. </p> <div class="mw-highlight mw-highlight-lang-php mw-content-ltr" dir="ltr"><pre><span></span><span class="nv">$wgGroupPermissions</span><span class="p">[</span><span class="s1">'interface-admin'</span><span class="p">][</span><span class="s1">'gadgets-edit'</span><span class="p">]</span> <span class="o">=</span> <span class="k">true</span><span class="p">;</span> <span class="nv">$wgGroupPermissions</span><span class="p">[</span><span class="s1">'interface-admin'</span><span class="p">][</span><span class="s1">'gadgets-definition-edit'</span><span class="p">]</span> <span class="o">=</span> <span class="k">true</span><span class="p">;</span> </pre></div></div> <div class="mw-heading mw-heading3"><h3 id="Pages">Pages</h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=7" title="Edit section: Pages"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>The remaining fields on the definition line refer to the JavaScript, CSS, or JSON source pages that make up the gadget module. These are stored in the MediaWiki namespace as interface messages (<b>MediaWiki:Gadget-mygadget.js</b> and <b>MediaWiki:Gadget-mygadget.css</b> in the example). The page names must end with ".css", ".js", or ".json" respectively. </p><p>A gadget can use any number of source pages, e.g.: </p> <pre> * frobinator[ResourceLoader]|frob.js|frob.css|pretty.css * l33t[ResourceLoader]|l33t.js * foobar[ResourceLoader|package]|foo.js|bar.js|foobar-data.json </pre> <p>Please note that if your code contains strings that could be interpreted as wiki syntax (e.g., the signature code <code>~~~~</code>), you may want to enclose your code into <code class="mw-highlight" style="white-space:nowrap"><span class="p">‎<</span><span class="nt">nowiki</span><span class="p">></span>...<span class="p">‎</</span><span class="nt">nowiki</span><span class="p">></span></code> and put these tags in JavaScript or CSS comments so they're not interpreted when used. </p><p>See the first and last lines of <a href="/wiki/Special:PermanentLink/1158805" title="Special:PermanentLink/1158805">MediaWiki:Gadget-externalsearch-bar.js</a> for an example. </p> <div class="mw-heading mw-heading3"><h3 id="Sections">Sections</h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=8" title="Edit section: Sections"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>The list of gadgets in <a href="/wiki/MediaWiki:Gadgets-definition" title="MediaWiki:Gadgets-definition">MediaWiki:Gadgets-definition</a> can be broken into sections using lines that start and end with two or more "=" (equals) characters, enclosing the name of a system message that defines the section's name, for example: </p> <pre> == interface-gadgets == ... == editing-gadgets == ... </pre> <p>This would define two new sections, with the titles defined on the pages <a href="/wiki/MediaWiki:Gadget-section-interface-gadgets" title="MediaWiki:Gadget-section-interface-gadgets">MediaWiki:Gadget-section-<b>interface-gadgets</b></a> and <a href="/wiki/MediaWiki:Gadget-section-editing-gadgets" title="MediaWiki:Gadget-section-editing-gadgets">MediaWiki:Gadget-section-<b>editing-gadgets</b></a>. </p> <div class="mw-heading mw-heading2"><h2 id="Popular_gadgets">Popular gadgets</h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=9" title="Edit section: Popular gadgets"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>See <a href="https://meta.wikimedia.org/wiki/Gadgets" class="extiw" title="meta:Gadgets">meta:Gadgets</a> for gadgets that are popular in Wikimedia communities. </p> <div class="mw-heading mw-heading2"><h2 id="See_also">See also</h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Extension:Gadgets&action=edit&section=10" title="Edit section: See also"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <ul><li><a href="/wiki/Special:Gadgets" title="Special:Gadgets">Special:Gadgets</a> – lists all the gadgets and a brief description of each</li> <li><a href="/wiki/Special:MyLanguage/Extension:Gadgets/Roadmap" title="Special:MyLanguage/Extension:Gadgets/Roadmap">Extension:Gadgets/Roadmap</a><span style="display:none"><a href="/wiki/Extension:Gadgets/Roadmap" title="Extension:Gadgets/Roadmap"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/ResourceLoader/Version_2_Design_Specification#Gadget_Manager" title="Special:MyLanguage/ResourceLoader/Version 2 Design Specification">Gadget Manager</a><span style="display:none"><a href="/wiki/ResourceLoader/Version_2_Design_Specification#Gadget_Manager" title="ResourceLoader/Version 2 Design Specification"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Extension:Widgets" title="Special:MyLanguage/Extension:Widgets">Extension:Widgets</a><span style="display:none"><a href="/wiki/Extension:Widgets" title="Extension:Widgets"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Snippets" title="Special:MyLanguage/Snippets">Snippets</a><span style="display:none"><a href="/wiki/Snippets" title="Snippets"> </a></span></li></ul> <style data-mw-deduplicate="TemplateStyles:r6651108">.mw-parser-output table.ombox{margin:4px 10%;border-collapse:collapse;border:1px solid #a2a9b1;background-color:#f8f9fa;color:#333;box-sizing:border-box}.mw-parser-output .ombox td.mbox-empty-cell{border:none;padding:0;width:1px}.mw-parser-output .ombox th.mbox-text,.mw-parser-output .ombox td.mbox-text{border:none;padding:0.25em 0.9em;width:100%}.mw-parser-output .ombox td.mbox-image{border:none;text-align:center;padding:2px 0 2px 0.9em}.mw-parser-output .ombox td.mbox-imageright{border:none;text-align:center;padding:2px 0.9em 2px 0}.mw-parser-output table.ombox-notice{border-color:#a2a9b1}.mw-parser-output table.ombox-speedy{background-color:#fee7e6;color:#333}.mw-parser-output table.ombox-speedy,.mw-parser-output table.ombox-delete{border-color:#b32424;border-width:2px}.mw-parser-output table.ombox-content{border-color:#f28500}.mw-parser-output table.ombox-style{border-color:#fc3}.mw-parser-output table.ombox-move{border-color:#9932cc}.mw-parser-output table.ombox-protection{border-color:#a2a9b1;border-width:2px}html body.mediawiki .mw-parser-output .ombox.mbox-small{clear:right;float:right;margin:4px 0 4px 1em;box-sizing:border-box;width:238px;font-size:88%;line-height:1.25em}@media screen{html.skin-theme-clientpref-night .mw-parser-output table.ombox{background-color:transparent;color:inherit}}@media screen and (prefers-color-scheme:dark){html.skin-theme-clientpref-os .mw-parser-output table.ombox{background-color:transparent;color:inherit}}</style><table class="ombox ombox-notice plainlinks" role="presentation" style="clear: both; margin-top: 0; margin-bottom: 0;"><tbody><tr><td class="mbox-image"><span class="skin-invert-image" typeof="mw:File"><span><img alt="" src="//upload.wikimedia.org/wikipedia/commons/thumb/8/8b/Wikimedia-logo_black.svg/40px-Wikimedia-logo_black.svg.png" decoding="async" width="40" height="40" class="mw-file-element" srcset="//upload.wikimedia.org/wikipedia/commons/thumb/8/8b/Wikimedia-logo_black.svg/60px-Wikimedia-logo_black.svg.png 1.5x, //upload.wikimedia.org/wikipedia/commons/thumb/8/8b/Wikimedia-logo_black.svg/80px-Wikimedia-logo_black.svg.png 2x" data-file-width="512" data-file-height="512" /></span></span></td><td class="mbox-text">This extension is being used on one or more <a href="https://meta.wikimedia.org/wiki/Special:MyLanguage/Wikimedia_projects" class="extiw" title="m:Special:MyLanguage/Wikimedia projects">Wikimedia projects</a>. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's <a class="external text" href="https://noc.wikimedia.org/conf/highlight.php?file=CommonSettings.php">CommonSettings.php</a> and <a class="external text" href="https://noc.wikimedia.org/conf/highlight.php?file=InitialiseSettings.php">InitialiseSettings.php</a> configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's <a href="/wiki/Special:Version" title="Special:Version">Special:Version</a> page.</td></tr></tbody></table> <link rel="mw-deduplicated-inline-style" href="mw-data:TemplateStyles:r6651108"><table class="ombox ombox-notice" role="presentation"><tbody><tr><td class="mbox-image"><span typeof="mw:File"><span><img alt="" src="//upload.wikimedia.org/wikipedia/commons/thumb/e/ec/OOjs_UI_icon_information-progressive.svg/40px-OOjs_UI_icon_information-progressive.svg.png" decoding="async" width="40" height="40" class="mw-file-element" srcset="//upload.wikimedia.org/wikipedia/commons/thumb/e/ec/OOjs_UI_icon_information-progressive.svg/60px-OOjs_UI_icon_information-progressive.svg.png 1.5x, //upload.wikimedia.org/wikipedia/commons/thumb/e/ec/OOjs_UI_icon_information-progressive.svg/80px-OOjs_UI_icon_information-progressive.svg.png 2x" data-file-width="20" data-file-height="20" /></span></span></td><td class="mbox-text">This extension is included in the following wiki farms/hosts and/or packages: <style data-mw-deduplicate="TemplateStyles:r6387430">.mw-parser-output .hlist dl,.mw-parser-output .hlist ol,.mw-parser-output .hlist ul{margin:0;padding:0}.mw-parser-output .hlist dd,.mw-parser-output .hlist dt,.mw-parser-output .hlist li{margin:0;display:inline}.mw-parser-output .hlist dl dl,.mw-parser-output .hlist dl ol,.mw-parser-output .hlist dl ul,.mw-parser-output .hlist ol dl,.mw-parser-output .hlist ol ol,.mw-parser-output .hlist ol ul,.mw-parser-output .hlist ul dl,.mw-parser-output .hlist ul ol,.mw-parser-output .hlist ul ul{display:inline}.mw-parser-output .hlist .mw-empty-li,.mw-parser-output .hlist .mw-empty-elt{display:none}.mw-parser-output .hlist dt:after{content:": "}.mw-parser-output .hlist dd:after,.mw-parser-output .hlist li:after{content:" · ";font-weight:bold}.mw-parser-output .hlist dd:last-child:after,.mw-parser-output .hlist dt:last-child:after,.mw-parser-output .hlist li:last-child:after{content:none}.mw-parser-output .hlist dd dd:first-child:before,.mw-parser-output .hlist dd dt:first-child:before,.mw-parser-output .hlist dd li:first-child:before,.mw-parser-output .hlist dt dd:first-child:before,.mw-parser-output .hlist dt dt:first-child:before,.mw-parser-output .hlist dt li:first-child:before,.mw-parser-output .hlist li dd:first-child:before,.mw-parser-output .hlist li dt:first-child:before,.mw-parser-output .hlist li li:first-child:before{content:" (";font-weight:normal}.mw-parser-output .hlist dd dd:last-child:after,.mw-parser-output .hlist dd dt:last-child:after,.mw-parser-output .hlist dd li:last-child:after,.mw-parser-output .hlist dt dd:last-child:after,.mw-parser-output .hlist dt dt:last-child:after,.mw-parser-output .hlist dt li:last-child:after,.mw-parser-output .hlist li dd:last-child:after,.mw-parser-output .hlist li dt:last-child:after,.mw-parser-output .hlist li li:last-child:after{content:")";font-weight:normal}.mw-parser-output .hlist ol{counter-reset:listitem}.mw-parser-output .hlist ol>li{counter-increment:listitem}.mw-parser-output .hlist ol>li:before{content:" "counter(listitem)"\a0 "}.mw-parser-output .hlist dd ol>li:first-child:before,.mw-parser-output .hlist dt ol>li:first-child:before,.mw-parser-output .hlist li ol>li:first-child:before{content:" ("counter(listitem)"\a0 "}</style><div class="hlist"> <ul><li><a href="/wiki/Special:MyLanguage/BlueSpice" title="Special:MyLanguage/BlueSpice">BlueSpice</a><span style="display:none"><a href="/wiki/BlueSpice" title="BlueSpice"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Canasta" title="Special:MyLanguage/Canasta">Canasta</a><span style="display:none"><a href="/wiki/Canasta" title="Canasta"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Debian_packages" title="Special:MyLanguage/Debian packages">Debian</a><span style="display:none"><a href="/wiki/Debian_packages" title="Debian packages"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Fandom" title="Special:MyLanguage/Fandom">Fandom</a><span style="display:none"><a href="/wiki/Fandom" title="Fandom"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Miraheze" title="Special:MyLanguage/Miraheze">Miraheze</a><span style="display:none"><a href="/wiki/Miraheze" title="Miraheze"> </a></span></li> <li><a rel="nofollow" class="external text" href="https://www.mywikis.com/">MyWikis</a></li> <li><a rel="nofollow" class="external text" href="https://www.pro.wiki/">ProWiki</a></li> <li><a rel="nofollow" class="external text" href="https://semantic.wiki/de/core">semantic::core</a></li> <li><a href="/wiki/Special:MyLanguage/ShoutWiki" title="Special:MyLanguage/ShoutWiki">ShoutWiki</a><span style="display:none"><a href="/wiki/ShoutWiki" title="ShoutWiki"> </a></span></li> <li><a rel="nofollow" class="external text" href="https://telepedia.net/">Telepedia</a></li> <li><a href="/wiki/Special:MyLanguage/wiki.gg" title="Special:MyLanguage/wiki.gg">wiki.gg</a><span style="display:none"><a href="/wiki/Wiki.gg" title="Wiki.gg"> </a></span></li> <li><a rel="nofollow" class="external text" href="https://wikiforge.net/">WikiForge</a></li></ul> </div> <small>This is not an authoritative list.</small> <small>Some wiki farms/hosts and/or packages may contain this extension even if they are not listed here.</small> <small>Always check with your wiki farms/hosts or bundle to confirm.</small></td></tr></tbody></table>    </div><noscript><img src="https://login.wikimedia.org/wiki/Special:CentralAutoLogin/start?type=1x1" alt="" width="1" height="1" style="border: none; position: absolute;"></noscript> <div class="printfooter" data-nosnippet="">Retrieved from "<a dir="ltr" href="https://www.mediawiki.org/w/index.php?title=Extension:Gadgets&oldid=6854487">https://www.mediawiki.org/w/index.php?title=Extension:Gadgets&oldid=6854487</a>"</div></div> <div id="catlinks" class="catlinks" data-mw="interface"><div id="mw-normal-catlinks" class="mw-normal-catlinks"><a href="/wiki/Special:Categories" title="Special:Categories">Categories</a>: <ul><li><a href="/wiki/Category:Extensions_bundled_with_MediaWiki_1.18" title="Category:Extensions bundled with MediaWiki 1.18">Extensions bundled with MediaWiki 1.18</a></li><li><a href="/wiki/Category:Stable_extensions" title="Category:Stable extensions">Stable extensions</a></li><li><a href="/wiki/Category:Personalization_extensions" title="Category:Personalization extensions">Personalization extensions</a></li><li><a href="/wiki/Category:Special_page_extensions" title="Category:Special page extensions">Special page extensions</a></li><li><a href="/wiki/Category:API_extensions" title="Category:API extensions">API extensions</a></li><li><a href="/wiki/Category:GPL_licensed_extensions" title="Category:GPL licensed extensions">GPL licensed extensions</a></li><li><a href="/wiki/Category:Extensions_in_Wikimedia_version_control" title="Category:Extensions in Wikimedia version control">Extensions in Wikimedia version control</a></li><li><a href="/wiki/Category:BeforePageDisplay_extensions" title="Category:BeforePageDisplay extensions">BeforePageDisplay extensions</a></li><li><a href="/wiki/Category:CodeEditorGetPageLanguage_extensions" title="Category:CodeEditorGetPageLanguage extensions">CodeEditorGetPageLanguage extensions</a></li><li><a href="/wiki/Category:ContentHandlerDefaultModelFor_extensions" title="Category:ContentHandlerDefaultModelFor extensions">ContentHandlerDefaultModelFor extensions</a></li><li><a href="/wiki/Category:DeleteUnknownPreferences_extensions" title="Category:DeleteUnknownPreferences extensions">DeleteUnknownPreferences extensions</a></li><li><a href="/wiki/Category:GetPreferences_extensions" title="Category:GetPreferences extensions">GetPreferences extensions</a></li><li><a href="/wiki/Category:PageDeleteComplete_extensions" title="Category:PageDeleteComplete extensions">PageDeleteComplete extensions</a></li><li><a href="/wiki/Category:PageSaveComplete_extensions" title="Category:PageSaveComplete extensions">PageSaveComplete extensions</a></li><li><a href="/wiki/Category:PreferencesGetIcon_extensions" title="Category:PreferencesGetIcon extensions">PreferencesGetIcon extensions</a></li><li><a href="/wiki/Category:PreferencesGetLegend_extensions" title="Category:PreferencesGetLegend extensions">PreferencesGetLegend extensions</a></li><li><a href="/wiki/Category:ResourceLoaderRegisterModules_extensions" title="Category:ResourceLoaderRegisterModules extensions">ResourceLoaderRegisterModules extensions</a></li><li><a href="/wiki/Category:UserGetDefaultOptions_extensions" title="Category:UserGetDefaultOptions extensions">UserGetDefaultOptions extensions</a></li><li><a href="/wiki/Category:GetUserPermissionsErrors_extensions" title="Category:GetUserPermissionsErrors extensions">GetUserPermissionsErrors extensions</a></li><li><a href="/wiki/Category:WgQueryPages_extensions" title="Category:WgQueryPages extensions">WgQueryPages extensions</a></li><li><a href="/wiki/Category:All_extensions" title="Category:All extensions">All extensions</a></li><li><a href="/wiki/Category:Extensions_used_on_Wikimedia" title="Category:Extensions used on Wikimedia">Extensions used on Wikimedia</a></li><li><a href="/wiki/Category:Extensions_included_in_BlueSpice" title="Category:Extensions included in BlueSpice">Extensions included in BlueSpice</a></li><li><a href="/wiki/Category:Extensions_included_in_Canasta" title="Category:Extensions included in Canasta">Extensions included in Canasta</a></li><li><a href="/wiki/Category:Extensions_available_as_Debian_packages" title="Category:Extensions available as Debian packages">Extensions available as Debian packages</a></li><li><a href="/wiki/Category:Extensions_included_in_Fandom" title="Category:Extensions included in Fandom">Extensions included in Fandom</a></li><li><a href="/wiki/Category:Extensions_included_in_Miraheze" title="Category:Extensions included in Miraheze">Extensions included in Miraheze</a></li><li><a href="/wiki/Category:Extensions_included_in_MyWikis" title="Category:Extensions included in MyWikis">Extensions included in MyWikis</a></li><li><a href="/wiki/Category:Extensions_included_in_ProWiki" title="Category:Extensions included in ProWiki">Extensions included in ProWiki</a></li><li><a href="/wiki/Category:Extensions_included_in_semantic::core" title="Category:Extensions included in semantic::core">Extensions included in semantic::core</a></li><li><a href="/wiki/Category:Extensions_included_in_ShoutWiki" title="Category:Extensions included in ShoutWiki">Extensions included in ShoutWiki</a></li><li><a href="/wiki/Category:Extensions_included_in_Telepedia" title="Category:Extensions included in Telepedia">Extensions included in Telepedia</a></li><li><a href="/wiki/Category:Extensions_included_in_wiki.gg" title="Category:Extensions included in wiki.gg">Extensions included in wiki.gg</a></li><li><a href="/wiki/Category:Extensions_included_in_WikiForge" title="Category:Extensions included in WikiForge">Extensions included in WikiForge</a></li><li><a href="/wiki/Category:Gadgets" title="Category:Gadgets">Gadgets</a></li><li><a href="/wiki/Category:JavaScript" title="Category:JavaScript">JavaScript</a></li></ul></div><div id="mw-hidden-catlinks" class="mw-hidden-catlinks mw-hidden-cats-hidden">Hidden categories: <ul><li><a href="/wiki/Category:Extensions_with_release_branches_compatibility_policy" title="Category:Extensions with release branches compatibility policy">Extensions with release branches compatibility policy</a></li><li><a href="/wiki/Category:Extensions_with_manual_MediaWiki_version" title="Category:Extensions with manual MediaWiki version">Extensions with manual MediaWiki version</a></li></ul></div></div> </div> </main> </div> <div class="mw-footer-container"> <footer id="footer" class="mw-footer" > <ul id="footer-info"> <li id="footer-info-lastmod"> This page was last edited on 15 November 2024, at 23:16.</li> <li id="footer-info-copyright">Text is available under the <a rel="nofollow" class="external text" href="https://creativecommons.org/licenses/by-sa/4.0/deed.en">Creative Commons Attribution-ShareAlike License</a>; additional terms may apply. Text in <a class="external text" href="https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents">the Help: namespace</a> is available under the <a rel="nofollow" class="external text" href="https://creativecommons.org/publicdomain/zero/1.0/">Creative Commons CC0 License</a>. By using this site, you agree to the <a class="external text" href="https://foundation.wikimedia.org/wiki/Special:MyLanguage/Policy:Terms_of_Use">Terms of Use</a> and <a class="external text" href="https://foundation.wikimedia.org/wiki/Special:MyLanguage/Policy:Privacy_policy">Privacy Policy</a>.</li> </ul> <ul id="footer-places"> <li id="footer-places-privacy"><a href="https://foundation.wikimedia.org/wiki/Special:MyLanguage/Policy:Privacy_policy">Privacy policy</a></li> <li id="footer-places-about"><a href="/wiki/Project:About">About mediawiki.org</a></li> <li id="footer-places-disclaimers"><a href="/wiki/Project:General_disclaimer">Disclaimers</a></li> <li id="footer-places-wm-codeofconduct"><a href="https://www.mediawiki.org/wiki/Special:MyLanguage/Code_of_Conduct">Code of Conduct</a></li> <li id="footer-places-developers"><a href="https://developer.wikimedia.org">Developers</a></li> <li id="footer-places-statslink"><a href="https://stats.wikimedia.org/#/www.mediawiki.org">Statistics</a></li> <li id="footer-places-cookiestatement"><a href="https://foundation.wikimedia.org/wiki/Special:MyLanguage/Policy:Cookie_statement">Cookie statement</a></li> <li id="footer-places-mobileview"><a href="//m.mediawiki.org/w/index.php?title=Extension:Gadgets&mobileaction=toggle_view_mobile" class="noprint stopMobileRedirectToggle">Mobile view</a></li> </ul> <ul id="footer-icons" class="noprint"> <li id="footer-copyrightico"><a href="https://wikimediafoundation.org/" class="cdx-button cdx-button--fake-button cdx-button--size-large cdx-button--fake-button--enabled"><img src="/static/images/footer/wikimedia-button.svg" width="84" height="29" alt="Wikimedia Foundation" loading="lazy"></a></li> <li id="footer-poweredbyico"><a href="https://www.mediawiki.org/" class="cdx-button cdx-button--fake-button cdx-button--size-large cdx-button--fake-button--enabled"><img src="/w/resources/assets/poweredby_mediawiki.svg" alt="Powered by MediaWiki" width="88" height="31" loading="lazy"></a></li> </ul> </footer> </div> </div> </div> <div class="vector-settings" id="p-dock-bottom"> <ul></ul> </div><script>(RLQ=window.RLQ||[]).push(function(){mw.config.set({"wgHostname":"mw-web.codfw.main-f69cdc8f6-hhmqd","wgBackendResponseTime":143,"wgPageParseReport":{"limitreport":{"cputime":"0.816","walltime":"1.011","ppvisitednodes":{"value":5911,"limit":1000000},"postexpandincludesize":{"value":77226,"limit":2097152},"templateargumentsize":{"value":22140,"limit":2097152},"expansiondepth":{"value":20,"limit":100},"expensivefunctioncount":{"value":33,"limit":500},"unstrip-depth":{"value":0,"limit":20},"unstrip-size":{"value":32465,"limit":5000000},"entityaccesscount":{"value":0,"limit":400},"timingprofile":["100.00% 696.591 1 -total"," 59.61% 415.216 1 Template:Extension"," 30.44% 212.017 62 Template:Ll"," 18.42% 128.337 81 Template:Pagelang"," 16.85% 117.361 2 Template:Mbox"," 15.64% 108.941 127 Template:Translatable"," 13.39% 93.299 1 Template:Used_by"," 12.55% 87.427 1 Template:Flatlist"," 4.59% 31.962 1 Template:OnWikimedia"," 3.64% 25.339 1 Template:MW_version"]},"scribunto":{"limitreport-timeusage":{"value":"0.331","limit":"10.000"},"limitreport-memusage":{"value":17341213,"limit":52428800}},"cachereport":{"origin":"mw-api-int.codfw.main-849f99967d-g6sd7","timestamp":"20241123151904","ttl":2592000,"transientcontent":false}}});});</script> </body> </html>