MediaWiki:Gadget-QuoteSourceRedirects.js

/**
 * Approve buttons for [[QuoteSource redirects to create]].
 *
 * Each suggested row carries a .qs-approve span with data-from (the unresolved
 * QuoteSource value) and data-to (the target page). Clicking creates a redirect
 * from one to the other through the API — it does not touch any segment.
 *
 * Deliberately createonly: if a page already exists at that title the edit is
 * refused rather than overwriting it, so an approval can never clobber real
 * content. The row reports what happened either way.
 *
 * Only loaded on that page, and only for users who can edit — the buttons are
 * not rendered at all otherwise.
 */
( function () {
	'use strict';

	if ( mw.config.get( 'wgPageName' ) !== 'QuoteSource_redirects_to_create' ) {
		return;
	}

	$( function () {
		var $rows = $( '.qs-approve' );
		if ( !$rows.length ) {
			return;
		}

		var api = new mw.Api();

		// Replaces the button with a result. The button is gone by then, so the
		// row cannot be double-submitted.
		function setState( $cell, cls, text ) {
			$cell.removeClass( 'qs-pending qs-done qs-failed' ).addClass( cls ).text( text );
		}

		function approve( $cell ) {
			var from = $cell.data( 'from' );
			var to = $cell.data( 'to' );
			if ( !from || !to ) {
				return;
			}

			setState( $cell, 'qs-pending', 'creating…' );

			api.postWithToken( 'csrf', {
				action: 'edit',
				title: from,
				text: '#REDIRECT [[' + to + ']]',
				summary: 'Redirect for a QuoteSource value used in the translation memory',
				createonly: 1
			} ).done( function () {
				setState( $cell, 'qs-done', '✓ created' );
			} ).fail( function ( code, res ) {
				var why = code;
				if ( code === 'articleexists' ) {
					why = 'page already exists';
				} else if ( res && res.error && res.error.info ) {
					why = res.error.info;
				}
				setState( $cell, 'qs-failed', '✗ ' + why );
			} );
		}

		$rows.each( function () {
			var $cell = $( this );
			$( '<button>' )
				.addClass( 'qs-approve-btn' )
				.text( 'Create redirect' )
				.on( 'click', function () {
					$( this ).prop( 'disabled', true );
					approve( $cell );
				} )
				.appendTo( $cell );
		} );

		// Rewriting the stored value across every segment that uses it.
		//
		// A redirect fixes the link without touching the data; this is for when
		// the value itself is wrong — a misspelling, or a form we do not want to
		// keep. It edits every segment carrying that value, so it asks for
		// confirmation with the count and reports progress as it goes.
		//
		// Replacement is on the exact value within the parameter, not the whole
		// line: 119 segments name several sources separated by semicolons, and
		// rewriting the line would destroy the others.
		function rewriteValue( $cell ) {
			var from = $cell.data( 'from' );
			var to = window.prompt(
				'Rewrite this QuoteSource value on every segment that uses it.\n\n' +
				'This edits the segments themselves, not just a redirect.\n\n' +
				'Current value:',
				from
			);
			if ( to === null ) {
				return;
			}
			to = $.trim( to );
			if ( !to || to === from ) {
				return;
			}

			var $status = $cell.find( '.qs-rewrite-status' );
			$status.text( 'finding segments…' );

			api.get( {
				action: 'ask',
				query: '[[QuoteSource::' + from.replace( /[[\]|]/g, '' ) + ']]|limit=500',
				format: 'json'
			} ).done( function ( res ) {
				var results = ( res.query && res.query.results ) || {};
				var pages = Object.keys( results );
				if ( !pages.length ) {
					$status.text( 'no segments matched' );
					return;
				}
				if ( !window.confirm(
					'Rewrite on ' + pages.length + ' segment' + ( pages.length === 1 ? '' : 's' ) + '?\n\n' +
					'"' + from + '"\n  ->  "' + to + '"'
				) ) {
					$status.text( '' );
					return;
				}
				editNext( pages, 0, from, to, $status );
			} ).fail( function ( code ) {
				$status.text( 'lookup failed: ' + code );
			} );
		}

		// One at a time, so a failure stops rather than half-finishing a batch.
		function editNext( pages, i, from, to, $status ) {
			if ( i >= pages.length ) {
				$status.text( '✓ rewrote ' + pages.length );
				return;
			}
			$status.text( 'editing ' + ( i + 1 ) + ' of ' + pages.length + '…' );

			api.get( { action: 'query', prop: 'revisions', rvprop: 'content',
				rvslots: 'main', titles: pages[ i ], format: 'json', formatversion: 2 }
			).done( function ( res ) {
				var page = ( ( res.query && res.query.pages ) || [] )[ 0 ];
				var text = page && page.revisions && page.revisions[ 0 ].slots.main.content;
				if ( !text ) {
					$status.text( '✗ could not read ' + pages[ i ] );
					return;
				}
				// Exact value replacement, leaving any other sources on the line.
				if ( text.indexOf( from ) === -1 ) {
					// Already changed, or stored differently — skip rather than guess.
					editNext( pages, i + 1, from, to, $status );
					return;
				}
				var updated = text.split( from ).join( to );
				api.postWithToken( 'csrf', {
					action: 'edit', title: pages[ i ], text: updated,
					summary: 'QuoteSource: ' + from + ' → ' + to
				} ).done( function () {
					editNext( pages, i + 1, from, to, $status );
				} ).fail( function ( code ) {
					$status.text( '✗ ' + pages[ i ] + ': ' + code );
				} );
			} ).fail( function ( code ) {
				$status.text( '✗ ' + code );
			} );
		}

		$( '.qs-table' ).on( 'click', '.qs-value-edit', function () {
			rewriteValue( $( this ).closest( 'tr' ).find( '.qs-approve' ) );
		} );

		// Editing a target in place: the suggestion is a guess, and the row is
		// useless if the only way to correct it is to edit 67KB of wikitext.
		$( '.qs-table' ).on( 'click', '.qs-target-edit', function () {
			var $link = $( this );
			var $cell = $link.closest( 'td' );
			var $approve = $cell.closest( 'tr' ).find( '.qs-approve' );
			var current = $approve.data( 'to' ) || '';
			var value = window.prompt(
				'Redirect target for:\n\n' + ( $approve.data( 'from' ) || '' ),
				current
			);
			if ( value === null ) {
				return;
			}
			value = $.trim( value );
			if ( !value ) {
				return;
			}
			$approve.data( 'to', value );
			$cell.find( '.qs-target-label' ).text( value );
			// Re-arm the row: a changed target means the previous result, whether
			// it succeeded or failed, no longer describes what the button does.
			$approve.removeClass( 'qs-pending qs-done qs-failed' ).empty();
			$( '<button>' )
				.addClass( 'qs-approve-btn' )
				.text( 'Create redirect' )
				.on( 'click', function () {
					$( this ).prop( 'disabled', true );
					approve( $approve );
				} )
				.appendTo( $approve );
		} );
	} );
}() );

Smṛtiḥ - Mindfulness is the ability to keep a chosen object or the present moment in mind without forgetting it. It acts as a stable foundation for meditation and daily awareness. Skt स्मृति  Tib དྲན་པ་  Ch 念  

Go to the page with the definition of 'memory'