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>Help:Extension:Translate/Insertables - 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":"f059453e-0baa-41df-86c6-e443d71b1777","wgCanonicalNamespace":"Help","wgCanonicalSpecialPageName":false,"wgNamespaceNumber":12,"wgPageName":"Help:Extension:Translate/Insertables","wgTitle":"Extension:Translate/Insertables","wgCurRevisionId":6597850,"wgRevisionId":6597850,"wgArticleId":154705,"wgIsArticle":true,"wgIsRedirect":false,"wgAction":"view","wgUserName":null,"wgUserGroups":["*"],"wgCategories":["Extension:Translate"],"wgPageViewLanguage":"en","wgPageContentLanguage":"en","wgPageContentModel":"wikitext","wgRelevantPageName":"Help:Extension:Translate/Insertables","wgRelevantArticleId":154705,"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":9000,"wgInternalRedirectTargetUrl":"/wiki/Help:Extension:Translate/Insertables","wgTranslatePageTranslation":"source","wgCentralAuthMobileDomain":false,"wgEditSubmitButtonLabelPublish":true,"wgDiscussionToolsFeaturesEnabled":{"replytool":true,"newtopictool":true,"sourcemodetoolbar":true,"topicsubscription":false,"autotopicsub":false,"visualenhancements":false,"visualenhancements_reply":false,"visualenhancements_pageframe":false},"wgDiscussionToolsFallbackEditMode":"visual","wgULSPosition":"personal","wgULSisCompactLinksEnabled":true,"wgVector2022LanguageInHeader":false,"wgULSisLanguageSelectorEmpty":false,"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","ext.discussionTools.init.styles":"ready","oojs-ui-core.styles":"ready","oojs-ui.styles.indicators":"ready","mediawiki.widgets.styles":"ready","oojs-ui-core.icons":"ready","skins.vector.search.codex.styles":"ready","skins.vector.styles":"ready","skins.vector.icons":"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","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.discussionTools.init","ext.eventLogging","ext.wikimediaEvents","ext.navigationTiming","ext.uls.compactlinks","ext.uls.interface","ext.checkUser.clientHints"];</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.discussionTools.init.styles%7Cext.pygments%2Ctranslate%2CwikimediaBadges%7Cext.translate.edit.documentation.styles%7Cext.translate.tag.languages%7Cext.uls.pt%7Cext.visualEditor.desktopArticleTarget.noscript%7Cext.wikimediamessages.styles%7Cmediawiki.widgets.styles%7Coojs-ui-core.icons%2Cstyles%7Coojs-ui.styles.indicators%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.5"> <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 name="viewport" content="width=1120"> <meta property="og:site_name" content="MediaWiki"> <meta property="og:title" content="Help:Extension:Translate/Insertables - 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/Help:Extension:Translate/Insertables"> <link rel="alternate" type="application/x-wiki" title="Edit" href="/w/index.php?title=Help:Extension:Translate/Insertables&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/Help:Extension:Translate/Insertables"> <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="ext-discussiontools-replytool-enabled ext-discussiontools-newtopictool-enabled ext-discussiontools-sourcemodetoolbar-enabled skin--responsive skin-vector skin-vector-search-vue mediawiki ltr sitedir-ltr mw-hide-empty-elt ns-12 ns-subject mw-editable page-Help_Extension_Translate_Insertables rootpage-Help_Extension_Translate 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:NewItem?site=mediawikiwiki&page=Help%3AExtension%3ATranslate%2FInsertables" 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/?wmf_source=donate&wmf_medium=sidebar&wmf_campaign=www.mediawiki.org&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=Help%3AExtension%3ATranslate%2FInsertables" 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=Help%3AExtension%3ATranslate%2FInsertables" 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/?wmf_source=donate&wmf_medium=sidebar&wmf_campaign=www.mediawiki.org&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=Help%3AExtension%3ATranslate%2FInsertables" 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=Help%3AExtension%3ATranslate%2FInsertables" 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-User_interface" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#User_interface"> <div class="vector-toc-text"> <span class="vector-toc-numb">1</span> <span>User interface</span> </div> </a> <ul id="toc-User_interface-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Configuration" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Configuration"> <div class="vector-toc-text"> <span class="vector-toc-numb">2</span> <span>Configuration</span> </div> </a> <ul id="toc-Configuration-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-Pre-provided_/_Bundled_insertables" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Pre-provided_/_Bundled_insertables"> <div class="vector-toc-text"> <span class="vector-toc-numb">3</span> <span>Pre-provided / Bundled insertables</span> </div> </a> <button aria-controls="toc-Pre-provided_/_Bundled_insertables-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 Pre-provided / Bundled insertables subsection</span> </button> <ul id="toc-Pre-provided_/_Bundled_insertables-sublist" class="vector-toc-list"> <li id="toc-HtmlTagInsertablesSuggester" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#HtmlTagInsertablesSuggester"> <div class="vector-toc-text"> <span class="vector-toc-numb">3.1</span> <span>HtmlTagInsertablesSuggester</span> </div> </a> <ul id="toc-HtmlTagInsertablesSuggester-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-MediaWikiInsertablesSuggester" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#MediaWikiInsertablesSuggester"> <div class="vector-toc-text"> <span class="vector-toc-numb">3.2</span> <span>MediaWikiInsertablesSuggester</span> </div> </a> <ul id="toc-MediaWikiInsertablesSuggester-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-NumericalParameterInsertablesSuggester" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#NumericalParameterInsertablesSuggester"> <div class="vector-toc-text"> <span class="vector-toc-numb">3.3</span> <span>NumericalParameterInsertablesSuggester</span> </div> </a> <ul id="toc-NumericalParameterInsertablesSuggester-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-RegexInsertablesSuggester" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#RegexInsertablesSuggester"> <div class="vector-toc-text"> <span class="vector-toc-numb">3.4</span> <span>RegexInsertablesSuggester</span> </div> </a> <ul id="toc-RegexInsertablesSuggester-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-TranslatablePageInsertablesSuggester" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#TranslatablePageInsertablesSuggester"> <div class="vector-toc-text"> <span class="vector-toc-numb">3.5</span> <span>TranslatablePageInsertablesSuggester</span> </div> </a> <ul id="toc-TranslatablePageInsertablesSuggester-sublist" class="vector-toc-list"> </ul> </li> <li id="toc-UrlInsertablesSuggester" class="vector-toc-list-item vector-toc-level-2"> <a class="vector-toc-link" href="#UrlInsertablesSuggester"> <div class="vector-toc-text"> <span class="vector-toc-numb">3.6</span> <span>UrlInsertablesSuggester</span> </div> </a> <ul id="toc-UrlInsertablesSuggester-sublist" class="vector-toc-list"> </ul> </li> </ul> </li> <li id="toc-Adding_a_custom_insertable" class="vector-toc-list-item vector-toc-level-1 vector-toc-list-item-expanded"> <a class="vector-toc-link" href="#Adding_a_custom_insertable"> <div class="vector-toc-text"> <span class="vector-toc-numb">4</span> <span>Adding a custom insertable</span> </div> </a> <ul id="toc-Adding_a_custom_insertable-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">Help</span><span class="mw-page-title-separator">:</span><span class="mw-page-title-main">Extension:Translate/Insertables</span></h1> <div class="mw-indicators"> </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-help" class="selected vector-tab-noicon mw-list-item"><a href="/wiki/Help:Extension:Translate/Insertables" title="View the help page [c]" accesskey="c"><span>Help</span></a></li><li id="ca-talk" class="new vector-tab-noicon mw-list-item"><a href="/w/index.php?title=Help_talk:Extension:Translate/Insertables&action=edit&redlink=1" rel="discussion" class="new" title="Discussion about the content page (page does not exist) [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/Help:Extension:Translate/Insertables"><span>Read</span></a></li><li id="ca-edit" class="vector-tab-noicon mw-list-item"><a href="/w/index.php?title=Help:Extension:Translate/Insertables&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=Help:Extension:Translate/Insertables&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/Help:Extension:Translate/Insertables"><span>Read</span></a></li><li id="ca-more-edit" class="vector-more-collapsible-item mw-list-item"><a href="/w/index.php?title=Help:Extension:Translate/Insertables&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=Help:Extension:Translate/Insertables&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/Help:Extension:Translate/Insertables" 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/Help:Extension:Translate/Insertables" 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=Help:Extension:Translate/Insertables&oldid=6597850" 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=Help:Extension:Translate/Insertables&action=info" title="More information about this page"><span>Page information</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%2FHelp%3AExtension%3ATranslate%2FInsertables"><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%2FHelp%3AExtension%3ATranslate%2FInsertables"><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=Help%3AExtension%3ATranslate%2FInsertables"><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=Help%3AExtension%3ATranslate%2FInsertables&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=Help:Extension:Translate/Insertables&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 emptyPortlet" > <div class="vector-menu-heading"> In other projects </div> <div class="vector-menu-content"> <ul class="vector-menu-content-list"> </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 class="subpages">< <bdi dir="ltr"><a href="/wiki/Special:MyLanguage/Help:Extension:Translate" title="Special:MyLanguage/Help:Extension:Translate">Help:Extension:Translate</a></bdi></div></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-Help%3AExtension%3ATranslate%2FInsertables&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/Help:Extension:Translate/Insertables/de" class="mw-pt-progress mw-pt-progress--med" title="Hilfe:Erweiterung:Übersetzen/Einsetzelemente (61% 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/Help:Extension:Translate/Insertables/ha" class="mw-pt-progress mw-pt-progress--low" title="Help:Extension:Translate/Insertables/ha (5% translated)" lang="ha" dir="ltr">Hausa</a></li> <li><a href="/wiki/Help:Extension:Translate/Insertables/nl" class="mw-pt-progress mw-pt-progress--complete" title="Help:Extension:Translate/Insertables/nl (100% translated)" lang="nl" dir="ltr">Nederlands</a></li> <li><a href="/wiki/Help:Extension:Translate/Insertables/tr" class="mw-pt-progress mw-pt-progress--low" title="Help:Extension:Translate/Insertables/tr (8% translated)" lang="tr" dir="ltr">Türkçe</a></li> <li><a href="/wiki/Help:Extension:Translate/Insertables/fr" class="mw-pt-progress mw-pt-progress--med" title="Help:Extension:Translate/Elements insérables (65% translated)" lang="fr" dir="ltr">français</a></li> <li><a href="/wiki/Help:Extension:Translate/Insertables/fi" class="mw-pt-progress mw-pt-progress--low" title="Help:Extension:Translate/Insertables/fi (10% translated)" lang="fi" dir="ltr">suomi</a></li> <li><a href="/wiki/Help:Extension:Translate/Insertables/cs" class="mw-pt-progress mw-pt-progress--complete" title="Nápověda:Rozšíření:Překlad/Zástupné elementy (100% translated)" lang="cs" dir="ltr">čeština</a></li> <li><a href="/wiki/Help:Extension:Translate/Insertables/ru" class="mw-pt-progress mw-pt-progress--med" title="Справка:Расширение:Перевод/Вставки (18% translated)" lang="ru" dir="ltr">русский</a></li> <li><a href="/wiki/Help:Extension:Translate/Insertables/fa" class="mw-pt-progress mw-pt-progress--low" title="Help:Extension:Translate/قابل‌درج‌ها (2% translated)" lang="fa" dir="rtl">فارسی</a></li> <li><a href="/wiki/Help:Extension:Translate/Insertables/zh" class="mw-pt-progress mw-pt-progress--high" title="-{zh:Help; zh-hans:帮助; zh-hant:說明;}-:-{zh-hans:扩展; zh-hant:擴充功能;}-:翻译/插入式 (90% translated)" lang="zh" dir="ltr">中文</a></li> <li><a href="/wiki/Help:Extension:Translate/Insertables/ja" class="mw-pt-progress mw-pt-progress--med" title="Help:Extension:Translate/挿入要素 (40% translated)" lang="ja" dir="ltr">日本語</a></li></ul></div> <style data-mw-deduplicate="TemplateStyles:r6806430">.mw-parser-output .extension-translate-navcolumn{margin-bottom:.5em;border:1px solid var(--border-color-base,#a2a9b1);padding:5px;background-color:var(--background-color-base,#fff)}@media(min-width:720px){.mw-parser-output .extension-translate-navcolumn{margin-left:.5em;width:21em}.mw-parser-output .extension-translate-navcolumn-align-primary{float:left;clear:left}.mw-parser-output .extension-translate-navcolumn-align-secondary{float:right;clear:right}}.mw-parser-output .extension-translate-navcolumn-title{font-size:larger;font-weight:bold;padding-bottom:.5em;border-bottom:solid 1.5em var(--border-color-success,#2cb491);margin-bottom:1em}</style> <div class="extension-translate-navcolumn plainlinks extension-translate-navcolumn-align-secondary"> <div class="extension-translate-navcolumn-title">Documentation for <a href="/wiki/Special:MyLanguage/Extension:Translate" title="Special:MyLanguage/Extension:Translate">Extension:Translate</a><span style="display:none"><a href="/wiki/Extension:Translate" title="Extension:Translate"> </a></span></div> <p><b>Translators</b> (<a href="/wiki/Special:MyLanguage/Help:Extension:Translate" title="Special:MyLanguage/Help:Extension:Translate">main help page</a><span style="display:none"><a href="/wiki/Help:Extension:Translate" title="Help:Extension:Translate"> </a></span>) </p> <ul><li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Translation_example" title="Special:MyLanguage/Help:Extension:Translate/Translation example">How to translate</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Translation_example" title="Help:Extension:Translate/Translation example"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Translation_best_practices" title="Special:MyLanguage/Help:Extension:Translate/Translation best practices">Best practices</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Translation_best_practices" title="Help:Extension:Translate/Translation best practices"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Statistics_and_reporting" title="Special:MyLanguage/Help:Extension:Translate/Statistics and reporting">Statistics and reporting</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Statistics_and_reporting" title="Help:Extension:Translate/Statistics and reporting"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Quality_assurance" title="Special:MyLanguage/Help:Extension:Translate/Quality assurance">Quality assurance</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Quality_assurance" title="Help:Extension:Translate/Quality assurance"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Message_group_states" title="Special:MyLanguage/Help:Extension:Translate/Message group states">Message group states</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Message_group_states" title="Help:Extension:Translate/Message group states"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Off-line_translation" title="Special:MyLanguage/Help:Extension:Translate/Off-line translation">Offline translation</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Off-line_translation" title="Help:Extension:Translate/Off-line translation"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Glossary" title="Special:MyLanguage/Help:Extension:Translate/Glossary">Glossary</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Glossary" title="Help:Extension:Translate/Glossary"> </a></span></li></ul> <p><b>Translation administrators</b> </p> <ul><li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Page_translation_example" title="Special:MyLanguage/Help:Extension:Translate/Page translation example">How to prepare a page for translation</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Page_translation_example" title="Help:Extension:Translate/Page translation example"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Page_translation_administration" title="Special:MyLanguage/Help:Extension:Translate/Page translation administration">Page translation administration</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Page_translation_administration" title="Help:Extension:Translate/Page translation administration"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Unstructured_element_translation" title="Special:MyLanguage/Help:Extension:Translate/Unstructured element translation">Unstructured element translation</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Unstructured_element_translation" title="Help:Extension:Translate/Unstructured element translation"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Group_management" title="Special:MyLanguage/Help:Extension:Translate/Group management">Group management</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Group_management" title="Help:Extension:Translate/Group management"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Move_translatable_page" title="Special:MyLanguage/Help:Extension:Translate/Move translatable page">Move translatable page</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Move_translatable_page" title="Help:Extension:Translate/Move translatable page"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Import_Translations_via_CSV" title="Special:MyLanguage/Help:Extension:Translate/Import Translations via CSV">Import translations via CSV</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Import_Translations_via_CSV" title="Help:Extension:Translate/Import Translations via CSV"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Message_Bundles" title="Special:MyLanguage/Help:Extension:Translate/Message Bundles">Working with message bundles</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Message_Bundles" title="Help:Extension:Translate/Message Bundles"> </a></span></li></ul> <p><b>Sysadmins and developers</b> </p> <ul><li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Installation" title="Special:MyLanguage/Help:Extension:Translate/Installation">Installation</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Installation" title="Help:Extension:Translate/Installation"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Configuration" title="Special:MyLanguage/Help:Extension:Translate/Configuration">Configuration</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Configuration" title="Help:Extension:Translate/Configuration"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Getting_started_with_development" title="Special:MyLanguage/Help:Extension:Translate/Getting started with development">Getting started with development</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Getting_started_with_development" title="Help:Extension:Translate/Getting started with development"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Developer_guide" title="Special:MyLanguage/Help:Extension:Translate/Developer guide">Developer guide</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Developer_guide" title="Help:Extension:Translate/Developer guide"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Components" title="Special:MyLanguage/Help:Extension:Translate/Components">Extending Translate</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Components" title="Help:Extension:Translate/Components"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Validators" title="Special:MyLanguage/Help:Extension:Translate/Validators">Validators</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Validators" title="Help:Extension:Translate/Validators"> </a></span></li> <li><b><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Insertables" title="Special:MyLanguage/Help:Extension:Translate/Insertables">Insertables</a></b><span style="display:none"><a class="mw-selflink selflink"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Group_configuration" title="Special:MyLanguage/Help:Extension:Translate/Group configuration">Group configuration</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Group_configuration" title="Help:Extension:Translate/Group configuration"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Group_configuration_example" title="Special:MyLanguage/Help:Extension:Translate/Group configuration example">Group configuration example</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Group_configuration_example" title="Help:Extension:Translate/Group configuration example"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Translation_memories" title="Special:MyLanguage/Help:Extension:Translate/Translation memories">Translation memories</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Translation_memories" title="Help:Extension:Translate/Translation memories"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Translation_aids" title="Special:MyLanguage/Help:Extension:Translate/Translation aids">Translation aids</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Translation_aids" title="Help:Extension:Translate/Translation aids"> </a></span></li> <li><a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Message_Bundles#Enabling_message_bundle_integration" title="Special:MyLanguage/Help:Extension:Translate/Message Bundles">Enabling message bundles</a><span style="display:none"><a href="/wiki/Help:Extension:Translate/Message_Bundles#Enabling_message_bundle_integration" title="Help:Extension:Translate/Message Bundles"> </a></span></li> <li><a class="external text" href="https://doc.wikimedia.org/Translate/master/php/classMediaWiki_1_1Extension_1_1Translate_1_1HookRunner.html">PHP hooks</a></li></ul> <p><small><a class="external text" href="https://www.mediawiki.org/w/index.php?title=Special:Translate&group=page-Template%3AExtension-Translate&language=&action=page&filter=">Translate this template</a></small> </p> </div> <p>Translatable strings often contain markup that should be retained as-is in the translation. Typing that markup can be slow and difficult because special characters are common. Insertable is a piece of markup that is presented to the translator as a button or other interface element. Clicking the button inserts the piece of markup into the translation to the current cursor position. </p><p>Each message group can have one <code>InsertablesSuggester</code>. This class is responsible for generating a list of <code>Insertable</code>s. Each <code>Insertable</code> has three parts: </p> <ol><li>What to display to the user</li> <li>What is inserted before cursor position in the translation or what replaces the selected content.</li> <li>What is inserted after cursor position in the translation</li></ol> <p>Translate extension comes with <code>MediaWikiInsertablesSuggester</code> built-in. Suggesters for other type of content can be found in the <a href="https://phabricator.wikimedia.org/diffusion/GTWN/browse/groups" class="extiw" title="phab:diffusion/GTWN/browse/groups">translatewiki.net git repository</a>. </p> <meta property="mw:PageProp/toc"/> <div class="mw-heading mw-heading2 ext-discussiontools-init-section"><h2 id="User_interface" data-mw-thread-id="h-User_interface"><span data-mw-comment-start="" id="h-User_interface"></span>User interface<span data-mw-comment-end="h-User_interface"></span></h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=1" title="Edit section: User interface"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <figure class="mw-halign-left" typeof="mw:File/Thumb"><a href="/wiki/File:Translate_extension_Insertables_interface.png" class="mw-file-description"><img src="//upload.wikimedia.org/wikipedia/commons/thumb/a/a2/Translate_extension_Insertables_interface.png/600px-Translate_extension_Insertables_interface.png" decoding="async" width="600" height="222" class="mw-file-element" srcset="//upload.wikimedia.org/wikipedia/commons/thumb/a/a2/Translate_extension_Insertables_interface.png/900px-Translate_extension_Insertables_interface.png 1.5x, //upload.wikimedia.org/wikipedia/commons/a/a2/Translate_extension_Insertables_interface.png 2x" data-file-width="1061" data-file-height="392"/></a><figcaption>Insertables show in the bottom of the translation text area. They provide quick access for inserting pieces of mark-up that does not vary per language.</figcaption></figure> <div style="clear: both;"></div> <div class="mw-heading mw-heading2 ext-discussiontools-init-section"><h2 id="Configuration" data-mw-thread-id="h-Configuration"><span data-mw-comment-start="" id="h-Configuration"></span>Configuration<span data-mw-comment-end="h-Configuration"></span></h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=2" title="Edit section: Configuration"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>Here's a sample configuration change in a YAML file, </p> <div class="mw-highlight mw-highlight-lang-yaml mw-content-ltr mw-highlight-lines" dir="ltr"><pre><span></span><span class="linenos" data-line="1"></span><span class="nt">INSERTABLES</span><span class="p">:</span> <span class="linenos" data-line="2"></span><span class="w"> </span><span class="c1"># pre-bundled insertable</span> <span class="linenos" data-line="3"></span><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">class</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RegexInsertablesSuggester</span> <span class="linenos" data-line="4"></span><span class="w"> </span><span class="nt">params</span><span class="p">:</span><span class="w"> </span><span class="s">"/</span><span class="err">\</span><span class="s">$[a-zA-Z0-9]+/"</span> <span class="linenos" data-line="5"></span><span class="w"> </span><span class="c1"># custom insertable</span> <span class="linenos" data-line="6"></span><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">class</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">FreeColInsertablesSuggester</span> <span class="linenos" data-line="7"></span> <span class="linenos" data-line="8"></span><span class="nt">AUTOLOAD</span><span class="p">:</span> <span class="linenos" data-line="9"></span><span class="w"> </span><span class="nt">FreeColInsertablesSuggester</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Suggester.php</span> </pre></div> <div class="mw-heading mw-heading2 ext-discussiontools-init-section"><h2 id="Pre-provided_/_Bundled_insertables" data-mw-thread-id="h-Pre-provided_/_Bundled_insertables"><span id="Pre-provided_.2F_Bundled_insertables"></span><span data-mw-comment-start="" id="h-Pre-provided_/_Bundled_insertables"></span>Pre-provided / Bundled insertables<span data-mw-comment-end="h-Pre-provided_/_Bundled_insertables"></span></h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=3" title="Edit section: Pre-provided / Bundled insertables"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>Following is a list of bundled insertables. </p> <div class="mw-heading mw-heading3"><h3 id="HtmlTagInsertablesSuggester" data-mw-thread-id="h-HtmlTagInsertablesSuggester-Pre-provided_/_Bundled_insertables"><span data-mw-comment-start="" id="h-HtmlTagInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span>HtmlTagInsertablesSuggester<span data-mw-comment-end="h-HtmlTagInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span></h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=4" title="Edit section: HtmlTagInsertablesSuggester"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>This insertable will display suggestion for any HTML tags found inside the source string. </p><p>For example: </p> <ul><li>Message: <i>This <a href="abc">link</a>link takes you to the home page.</i></li> <li>Suggester displayed: <code><a href="abc"></a></code></li></ul> <div class="mw-heading mw-heading3"><h3 id="MediaWikiInsertablesSuggester" data-mw-thread-id="h-MediaWikiInsertablesSuggester-Pre-provided_/_Bundled_insertables"><span data-mw-comment-start="" id="h-MediaWikiInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span>MediaWikiInsertablesSuggester<span data-mw-comment-end="h-MediaWikiInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span></h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=5" title="Edit section: MediaWikiInsertablesSuggester"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>This insertable will display various suggestion for MediaWiki related wikitext messages. These include suggestion for, </p> <ul><li>Parameters like <code>$1user</code> which are present in API Help messages.</li> <li><code>PLURALS</code>, <code>GENDER</code>, <code>GRAMMAR</code></li> <li>Suggestions for HTML tags.</li></ul> <div class="mw-heading mw-heading3"><h3 id="NumericalParameterInsertablesSuggester" data-mw-thread-id="h-NumericalParameterInsertablesSuggester-Pre-provided_/_Bundled_insertables"><span data-mw-comment-start="" id="h-NumericalParameterInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span>NumericalParameterInsertablesSuggester<span data-mw-comment-end="h-NumericalParameterInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span></h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=6" title="Edit section: NumericalParameterInsertablesSuggester"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>This insertable will display suggestions for numerical parameters such as <code>$1</code>, <code>$2</code>, <code>$33</code> </p> <div class="mw-heading mw-heading3"><h3 id="RegexInsertablesSuggester" data-mw-thread-id="h-RegexInsertablesSuggester-Pre-provided_/_Bundled_insertables"><span data-mw-comment-start="" id="h-RegexInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span>RegexInsertablesSuggester<span data-mw-comment-end="h-RegexInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span></h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=7" title="Edit section: RegexInsertablesSuggester"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>This insertable is a general purpose insertable that can be used to display suggestions based on a custom regular expression. </p><p>Example: </p> <div class="mw-highlight mw-highlight-lang-yaml mw-content-ltr mw-highlight-lines" dir="ltr"><pre><span></span><span class="linenos" data-line="1"></span><span class="w"> </span><span class="c1"># simple example</span> <span class="linenos" data-line="2"></span><span class="w"> </span><span class="c1"># matches and suggests: $abc</span> <span class="linenos" data-line="3"></span><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">class</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RegexInsertablesSuggester</span> <span class="linenos" data-line="4"></span><span class="w"> </span><span class="nt">params</span><span class="p">:</span><span class="w"> </span><span class="s">"/</span><span class="err">\</span><span class="s">$[a-zA-Z0-9]+/"</span> <span class="linenos" data-line="5"></span><span class="w"> </span><span class="c1"># complex example using named captures.</span> <span class="linenos" data-line="6"></span><span class="w"> </span><span class="c1"># matches: [abc](ac) </span> <span class="linenos" data-line="7"></span><span class="w"> </span><span class="c1"># suggester displayed: [](ac)</span> <span class="linenos" data-line="8"></span><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">class</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">RegexInsertablesSuggester</span> <span class="linenos" data-line="9"></span><span class="w"> </span><span class="nt">params</span><span class="p">:</span> <span class="linenos" data-line="10"></span><span class="w"> </span><span class="nt">regex</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">/(?<pre>\[)[^]]+(?<post>\]$[^)]+$)/</span> <span class="linenos" data-line="11"></span><span class="w"> </span><span class="nt">display</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">$pre $post</span> <span class="linenos" data-line="12"></span><span class="w"> </span><span class="nt">pre</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">$pre</span> <span class="linenos" data-line="13"></span><span class="w"> </span><span class="nt">post</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">$post</span> </pre></div> <p>Parameter description, </p> <ul><li><b>regex</b> – The regex to use for identifying insertables. Mandatory.</li> <li><b>display</b> – What to show to the user. Not mandatory, defaults to matched value.</li> <li><b>pre</b> – What to insert before selection, or replace selection if <code>post</code> remains empty Not mandatory, defaults to matched value.</li> <li><b>post</b> – What to insert after selection. Not mandatory, defaults to matched value.</li></ul> <div class="mw-heading mw-heading3"><h3 id="TranslatablePageInsertablesSuggester" data-mw-thread-id="h-TranslatablePageInsertablesSuggester-Pre-provided_/_Bundled_insertables"><span data-mw-comment-start="" id="h-TranslatablePageInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span>TranslatablePageInsertablesSuggester<span data-mw-comment-end="h-TranslatablePageInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span></h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=8" title="Edit section: TranslatablePageInsertablesSuggester"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>Used primarily on translatable pages to provide suggester for variables like <code>$abc</code>. </p> <div class="mw-heading mw-heading3"><h3 id="UrlInsertablesSuggester" data-mw-thread-id="h-UrlInsertablesSuggester-Pre-provided_/_Bundled_insertables"><span data-mw-comment-start="" id="h-UrlInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span>UrlInsertablesSuggester<span data-mw-comment-end="h-UrlInsertablesSuggester-Pre-provided_/_Bundled_insertables"></span></h3><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=9" title="Edit section: UrlInsertablesSuggester"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>This insertable finds URLs (that are normally unchanged in translations) and suggests them for insertion. </p> <div class="mw-heading mw-heading2 ext-discussiontools-init-section"><h2 id="Adding_a_custom_insertable" data-mw-thread-id="h-Adding_a_custom_insertable"><span data-mw-comment-start="" id="h-Adding_a_custom_insertable"></span>Adding a custom insertable<span data-mw-comment-end="h-Adding_a_custom_insertable"></span></h2><span class="mw-editsection"><span class="mw-editsection-bracket">[</span><a href="/w/index.php?title=Help:Extension:Translate/Insertables&action=edit&section=10" title="Edit section: Adding a custom insertable"><span>edit</span></a><span class="mw-editsection-bracket">]</span></span></div> <p>In case existing insertables are not sufficient to meet your requirements, it is possible to add custom insertables. </p><p>Here is an example about adding insertables support for existing file based message group: FreeCol. The YAML file has been <a href="/wiki/Special:MyLanguage/Help:Extension:Translate/Group_configuration_example" title="Special:MyLanguage/Help:Extension:Translate/Group configuration example">trimmed for brevity</a>. The newly added lines are highlighted. </p><p>FreeCol.yaml: </p> <div class="mw-highlight mw-highlight-lang-yaml mw-content-ltr" dir="ltr"><pre><span></span><span class="nn">---</span> <span class="nt">BASIC</span><span class="p">:</span> <span class="w"> </span><span class="nt">id</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">out-freecol</span> <span class="w"> </span><span class="nt">label</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">FreeCol</span> <span class="w"> </span><span class="nt">description</span><span class="p">:</span><span class="w"> </span><span class="s">"A</span><span class="nv"> </span><span class="s">strategy</span><span class="nv"> </span><span class="s">game"</span> <span class="w"> </span><span class="nt">namespace</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">NS_FREECOL</span> <span class="w"> </span><span class="nt">class</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">FileBasedMessageGroup</span> <span class="w"> </span> <span class="nt">FILES</span><span class="p">:</span> <span class="w"> </span><span class="nt">class</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">JavaFFS</span> <span class="w"> </span><span class="nt">sourcePattern</span><span class="p">:</span><span class="w"> </span><span class="err">%</span><span class="l l-Scalar l-Scalar-Plain">GROUPROOT%/freecol/data/strings/FreeColMessages_%CODE%.properties</span> <span class="w"> </span><span class="nt">definitionFile</span><span class="p">:</span><span class="w"> </span><span class="err">%</span><span class="l l-Scalar l-Scalar-Plain">GROUPROOT%/freecol/data/strings/FreeColMessages.properties</span> <span class="w"> </span><span class="nt">targetPattern</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">freecol/data/strings/FreeColMessages_%CODE%.properties</span> <span class="nt">INSERTABLES</span><span class="p">:</span> <span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">class</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">FreeColInsertablesSuggester</span> <span class="nt">AUTOLOAD</span><span class="p">:</span> <span class="w"> </span><span class="nt">FreeColInsertablesSuggester</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Suggester.php</span> </pre></div> <p>Suggester.php: </p> <div class="mw-highlight mw-highlight-lang-php mw-content-ltr" dir="ltr"><pre><span></span><span class="k">class</span> <span class="nc">FreecolInsertablesSuggester</span> <span class="p">{</span> <span class="k">public</span> <span class="k">function</span> <span class="nf">getInsertables</span><span class="p">(</span> <span class="nv">$text</span> <span class="p">)</span> <span class="p">{</span> <span class="nv">$insertables</span> <span class="o">=</span> <span class="k">array</span><span class="p">();</span> <span class="nv">$matches</span> <span class="o">=</span> <span class="k">array</span><span class="p">();</span> <span class="c1">// Find variables of format %name%</span> <span class="c1">// This is the same regular expression as in Checker.php</span> <span class="nb">preg_match_all</span><span class="p">(</span> <span class="s1">'/%[a-zA-Z_]+%/'</span><span class="p">,</span> <span class="nv">$text</span><span class="p">,</span> <span class="nv">$matches</span><span class="p">,</span> <span class="nx">PREG_SET_ORDER</span> <span class="p">);</span> <span class="nv">$new</span> <span class="o">=</span> <span class="nb">array_map</span><span class="p">(</span> <span class="k">function</span><span class="p">(</span> <span class="nv">$match</span> <span class="p">)</span> <span class="p">{</span> <span class="c1">// $match[0] is full match, and we don't have any submatches here</span> <span class="c1">// Since we want the cursor to be at the end of the insertion, we put the whole thing into the "pre" field.</span> <span class="k">return</span> <span class="k">new</span> <span class="nx">Insertable</span><span class="p">(</span> <span class="nv">$match</span><span class="p">[</span><span class="mi">0</span><span class="p">],</span> <span class="nv">$match</span><span class="p">[</span><span class="mi">0</span><span class="p">]</span> <span class="p">);</span> <span class="p">},</span> <span class="nv">$matches</span> <span class="p">);</span> <span class="k">return</span> <span class="nv">$insertables</span><span class="p">;</span> <span class="p">}</span> <span class="p">}</span> </pre></div> <p>The parameters to Insertable are: </p> <div class="mw-highlight mw-highlight-lang-php mw-content-ltr" dir="ltr"><pre><span></span><span class="k">class</span> <span class="nc">Insertable</span> <span class="p">{</span> <span class="sd">/**</span> <span class="sd"> * @param string $display What to show to the user</span> <span class="sd"> * @param string $pre What to insert before selection, or replace selection if $post remains empty</span> <span class="sd"> * @param string $post What to insert after selection</span> <span class="sd"> */</span> <span class="k">public</span> <span class="k">function</span> <span class="fm">__construct</span><span class="p">(</span> <span class="nv">$display</span><span class="p">,</span> <span class="nv">$pre</span> <span class="o">=</span> <span class="s1">''</span><span class="p">,</span> <span class="nv">$post</span> <span class="o">=</span> <span class="s1">''</span> <span class="p">)</span> <span class="p">{</span> <span class="nv">$this</span><span class="o">-></span><span class="na">display</span> <span class="o">=</span> <span class="nv">$display</span><span class="p">;</span> <span class="nv">$this</span><span class="o">-></span><span class="na">pre</span> <span class="o">=</span> <span class="nv">$pre</span><span class="p">;</span> <span class="nv">$this</span><span class="o">-></span><span class="na">post</span> <span class="o">=</span> <span class="nv">$post</span><span class="p">;</span> <span class="p">}</span> <span class="p">[</span><span class="o">...</span><span class="p">]</span> <span class="p">}</span> </pre></div>    </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=Help:Extension:Translate/Insertables&oldid=6597850">https://www.mediawiki.org/w/index.php?title=Help:Extension:Translate/Insertables&oldid=6597850</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">Category</a>: <ul><li><a href="/wiki/Category:Extension:Translate" title="Category:Extension:Translate">Extension:Translate</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 23 June 2024, at 22:49.</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=Help:Extension:Translate/Insertables&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-6df7948d6c-s44lk","wgBackendResponseTime":121,"wgDiscussionToolsPageThreads":[{"headingLevel":2,"name":"h-","type":"heading","level":0,"id":"h-User_interface","replies":[]},{"headingLevel":2,"name":"h-","type":"heading","level":0,"id":"h-Configuration","replies":[]},{"headingLevel":2,"name":"h-","type":"heading","level":0,"id":"h-Pre-provided_/_Bundled_insertables","replies":[{"headingLevel":3,"name":"h-","type":"heading","level":0,"id":"h-HtmlTagInsertablesSuggester-Pre-provided_/_Bundled_insertables","replies":[]},{"headingLevel":3,"name":"h-","type":"heading","level":0,"id":"h-MediaWikiInsertablesSuggester-Pre-provided_/_Bundled_insertables","replies":[]},{"headingLevel":3,"name":"h-","type":"heading","level":0,"id":"h-NumericalParameterInsertablesSuggester-Pre-provided_/_Bundled_insertables","replies":[]},{"headingLevel":3,"name":"h-","type":"heading","level":0,"id":"h-RegexInsertablesSuggester-Pre-provided_/_Bundled_insertables","replies":[]},{"headingLevel":3,"name":"h-","type":"heading","level":0,"id":"h-TranslatablePageInsertablesSuggester-Pre-provided_/_Bundled_insertables","replies":[]},{"headingLevel":3,"name":"h-","type":"heading","level":0,"id":"h-UrlInsertablesSuggester-Pre-provided_/_Bundled_insertables","replies":[]}]},{"headingLevel":2,"name":"h-","type":"heading","level":0,"id":"h-Adding_a_custom_insertable","replies":[]}],"wgPageParseReport":{"discussiontools":{"limitreport-timeusage":"0.027"},"limitreport":{"cputime":"0.299","walltime":"0.726","ppvisitednodes":{"value":1512,"limit":1000000},"postexpandincludesize":{"value":20782,"limit":2097152},"templateargumentsize":{"value":8210,"limit":2097152},"expansiondepth":{"value":14,"limit":100},"expensivefunctioncount":{"value":8,"limit":500},"unstrip-depth":{"value":0,"limit":20},"unstrip-size":{"value":14295,"limit":5000000},"entityaccesscount":{"value":0,"limit":400},"timingprofile":["100.00% 119.636 1 -total"," 95.16% 113.847 1 Template:Extension-Translate"," 83.85% 100.317 28 Template:Ll"," 59.44% 71.108 56 Template:Translatable"," 51.10% 61.137 29 Template:Pagelang"," 4.67% 5.592 1 Translations:Extension:Translate/Page_display_title/en"," 3.93% 4.702 1 Template:TNTN"," 3.25% 3.886 1 Template:Dir"," 1.42% 1.697 1 Template:Clear"]},"scribunto":{"limitreport-timeusage":{"value":"0.036","limit":"10.000"},"limitreport-memusage":{"value":1059416,"limit":52428800}},"cachereport":{"origin":"mw-web.codfw.main-6b7f745dd4-b9kq8","timestamp":"20241125135716","ttl":2592000,"transientcontent":false}}});});</script> </body> </html>