Admin: Guard: no-op if the core Common.js implementation already injected the dropdown (via update-page on MediaWiki MCP Server)

2026-08-11T09:16:46Z

Guard: no-op if the core Common.js implementation already injected the dropdown (via update-page on MediaWiki MCP Server)

← Older revision		Revision as of 14:46, 11 August 2026
Line 1:		Line 1:
	/**		/**
	* ohc-version-switcher — Docusaurus-style version dropdown for CARE docs.		* ohc-version-switcher — Docusaurus-style version dropdown for CARE docs.
			* No-ops when the core MediaWiki:Common.js implementation already injected it
			* (checks for an existing .docs-version-switcher in the metadata strip).
	*		*
			* Behaviour: on {{Doc header}} pages a dropdown is injected into .docs-meta.
	* Behaviour:
		⚫	* Older versions navigate to a frozen fork subpage (e.g. Concepts/Patient/3.0)
	* 1. On any page with the .docs-meta class (i.e. pages using {{Doc header}}),
	* ~~injects~~ a version ~~dropdown~~ ~~into~~ ~~the~~ ~~metadata~~ ~~strip.~~		* if it exists; the chosen version persists in localStorage and auto-redirects
		⚫	* on load. Visuals live in MediaWiki:Gadget-ohc-version-switcher.css.
	* 2. Selecting an older version checks (via MW API) whether a frozen fork
	* subpage exists (e.g. Concepts/Patient/3.0). If yes → navigate there.
	* If no → stay on the canonical page (it spans that version implicitly).
	* 3. Persists the chosen version in localStorage. On page load, if you have
	* a non-latest version stored and a fork exists, auto-redirects.
	* 4. On frozen forks, the dropdown shows the fork's version as selected and
	* switching to "latest" returns you to the canonical page.
	*
⚫	* ~~Visuals~~ ~~are~~ ~~defined~~ in MediaWiki:Gadget-ohc-version-switcher.css.
	*/		*/
	mw.loader.using( [ 'mediawiki.util', 'mediawiki.notification' ] ).then( function () {		mw.loader.using( [ 'mediawiki.util', 'mediawiki.notification' ] ).then( function () {
	'use strict';		'use strict';

	// Only activate on doc pages
	var metaStrip = document.querySelector( '.docs-meta' );		var metaStrip = document.querySelector( '.docs-meta' );
	if ( !metaStrip ) {		if ( !metaStrip \|\| metaStrip.querySelector( '.docs-version-switcher' ) ) {
	return;		return;
	}		}

	// --- Configuration (update KNOWN_VERSIONS on each CARE release) ---
	var KNOWN_VERSIONS = [ '3.1', '3.0' ];		var KNOWN_VERSIONS = [ '3.1', '3.0' ];
	var LATEST = KNOWN_VERSIONS[ 0 ];		var LATEST = KNOWN_VERSIONS[ 0 ];
	var LS_KEY = 'ohcwiki-care-version';		var LS_KEY = 'ohcwiki-care-version';

	// --- Detect context ---
	var currentPage = mw.config.get( 'wgPageName' ).replace( /_/g, ' ' );		var currentPage = mw.config.get( 'wgPageName' ).replace( /_/g, ' ' );
	var storedVersion = null;		var storedVersion = null;
Line 35:		Line 26:
	if ( !storedVersion ) { storedVersion = LATEST; }		if ( !storedVersion ) { storedVersion = LATEST; }

⚫	// ~~Are~~ we on a frozen fork? (subpage ~~like~~ "Concepts/Patient/3.0")
	var forkMatch = currentPage.match( /^(.+)\/(\d+\.\d+)$/ );		var forkMatch = currentPage.match( /^(.+)\/(\d+\.\d+)$/ );
	var isOnFork = !!forkMatch;		var isOnFork = !!forkMatch;
Line 41:		Line 31:
	var viewingVersion = isOnFork ? forkMatch[ 2 ] : LATEST;		var viewingVersion = isOnFork ? forkMatch[ 2 ] : LATEST;

	// --- Build the dropdown ---
	var container = document.createElement( 'span' );		var container = document.createElement( 'span' );
	container.className = 'docs-meta__badge docs-version-switcher';		container.className = 'docs-meta__badge docs-version-switcher';
Line 66:		Line 55:
	metaStrip.insertBefore( container, metaStrip.firstChild );		metaStrip.insertBefore( container, metaStrip.firstChild );

	// --- Navigation ---
	function navigateToVersion( version ) {		function navigateToVersion( version ) {
	if ( version === LATEST ) {		if ( version === LATEST ) {
Line 79:		Line 67:
	window.location.href = mw.util.getUrl( forkTitle );		window.location.href = mw.util.getUrl( forkTitle );
	} else if ( isOnFork ) {		} else if ( isOnFork ) {
	// No fork for chosen version but we're on a fork — go canonical
	window.location.href = mw.util.getUrl( canonicalPage );		window.location.href = mw.util.getUrl( canonicalPage );
	} else {		} else {
Line 97:		Line 84:
	}		}

	// --- Auto-redirect on load (respects stored version preference) ---
	if ( storedVersion !== LATEST && !isOnFork && !window.location.search.includes( 'action=' ) ) {		if ( storedVersion !== LATEST && !isOnFork && !window.location.search.includes( 'action=' ) ) {
	var forkTitle = canonicalPage + '/' + storedVersion;		var forkTitle = canonicalPage + '/' + storedVersion;

Admin: CARE version dropdown gadget (moved from common.js) (via create-page on MediaWiki MCP Server)

2026-08-11T08:53:22Z

CARE version dropdown gadget (moved from common.js) (via create-page on MediaWiki MCP Server)

New page

/**
* ohc-version-switcher — Docusaurus-style version dropdown for CARE docs.
*
* Behaviour:
* 1. On any page with the .docs-meta class (i.e. pages using {{Doc header}}),
* injects a version dropdown into the metadata strip.
* 2. Selecting an older version checks (via MW API) whether a frozen fork
* subpage exists (e.g. Concepts/Patient/3.0). If yes → navigate there.
* If no → stay on the canonical page (it spans that version implicitly).
* 3. Persists the chosen version in localStorage. On page load, if you have
* a non-latest version stored and a fork exists, auto-redirects.
* 4. On frozen forks, the dropdown shows the fork's version as selected and
* switching to "latest" returns you to the canonical page.
*
* Visuals are defined in MediaWiki:Gadget-ohc-version-switcher.css.
*/
mw.loader.using( [ 'mediawiki.util', 'mediawiki.notification' ] ).then( function () {
'use strict';

// Only activate on doc pages
var metaStrip = document.querySelector( '.docs-meta' );
if ( !metaStrip ) {
return;
}

// --- Configuration (update KNOWN_VERSIONS on each CARE release) ---
var KNOWN_VERSIONS = [ '3.1', '3.0' ];
var LATEST = KNOWN_VERSIONS[ 0 ];
var LS_KEY = 'ohcwiki-care-version';

// --- Detect context ---
var currentPage = mw.config.get( 'wgPageName' ).replace( /_/g, ' ' );
var storedVersion = null;
try { storedVersion = localStorage.getItem( LS_KEY ); } catch ( e ) {}
if ( !storedVersion ) { storedVersion = LATEST; }

// Are we on a frozen fork? (subpage like "Concepts/Patient/3.0")
var forkMatch = currentPage.match( /^(.+)\/(\d+\.\d+)$/ );
var isOnFork = !!forkMatch;
var canonicalPage = isOnFork ? forkMatch[ 1 ] : currentPage;
var viewingVersion = isOnFork ? forkMatch[ 2 ] : LATEST;

// --- Build the dropdown ---
var container = document.createElement( 'span' );
container.className = 'docs-meta__badge docs-version-switcher';
container.style.cssText = 'display:inline-flex;align-items:center;gap:0.3em;padding:0.15em 0.5em;';

var select = document.createElement( 'select' );
select.title = 'Switch documentation version';

KNOWN_VERSIONS.forEach( function ( v ) {
var opt = document.createElement( 'option' );
opt.value = v;
opt.textContent = v + ( v === LATEST ? ' (latest)' : '' );
if ( v === viewingVersion ) { opt.selected = true; }
select.appendChild( opt );
} );

select.addEventListener( 'change', function () {
var chosen = select.value;
try { localStorage.setItem( LS_KEY, chosen ); } catch ( e ) {}
navigateToVersion( chosen );
} );

container.appendChild( select );
metaStrip.insertBefore( container, metaStrip.firstChild );

// --- Navigation ---
function navigateToVersion( version ) {
if ( version === LATEST ) {
if ( isOnFork ) {
window.location.href = mw.util.getUrl( canonicalPage );
}
return;
}
var forkTitle = canonicalPage + '/' + version;
checkPageExists( forkTitle ).then( function ( exists ) {
if ( exists ) {
window.location.href = mw.util.getUrl( forkTitle );
} else if ( isOnFork ) {
// No fork for chosen version but we're on a fork — go canonical
window.location.href = mw.util.getUrl( canonicalPage );
} else {
mw.notify(
'This page is unchanged in CARE ' + version + ' — you\'re already seeing the right content.',
{ type: 'info', autoHide: true, autoHideSeconds: 4 }
);
}
} );
}

function checkPageExists( title ) {
return new mw.Api().get( { action: 'query', titles: title } ).then( function ( data ) {
var pages = data.query && data.query.pages;
return pages && !pages[ '-1' ];
} ).catch( function () { return false; } );
}

// --- Auto-redirect on load (respects stored version preference) ---
if ( storedVersion !== LATEST && !isOnFork && !window.location.search.includes( 'action=' ) ) {
var forkTitle = canonicalPage + '/' + storedVersion;
checkPageExists( forkTitle ).then( function ( exists ) {
if ( exists ) {
window.location.replace( mw.util.getUrl( forkTitle ) );
}
} );
}
} );

MediaWiki:Gadget-ohc-version-switcher.js - Revision history

Admin: Guard: no-op if the core Common.js implementation already injected the dropdown (via update-page on MediaWiki MCP Server)

Admin: CARE version dropdown gadget (moved from common.js) (via create-page on MediaWiki MCP Server)