Admin: qwiki: system/common-js.md

2026-08-12T02:35:26Z

qwiki: system/common-js.md

New page

/* Point the site logo at the Doikayt Mobilization Labs homepage, opening
in a new tab so the wiki stays open in the background. Locally, send it
to the website preview server (npx serve website/dist -p 3456) instead
of production, so clicking it doesn't navigate away from localhost. */
( function () {
'use strict';

var isLocal = /^(localhost|127\.0\.0\.1)$/.test( location.hostname );
var target = isLocal ? 'http://localhost:3456' : 'https://www.doikayt.org';

$( '#p-logo a' ).attr( {
href: target,
target: '_blank',
rel: 'noopener'
} );
}() );

/* Same local/prod split for any content-authored link to doikayt.org (e.g. the
About page's links to the website) -- rewrite so they point at the local
preview server instead of jumping out to production. */
( function () {
'use strict';

var isLocal = /^(localhost|127\.0\.0\.1)$/.test( location.hostname );
if ( !isLocal ) { return; }

$( '#content a[href^="https://www.doikayt.org/"]' ).each( function () {
this.href = this.href.replace( 'https://www.doikayt.org', 'http://localhost:3456' );
} );
}() );

/* Replace PageForms OOUI tooltip buttons with a plain <sup>?</sup> trigger
that shows the help text in a lightweight floating div on click. */
( function () {
'use strict';

mw.hook( 'pf.formSetupAfter' ).add( function () {
$( 'th[data-tooltip]' ).each( function () {
var $th = $( this );
var safe = $( '<div>' ).text( $th.attr( 'data-tooltip' ) ).html();

var $trigger = $( '<sup class="pf-tip">?</sup>' );
var $popup = $( '<div class="pf-tip-popup"></div>' )
.html( '<p>' + safe + '</p>' )
.hide();

$trigger.on( 'click', function ( e ) {
e.stopPropagation();
$( '.pf-tip-popup' ).not( $popup ).hide();
$popup.toggle();
} );

$th.css( 'position', 'relative' ).append( $trigger ).append( $popup );
} );

$( document ).on( 'click.pf-tip', function () {
$( '.pf-tip-popup' ).hide();
} );
} );
}() );

/* Probe the URL field on the Tool form for reachability on blur.
Uses no-cors so any server response (any status code) counts as reachable;
only genuine network failure (DNS, TLS, timeout) is flagged as unreachable. */
( function () {
'use strict';

// null = not yet checked, true = reachable, false = unreachable
var probeResult = null;
var probedUrl = '';

function getFullUrl() {
var $protocol = $( 'select[name="Tool[protocol]"]' );
var protocol = $protocol.length ? $protocol.val().trim() : 'https';
var domain = $( 'input[name="Tool[url]"]' ).val().trim();
return domain ? protocol + '://' + domain : '';
}

function showStatus( msg, color ) {
$( '#pf-url-status' ).text( msg ).css( 'color', color );
}

function probe( url ) {
if ( !url || url === probedUrl ) { return; }
probedUrl = url;
probeResult = null;
showStatus( 'Checking…', 'gray' );

var timeout = new Promise( function ( _, reject ) {
setTimeout( function () { reject( new Error( 'timeout' ) ); }, 8000 );
} );

Promise.race( [
fetch( url, { method: 'HEAD', mode: 'no-cors', cache: 'no-cache' } ),
timeout
] ).then( function () {
if ( url !== probedUrl ) { return; }
probeResult = true;
showStatus( '✓ Reachable', 'green' );
} ).catch( function () {
if ( url !== probedUrl ) { return; }
probeResult = false;
showStatus( '✗ Not reachable', 'red' );
} );
}

$( function () {
var $url = $( 'input[name="Tool[url]"]' );
if ( !$url.length ) { return; }

$url.closest( 'td' ).append(
$( '<span>' ).attr( 'id', 'pf-url-status' ).css( { marginLeft: '8px', fontSize: '0.9em' } )
);

$url.on( 'blur', function () {
probe( getFullUrl() );
} );
} );

// Clear previous error rows before each validation run
mw.hook( 'pf.formValidation' ).add( function () {
$( '.pf-error-row' ).remove();
} );

mw.hook( 'pf.formValidation' ).add( function ( args ) {
var $url = $( 'input[name="Tool[url]"]' );
if ( !$url.length ) { return; }

var domain = $url.val().trim();
var msg = null;

if ( !domain ) {
msg = 'URL is required.';
} else {
var url = getFullUrl();
if ( probeResult === false ) {
msg = 'URL is not reachable. Please verify the address.';
} else if ( probeResult === null ) {
showStatus( 'Checking…', 'gray' );
probe( url );
msg = 'Verifying URL reachability — please try saving again in a moment.';
}
}

if ( msg ) {
args.numErrors++;
$( '<tr class="pf-error-row"><td colspan="2"></td></tr>' )
.find( 'td' ).text( msg ).end()
.insertAfter( $url.closest( 'tr' ) );
setTimeout( function () {
var $e = $( '.pf-error-row' ).first();
if ( $e.length ) { $e[ 0 ].scrollIntoView( { behavior: 'smooth', block: 'nearest' } ); }
}, 0 );
}
// probeResult === true: allow through
} );
}() );

