mediawiki-extensions-RevisionSlider/RevisionSlider.hooks.php

<?php
use MediaWiki\MediaWikiServices;

/**
 * RevisionSlider extension hooks
 *
 * @file
 * @ingroup Extensions
 * @license GPL-2.0+
 */
class RevisionSliderHooks {

	public static function onDiffViewHeader(
		DifferenceEngine $diff,
		Revision $oldRev,
		Revision $newRev
	) {
		/**
		 * If this extension is deployed with the BetaFeatures extension then require the
		 * current user to have it enabled as a BetaFeature.
		 */
		if (
			class_exists( BetaFeatures::class ) &&
			!BetaFeatures::isFeatureEnabled( $diff->getUser(), 'revisionslider' ) )
		{
			return true;
		}

		/**
		 * Do not show the RevisionSlider on special pages that use a Diff view for example
		 * Special:ComparePages
		 */
		if ( $diff->getTitle()->inNamespace( NS_SPECIAL ) ) {
			return true;
		}

		$config = MediaWikiServices::getInstance()->getMainConfig();
		$timeOffset = $config->get( 'LocalTZoffset' );
		if ( is_null( $config->get( 'Localtimezone' ) ) ) {
			$timeOffset = 0;
		} elseif ( is_null( $timeOffset ) ) {
			$timeOffset = 0;
		}

		$out = RequestContext::getMain()->getOutput();
		$out->addModules( 'ext.RevisionSlider.init' );
		$out->addModuleStyles( 'ext.RevisionSlider.noscript' );
		$out->addJsConfigVars( 'extRevisionSliderOldRev', $oldRev->getId() );
		$out->addJsConfigVars( 'extRevisionSliderNewRev', $newRev->getId() );
		$out->addJsConfigVars( 'extRevisionSliderTimeOffset', intval( $timeOffset ) );
		$out->enableOOUI();

		// FIXME: this really not nice to inject those elements to ButtonWidget like that
		// but this is only done to have inline styles set for those elements, so they are
		// rendered as intended before RL loads all CSS styles (avoid jumping after CSS is loaded).
		// Some better and more future-proof solution (what if ButtonWidget switches to use other tags?)
		// should be used if possible.
		$button = new OOUI\Tag( 'a' );
		$label = new OOUI\Tag( 'span' );
		$icon = new OOUI\Tag( 'span' );
		$button->setAttributes( [ 'style' => 'width: 100%;' ] );
		$label->setAttributes( [ 'style' => 'line-height: 1.875em;' ] );
		$icon->setAttributes( [ 'style' => 'float: right;' ] );

		$toggleButton = new OOUI\ButtonWidget( [
			'label' => ( new Message( 'revisionslider-toggle-label' ) )->text(),
			'icon' => 'expand',
			'button' => $button,
			'labelElement' => $label,
			'iconElement' => $icon,
			'classes' => [ 'mw-revslider-toggle-button' ],
			'infusable' => true,
			'framed' => false,
			'title' => ( new Message( 'revisionslider-toggle-title-expand' ) )->text(),
		] );
		$toggleButton->setAttributes( [ 'style' => 'width: 100%; text-align: center;' ] );

		$out->addHTML(
			Html::rawElement(
				'div',
				[
					'class' => 'mw-revslider-container',
					'style' => 'border: 1px solid #cccccc;'
				],
				$toggleButton .
				Html::rawElement(
					'div',
					[
						'class' => 'mw-revslider-slider-wrapper',
						'style' => 'min-height: 142px; display: none; border-top: 1px solid #cccccc;',
					],
					Html::element(
						'p',
						[
							'class' => 'mw-revslider-placeholder',
							'style' => 'text-align: center',
						],
						( new Message( 'revisionslider-loading-placeholder' ) )->text()
					)
				)
			)
		);
		return true;
	}

	public static function getBetaFeaturePreferences( $user, &$prefs ) {
		global $wgExtensionAssetsPath;

		$prefs['revisionslider'] = [
			'label-message' => 'revisionslider-beta-feature-message',
			'desc-message' => 'revisionslider-beta-feature-description',
			'screenshot' => [
				'ltr' => "$wgExtensionAssetsPath/RevisionSlider/resources/RevisionSlider-beta-features-ltr.png",
				'rtl' => "$wgExtensionAssetsPath/RevisionSlider/resources/RevisionSlider-beta-features-rtl.png",
			],
			'info-link' => 'https://www.mediawiki.org/wiki/Extension:RevisionSlider',
			'discussion-link' => 'https://www.mediawiki.org/wiki/Extension_talk:RevisionSlider',
		];
	}

	public static function onResourceLoaderTestModules( array &$testModules, ResourceLoader $rl ) {
		$testModules['qunit']['ext.RevisionSlider.tests'] = [
			'scripts' => [
				'tests/qunit/QUnit.revisionSlider.testOrSkip.js',
				'tests/qunit/RevisionSlider.Revision.test.js',
				'tests/qunit/RevisionSlider.Pointer.test.js',
				'tests/qunit/RevisionSlider.PointerView.test.js',
				'tests/qunit/RevisionSlider.Slider.test.js',
				'tests/qunit/RevisionSlider.SliderView.test.js',
				'tests/qunit/RevisionSlider.RevisionList.test.js',
				'tests/qunit/RevisionSlider.RevisionListView.test.js',
				'tests/qunit/RevisionSlider.DiffPage.test.js',
				'tests/qunit/RevisionSlider.HelpDialog.test.js',
			],
			'dependencies' => [
				'ext.RevisionSlider.Revision',
				'ext.RevisionSlider.Pointer',
				'ext.RevisionSlider.PointerView',
				'ext.RevisionSlider.Slider',
				'ext.RevisionSlider.SliderView',
				'ext.RevisionSlider.RevisionList',
				'ext.RevisionSlider.RevisionListView',
				'ext.RevisionSlider.DiffPage',
				'ext.RevisionSlider.HelpDialog',
				'jquery.ui.draggable',
				'jquery.ui.tooltip',
				'oojs-ui'
			],
			'localBasePath' => __DIR__,
			'remoteExtPath' => 'RevisionSlider',
		];

		return true;
	}
}