Wiki Baike:User scripts/Techniques

This page will collect various techniques for achieving common tasks needed in writing user scripts. Discussion about limitations, relative portability, and speed of the various alternatives is strongly encouraged. There is a lot of duplication and non-optimal efforts out there, and this will hopefully encourage us to write tighter, more correct code, both easier and faster.

An advanced API for interacting with Wikipedia content is being developed, large parts of which are already operational. The various possibilities are described at mw:API. The idea is to send an AJAX request (see below) to the API containing a query. The result of this query can be returned in several formats, of which JSON is perhaps the most useful, see below.

Identifying the type of pageedit

This refers to techniques for identifying the current namespace of the current page, whether or not it is an edit page, a preview page, a Special page, etc.

Preview pagesedit

document.getElementById("wikiPreview")

Edit pagesedit

document.getElementById("editform")

This will be null when not editing a page.

History pagesedit

mw.config.get('wgAction') === 'history'

Special pagesedit

mw.config.get('wgCanonicalNamespace') === 'Special'

Pages with historyedit

document.getElementById('ca-history')

Editable pagesedit

document.getElementById('ca-edit')

Be advised that this also returns the edit tab if you're currently editing the page.

Getting various parts of a pageedit

Getting the page title and namespaceedit

  • mw.config.get('wgCanonicalNamespace') contains the name of the namespace, e.g. "" for article space
  • mw.config.get('wgCanonicalSpecialPageName') is normally false but for special pages it contains the non-localized name.
  • mw.config.get('wgNamespaceNumber') is 0 for the main namespace, -1 for special pages, and other values for other namespaces.
  • mw.config.get('wgPageName') is the article name as it is shown on the url, e.g. "Wiki:User_scripts/Techniques". It includes the namespace identifier.
  • mw.config.get('wgTitle') is the title of the article, without namespace identifier or escaping, e.g. "User scripts/Techniques".

Getting the various toolbars (personal, tabs, sidebar)edit

var tabs = document.getElementById(BAR NAME).getElementsByTagName('ul')[0];
  • Where BAR NAME is one of the following strings:
  • 'p-cactions' - the tabs at the top of the page (with the article, discussion, edit, history, move, and watch links)
  • 'p-personal' - the personal toolbar (i.e. the one at the top, with a link to user page, user talk, prefs, watchlist, contribs, log out)
  • 'p-navigation' - the navigation toolbar (i.e. Main page, Featured Content, etc.)
  • 'p-interaction' - the interaction toolbar, below the navigation toolbar
  • 'p-tb' - the toolbox (What links here, Related changes etc.)

TODO: Someone please test the search and toolbox ones, and see if they work the same. Thanks!

The search box is 'p-search' but there's no <ul> element in it. [ælfəks] 10:38, 24 June 2006 (UTC)[reply]
The search box can be retrieved by simply replacing the 'ul' in getElementsByTagName('ul') with 'div', as all the toolboxes' ids are in div tags. Extremecircuitz (Talk | Userboxes page) 20:17, 21 October 2007 (UTC)[reply]

Inserting contentedit

document.getElementById("content").insertBefore(document.createTextNode("abcdef"), document.getElementsByTagName("h1")[0])
  • On a page with a h1 heading, this works in Firefox 1.0.4 on OSX, but fails on some other browsers. Anyone know how or why? JesseW 20:58, 29 August 2005 (UTC)[reply]
  • No, but does it help if you delay execution until the page has loaded? Lupin|talk|popups 12:14, 4 October 2005 (UTC)[reply]

Pressing buttonsedit

document.editform.wpDiff.click()
  • Presses the diff button.

Altering existing interface linksedit

To change the url, name, or any other aspect of existing tab buttons, personal bar links, or other links, use the following: (where id is the id of the link to be changed, e.g. "pt-preferences", "ca-edit", "n-portal" or "t-whatlinkshere"; url is the new URL, and name is the new displayed name for the link, e.g. "my preferences", "edit this page", "Community Portal", or "What links here")

document.getElementById(id).childNodes[0].href=urlq=document.getElementById(id).firstChild; q.removeChild(q.firstChild); q.appendChild(document.createTextNode(name)) 

Onload Structureedit

jQuery can attach functions to the onLoad event:

$( myFunction );

Functions can also be written inline as