/* Require at least one category before the Tool form can be submitted. */
( function () {
'use strict';

mw.hook( 'pf.formValidation' ).add( function ( args ) {
var $category = $( '[name="Tool[category]"]' );
if ( !$category.length ) { return; }
if ( !( $category.val() || '' ).trim() ) {
args.numErrors++;
$( '<tr class="pf-error-row"><td colspan="2">Please select a category.</td></tr>' )
.insertAfter( $category.closest( 'tr' ) );
setTimeout( function () {
var $e = $( '.pf-error-row' ).first();
if ( $e.length ) { $e[ 0 ].scrollIntoView( { behavior: 'smooth', block: 'nearest' } ); }
}, 0 );
}
} );
}() );

/* Amount / pricing cross-validation. Two rules:
1. pricing=free + non-zero amount → error (amount must be blank for free tools)
2. pricing!=free + blank or zero amount → error (amount is required) */
( function () {
'use strict';

mw.hook( 'pf.formValidation' ).add( function ( args ) {
var $pricing = $( '[name="Tool[pricing]"]' );
var $amount = $( '[name="Tool[amount]"]' );
if ( !$pricing.length || !$amount.length ) { return; }

var pricing = $pricing.val().trim();
var amount = ( $amount.val() || '' ).trim();
var numericAmount = parseFloat( amount );

if ( pricing === 'free' && amount && numericAmount > 0 ) {
args.numErrors++;
$( '<tr class="pf-error-row"><td colspan="2">Free tools must have a blank amount.</td></tr>' )
.insertAfter( $amount.closest( 'tr' ) );
setTimeout( function () {
var $e = $( '.pf-error-row' ).first();
if ( $e.length ) { $e[ 0 ].scrollIntoView( { behavior: 'smooth', block: 'nearest' } ); }
}, 0 );
}

if ( pricing !== 'free' && ( !amount || numericAmount === 0 ) ) {
args.numErrors++;
$( '<tr class="pf-error-row"><td colspan="2">Amount is required when pricing is not free.</td></tr>' )
.insertAfter( $amount.closest( 'tr' ) );
setTimeout( function () {
var $e = $( '.pf-error-row' ).first();
if ( $e.length ) { $e[ 0 ].scrollIntoView( { behavior: 'smooth', block: 'nearest' } ); }
}, 0 );
}
} );
}() );

/* Sidebar CategoryTree:
- Leaf (page) labels: strip " - tagline" suffix so only the product name
shows, and move the full "Name - tagline" text onto the title attribute
so it's still available as a hover tooltip. Category listing pages are
unaffected -- only the sidebar tree text is touched.
- Category labels: replace the native (redundant, page-name-only) title
tooltip with the category's one-line description, pulled from the first
paragraph of the category page's wikitext via a batched API call.
MutationObserver covers nodes loaded via AJAX on expansion. */
( function () {
'use strict';

var categoryDescCache = {};
var categoryDescPending = {};

function firstParagraph( wikitext ) {
var lines = ( wikitext || '' ).split( '\n' );
for ( var i = 0; i < lines.length; i++ ) {
// Strip raw HTML first -- pandoc's markdown->mediawiki writer emits a
// <span id="..."></span> anchor immediately before every heading, which
// would otherwise be picked up as the "first line" of body text.
var line = lines[ i ].trim().replace( /<[^>]+>/g, '' ).trim();
if ( !line || /^=+/.test( line ) ) { continue; }
return line.replace( /\[\[(?:[^\]|]+\|)?([^\]]+)\]\]/g, '$1' );
}
return '';
}

