MediaWiki:Common.js: Difference between revisions

Revision as of 05:22, 14 August 2026

( function () {
	'use strict';
 
	var DEFAULTS = {
		minBytes: 3000,
		dailyStable: true,
 		blurbChars: 200,
 		maxPages: 6
	};
 
	function init() {
		var panels = document.querySelectorAll( '.lhc-article' );
		if ( !panels.length ) {
			return;
		}
		var api = new mw.Api();
		Array.prototype.forEach.call( panels, function ( panel ) {
			start( api, panel );
		} );
	}
 
	function start( api, panel ) {
		if ( panel.hasAttribute( 'data-random' ) ||
			panel.hasAttribute( 'data-category' ) ) {
			return pickRandom( api, panel ).catch( function () {
			} );
		}
 
		var page = resolvePage( panel );
		if ( page ) {
			return loadArticle( api, panel, page ).catch( function () {} );
		}
	}
 
	function resolvePage( panel ) {
		var explicit = panel.getAttribute( 'data-page' );
		if ( explicit ) {
			return explicit;
		}
		var link = panel.querySelector( 'a[title]' );
		if ( !link ) {
			return null;
		}
		var title = link.getAttribute( 'title' );
		if ( /\(page does not exist\)$/.test( title ) ) {
			return null;
		}
		return title;
	}
 
	function pickRandom( api, panel ) {
		var categories = splitList( panel.getAttribute( 'data-category' ) );
		var exclude = panel.getAttribute( 'data-exclude-category' );
 
		var minBytes = parseInt( panel.getAttribute( 'data-min-bytes' ), 10 );
		if ( isNaN( minBytes ) ) {
			minBytes = DEFAULTS.minBytes;
		}
 
		var listing = categories.length ?
			Promise.all( categories.map( function ( c ) {
				return listCategory( api, c, minBytes );
			} ) ).then( merge ) :
			listAll( api, minBytes );
 
		return Promise.all( [ listing, listExcluded( api, exclude ) ] )
			.then( function ( results ) {
				var titles = results[ 0 ];
				var skip = results[ 1 ];
 
				var candidates = titles.filter( function ( t ) {
					return !skip[ t ];
				} ).sort( function ( a, b ) {
					return a.localeCompare( b );
				} );
 
				if ( !candidates.length ) {
					mw.log.warn( '[lhc-article] no candidates found' );
					return;
				}
 
				return loadArticle(
					api, panel, candidates[ pickIndex( candidates.length ) ]
				);
			} );
	}
 
	function splitList( value ) {
		if ( !value ) {
			return [];
		}
		return value.split( '|' ).map( function ( s ) {
			return s.trim();
		} ).filter( function ( s ) {
			return s.length > 0;
		} );
	}
 
	function merge( lists ) {
		var seen = {};
		var out = [];
		lists.forEach( function ( list ) {
			list.forEach( function ( title ) {
				if ( !seen[ title ] ) {
					seen[ title ] = true;
					out.push( title );
				}
			} );
		} );
		return out;
	}
 
	function listCategory( api, category, minBytes ) {
		return api.get( {
			action: 'query',
			generator: 'categorymembers',
			gcmtitle: 'Category:' + category,
			gcmnamespace: 0,
			gcmtype: 'page',
			gcmlimit: 'max',
			prop: 'info',
			formatversion: 2
		} ).then( function ( data ) {
			var pages = ( data.query && data.query.pages ) || [];
			if ( !pages.length ) {
				mw.log.warn( '[lhc-article] empty category: ' + category );
			}
			return pages.filter( function ( p ) {
				return p.length >= minBytes;
			} ).map( function ( p ) {
				return p.title;
			} );
		} ).catch( function () {
			mw.log.warn( '[lhc-article] lookup failed: ' + category );
			return [];
		} );
	}
 
	function listAll( api, minBytes ) {
		var titles = [];
 
		function fetch( cont, round ) {
			var params = {
				action: 'query',
				generator: 'allpages',
				gapnamespace: 0,
				gapfilterredir: 'nonredirects',
				gapminsize: minBytes,
				gaplimit: 'max',
				formatversion: 2
			};
			if ( cont ) {
				Object.keys( cont ).forEach( function ( k ) {
					params[ k ] = cont[ k ];
				} );
			}
 
			return api.get( params ).then( function ( data ) {
				( ( data.query && data.query.pages ) || [] )
					.forEach( function ( p ) {
						titles.push( p.title );
					} );
 
				if ( data.continue && round < DEFAULTS.maxPages ) {
					return fetch( data.continue, round + 1 );
				}
				return titles;
			} );
		}
 
		return fetch( null, 1 );
	}
 
	function listExcluded( api, category ) {
		if ( !category ) {
			return Promise.resolve( {} );
		}
		return api.get( {
			action: 'query',
			list: 'categorymembers',
			cmtitle: 'Category:' + category,
			cmnamespace: 0,
			cmlimit: 'max',
			formatversion: 2
		} ).then( function ( data ) {
			var skip = {};
			( ( data.query && data.query.categorymembers ) || [] )
				.forEach( function ( p ) {
					skip[ p.title ] = true;
				} );
			return skip;
		} ).catch( function () {
			return {};
		} );
	}
 
	function pickIndex( n ) {
		if ( !DEFAULTS.dailyStable ) {
			return Math.floor( Math.random() * n );
		}
		var d = new Date();
		var key = d.getUTCFullYear() + '-' +
			( d.getUTCMonth() + 1 ) + '-' + d.getUTCDate();
		var h = 2166136261;
		for ( var i = 0; i < key.length; i++ ) {
			h = ( h ^ key.charCodeAt( i ) ) * 16777619 >>> 0;
		}
		return h % n;
	}
 
	function loadArticle( api, panel, title ) {
		return api.get( {
			action: 'parse',
			page: title,
			prop: 'text',
			section: 0,
			redirects: 1,
			formatversion: 2
		} ).then( function ( data ) {
			var html = data.parse && data.parse.text;
			if ( !html ) {
				return;
			}
			var doc = new DOMParser().parseFromString( html, 'text/html' );
			render( panel, {
				// Use the resolved title, so redirects show their target.
				title: data.parse.title || title,
				image: extractImage( doc ),
				blurb: extractBlurb( doc )
			} );
		} );
	}
 
	function extractImage( doc ) {
		var img = doc.querySelector(
			'.infobox img, .infobox-image img, table.infobox img'
		) || doc.querySelector( 'img' );
 
		if ( !img ) {
			return null;
		}
		var src = img.getAttribute( 'src' );
		if ( !src ) {
			return null;
		}
		if ( src.indexOf( '//' ) === 0 ) {
			return location.protocol + src;
		}
		if ( src.indexOf( '/' ) === 0 ) {
			return location.origin + src;
		}
		return src;
	}
 
	function extractBlurb( doc ) {
		var junk = doc.querySelectorAll(
			'table, .infobox, .navbox, .hatnote, .thumb, ' +
			'sup.reference, .mw-editsection, .noexcerpt, style'
		);
		Array.prototype.forEach.call( junk, function ( el ) {
			el.parentNode.removeChild( el );
		} );
 
		var paras = doc.querySelectorAll( 'p' );
		for ( var i = 0; i < paras.length; i++ ) {
			var text = paras[ i ].textContent.replace( /\s+/g, ' ' ).trim();
			if ( text.length > 40 ) {
				return truncate( text, DEFAULTS.blurbChars );
			}
		}
		return null;
	}
 
	function truncate( text, max ) {
		if ( text.length <= max ) {
			return text;
		}
		var cut = text.slice( 0, max );
		var space = cut.lastIndexOf( ' ' );
		return ( space > 0 ? cut.slice( 0, space ) : cut ) + '…';
	}
 
	function render( panel, article ) {
		var href = mw.util.getUrl( article.title );
 
		var wrap = document.createElement( 'div' );
		wrap.className = 'lhc-ra';
 
		if ( article.image ) {
			var link = document.createElement( 'a' );
			link.href = href;
			var img = document.createElement( 'img' );
			img.src = article.image;
			img.alt = article.title;
			link.appendChild( img );
			wrap.appendChild( link );
		}
 
		var heading = document.createElement( 'div' );
		heading.className = 'lhc-ra-title';
		var titleLink = document.createElement( 'a' );
		titleLink.href = href;
		titleLink.textContent = article.title;
		heading.appendChild( titleLink );
		wrap.appendChild( heading );
 
		if ( article.blurb ) {
			var p = document.createElement( 'p' );
			p.className = 'lhc-ra-blurb';
			p.textContent = article.blurb;
			wrap.appendChild( p );
		}
 
		var more = document.createElement( 'a' );
		more.href = href;
		more.className = 'lhc-ra-more';
		more.textContent = 'Read the full article →';
		wrap.appendChild( more );
 
		panel.textContent = '';
		panel.appendChild( wrap );
	}
 
	mw.loader.using( [ 'mediawiki.api', 'mediawiki.util' ] ).then( function () {
		if ( document.readyState !== 'loading' ) {
			init();
		} else {
			document.addEventListener( 'DOMContentLoaded', init );
		}
	} );
 
}() );