$( function() {    // Code here} );

Do not assign window.onload to a function directly, as this overwrites any other onLoad functions that may have been previously set.

Include an external js-file on wikipediaedit

mw.loader.load is a loader method to load external javascript or css:

mw.loader.load( 'http://meta.wikimedia.org/w/index.php?title=MediaWiki:Wikiminiatlas.js&action=raw&ctype=text/javascript', 'text/javascript' );mw.loader.load( 'http://example.org/mystyles.css', 'text/css' );mw.loader.load( 'http://example.org/mystyles.js', 'text/javascript' );

AJAXedit

See Baike: WikiProject User scripts/Guide#Ajax
$.getScript('http://example.org/foo.js', function () { // Foo.js is loaded!} )

Automatic editsedit

On classic edit pages you can find the textbox with the wikitext like this:

var t = document.editform.wpTextbox1;

Then use the methods of the textSelection plugin to interact with the textarea or edit summary. This module makes sure that your modification works in combination with other modules that want to manipulate the value of the textarea, like syntax highlighting modules.

JSONedit

Parsing JSON text, as delivered by e.g. the MediaWiki API is done automatically when using jQuery utilities:

jQuery.getJSON(  mw.util.wikiScript( 'api' ), {    'format': 'json',    'action': 'query',    'meta': 'userinfo'  }, function ( data ) {    // data.query.userinfo  });

Update a scriptedit

Scripts on a user's computer are updated to the most recent version by bypassing (clearing) the browser cache - the user has to push Shift-Reload (Mozilla) or Shift-F5 (MS-IE). A JavaScript can do the same by calling:

window.location.reload(true);

This forced reload ("forceGet") immediately reloads the current page including all images, scripts, and stylesheets. This should not be done from edit or preview pages as the edits might get lost.

For users that have a lot of scripts installed, reloading them all may take up a lot of time. See Gerbrant.mng.decache and its talk page for example code on how you can let JavaScript remove arbitrary files from your browser cache using an external application.

Edit a page on another Wikimedia wikiedit

Although not commonly used, CORS is enabled between all Wikimedia wikis. For an example of cross-wiki editing, see here.

Timezone formattingedit

The selected timezone of a user is available via mw.user.options.get('timecorrection'), which will return something like "ZoneInfo|180|Africa/Addis_Ababa", where 180 is the number of minutes to add to UTC to obtain a time in the user's preferred time zone. The number might be negative.

🔥 Top keywords: Akademia e Shkencave e RPS te ShqiperiseAlexandria Ocasio-CortezBilderberg GroupCristiano RonaldoDong XiaowanMinecraftOperation GladioPrimal cutRiot FestStrictly Come Dancing (series 7)Main PageSpecial:SearchBaike: Requested articles/Business and economics/Companies/M-SIndian Premier LeagueFrancis Scott Key Bridge (Baltimore)Baike: Featured pictures2024 Indian Premier LeagueFrancis Scott Key Bridge collapseSean CombsNicole Shanahan3 Body Problem (TV series)PornhubJoe LiebermanThe Three-Body Problem (novel)XXXTentacionCleopatraYouTubeDan SchneiderDeaths in 2024MV DaliGodzilla x Kong: The New EmpireBrian PeckPorno y heladoSunrisers HyderabadUEFA Euro 2024Shōgun (2024 miniseries)Road House (2024 film)InstagramRonna McDanielDrake BellRobert F. Kennedy Jr.Francis Scott KeyAmanda BynesViral videoRobert HanssenBaltimoreBrandon ScottDune: Part TwoADX FlorenceFacebookTartanAditi Rao HydariSoaking (sexual practice)Ruby FrankeX-Men '97Cassie VenturaSunshine Skyway BridgeSergey Brin2024 Indian general electionList of Twenty20 cricket recordsSiddharth (actor)Portal Current eventsWinnie-the-Pooh: Blood and Honey 2Kalanithi MaranThree-body problemThe Gentlemen (2024 TV series)Kim PorterChatGPTJake GyllenhaalGhostbusters: Frozen EmpireWrestleMania XLKwena MaphakaPoor Things (film)2026 FIFA World Cup qualification (AFC)Dune (2021 film)United StatesWes MooreEndrick (footballer, born 2006)Maundy ThursdaySydney SweeneySolar eclipse of April 8, 2024Carol BurnettCrocus City Hall attackMadelyne PryorQuiet on Set: The Dark Side of Kids TVElin NordegrenKung Fu Panda 4SexCowboy CarterRed Eye (2005 American film)Battle of the HydaspesRyan GoslingFighter (2024 film)Eva MendesBattle of New CarthageImmaculate (2024 film)J. Robert OppenheimerArgentina national football teamShirley ChisholmTaylor SwiftLate Night with the DevilList of Indian Premier League records and statisticsRichard SerraTheo JamesNational September 11 Memorial & MuseumConor McGregorOppenheimer (film)Daniel KahnemanUEFA Euro 2024 qualifying