function applyCategoryDescriptions( titleToDesc ) {
$( '#mw-panel .CategoryTreeItem a' ).each( function () {
var $a = $( this );
var cur = $a.attr( 'title' );
if ( cur && titleToDesc[ cur ] ) { $a.attr( 'title', titleToDesc[ cur ] ); }
} );
}

function fetchCategoryDescriptions( titles ) {
var batches = [];
for ( var i = 0; i < titles.length; i += 50 ) { batches.push( titles.slice( i, i + 50 ) ); }

batches.forEach( function ( batch ) {
new mw.Api().get( {
action: 'query',
titles: batch.join( '|' ),
prop: 'revisions',
rvprop: 'content',
rvslots: 'main',
formatversion: 2
} ).then( function ( data ) {
var titleToDesc = {};
( ( data.query && data.query.pages ) || [] ).forEach( function ( page ) {
batch.forEach( function ( t ) { delete categoryDescPending[ t ]; } );
if ( !page.revisions ) { return; }
var desc = firstParagraph( page.revisions[ 0 ].slots.main.content );
if ( !desc ) { return; }
categoryDescCache[ page.title ] = desc;
titleToDesc[ page.title ] = desc;
} );
applyCategoryDescriptions( titleToDesc );
} );
} );
}

function normalizeTree( root ) {
var toFetch = [];

$( root ).find( '#mw-panel .CategoryTreeItem a' ).each( function () {
var $a = $( this );
var href = $a.attr( 'href' ) || '';
var label = $a.attr( 'title' ) || '';
var isCategory = /\/Category:/.test( href ) || /^Category:/.test( label );

if ( isCategory ) {
if ( !label ) { return; }
if ( categoryDescCache[ label ] ) {
$a.attr( 'title', categoryDescCache[ label ] );
} else if ( !categoryDescPending[ label ] ) {
categoryDescPending[ label ] = true;
toFetch.push( label );
}
return;
}

var t = $a.text(), i = t.indexOf( ' - ' );
if ( i !== -1 ) {
$a.attr( 'title', t );
$a.text( t.slice( 0, i ) );
}
} );

if ( toFetch.length ) { fetchCategoryDescriptions( toFetch ); }
}

$( function () {
var panel = document.getElementById( 'mw-panel' );
if ( !panel ) { return; }
normalizeTree( document );
new MutationObserver( function ( mutations ) {
mutations.forEach( function ( m ) {
m.addedNodes.forEach( function ( n ) {
if ( n.nodeType === 1 ) { normalizeTree( n ); }
} );
} );
} ).observe( panel, { childList: true, subtree: true } );
} );
}() );

/* Inject a "built at <commit>" link into the wiki footer. The commit hash is
stored in MediaWiki:Doikayt-build-commit and written on every qwiki deploy. */
( function () {
'use strict';

var GITHUB_REPO = 'https://github.com/doikayt/qwiki';

new mw.Api().get( {
action: 'query',
titles: 'MediaWiki:Doikayt-build-commit',
prop: 'revisions',
rvprop: 'content',
rvslots: 'main'
} ).then( function ( data ) {
var pages = data.query.pages;
var page = pages[ Object.keys( pages )[ 0 ] ];
if ( !page.revisions ) { return; }
var commit = page.revisions[ 0 ].slots.main[ '*' ].trim();
if ( !commit ) { return; }
var short = commit.slice( 0, 7 );
var $link = $( '<a>' ).attr( {
href: GITHUB_REPO + '/commit/' + commit,
target: '_blank',
rel: 'noopener'
} ).text( 'built at ' + short );
$( '#footer-info' ).append(
$( '<li>' ).attr( 'id', 'footer-info-buildcommit' ).append( $link )
);
} );
}() );

MediaWiki:Common.js - Revision history

Admin: qwiki: system/common-js.md