. * * @file * @ingroup extensions */ use MediaWiki\Config\GlobalVarConfig; use MediaWiki\Title\Title; use MediaWiki\User\Options\UserOptionsLookup; use MediaWiki\User\User; use PHPUnit\Framework\MockObject\Stub\ConsecutiveCalls; use Popups\PopupsContext; use Popups\PopupsGadgetsIntegration; /** * @group Popups * @coversDefaultClass \Popups\PopupsContext */ class PopupsContextTest extends MediaWikiIntegrationTestCase { /** * Anonymous user id * @see MediaWikiIntegrationTestCase::addCoreDBData() */ private const ANONYMOUS_USER = 0; /** * Helper method to quickly build Popups Context * @param ExtensionRegistry|null $registry * @param PopupsGadgetsIntegration|null $integration * @return PopupsContext */ protected function getContext( $registry = null, $integration = null ) { $config = new GlobalVarConfig(); $registry = $registry ?: ExtensionRegistry::getInstance(); if ( $integration === null ) { $integration = $this->createMock( PopupsGadgetsIntegration::class ); $integration->method( 'conflictsWithNavPopupsGadget' ) ->willReturn( false ); } $services = $this->getServiceContainer(); return new PopupsContext( $config, $registry, $integration, $services->getSpecialPageFactory(), $services->getUserOptionsLookup() ); } /** * @covers ::showPreviewsOptInOnPreferencesPage * @dataProvider provideConfigForShowPreviewsInOptIn * @param array $config * @param bool $expected */ public function testShowPreviewsPreferencesPage( array $config, $expected ) { $this->setMwGlobals( $config ); $context = $this->getContext(); $this->assertSame( $expected, $context->showPreviewsOptInOnPreferencesPage(), 'The previews opt-in is ' . ( $expected ? 'shown.' : 'hidden.' ) ); } public static function provideConfigForShowPreviewsInOptIn() { return [ [ [ 'wgPopupsHideOptInOnPreferencesPage' => false ], true ], [ [ 'wgPopupsHideOptInOnPreferencesPage' => true ], false ] ]; } /** * @covers ::shouldSendModuleToUser */ public function testShouldSendToAnonUser() { $user = $this->createMock( User::class ); $user->method( 'getId' )->willReturn( self::ANONYMOUS_USER ); $context = $this->getContext(); $this->assertTrue( $context->shouldSendModuleToUser( $user ), 'The module is always sent to anonymous users.' ); } /** * Tests #shouldSendModuleToUser when the user is logged in and the reference previews feature * is disabled. * * @covers ::shouldSendModuleToUser * @dataProvider provideTestDataForShouldSendModuleToUser * @param bool $optIn * @param bool $expected */ public function testShouldSendModuleToUser( $optIn, $expected ) { $this->setMwGlobals( [ 'wgPopupsReferencePreviews' => false, ] ); $user = $this->createMock( User::class ); $user->method( 'isNamed' )->willReturn( true ); $userOptLookup = $this->createMock( UserOptionsLookup::class ); $userOptLookup->method( 'getBoolOption' ) ->with( $user, PopupsContext::PREVIEWS_OPTIN_PREFERENCE_NAME ) ->willReturn( $optIn ); $this->setService( 'UserOptionsLookup', $userOptLookup ); $context = $this->getContext(); $this->assertSame( $expected, $context->shouldSendModuleToUser( $user ), ( $expected ? 'A' : 'No' ) . ' module is sent to the user.' ); } public static function provideTestDataForShouldSendModuleToUser() { return [ [ 'optin' => PopupsContext::PREVIEWS_ENABLED, 'expected' => true ], [ 'optin' => PopupsContext::PREVIEWS_DISABLED, 'expected' => false ] ]; } /** * @covers ::areDependenciesMet * @covers ::__construct * @dataProvider provideTestDataForTestAreDependenciesMet * @param bool $textExtracts * @param bool $pageImages * @param string $gateway * @param bool $expected */ public function testAreDependenciesMet( $textExtracts, $pageImages, $gateway, $expected ) { $this->setMwGlobals( [ 'wgPopupsGateway' => $gateway, ] ); $returnValues = [ $textExtracts, $pageImages ]; $mock = $this->createMock( ExtensionRegistry::class ); $mock->method( 'isLoaded' ) ->will( new ConsecutiveCalls( $returnValues ) ); $context = $this->getContext( $mock ); $this->assertSame( $expected, $context->areDependenciesMet(), 'Dependencies are ' . ( $expected ? '' : 'not ' ) . 'met.' ); } public static function provideTestDataForTestAreDependenciesMet() { return [ // Dependencies are met [ 'textExtracts' => true, 'pageImages' => true, 'gateway' => 'mwApiPlain', 'expected' => true ], // textExtracts dep is missing [ 'textExtracts' => false, 'pageImages' => true, 'gateway' => 'mwApiPlain', 'expected' => false ], // PageImages dep is missing [ 'textExtracts' => true, 'pageImages' => false, 'gateway' => 'mwApiPlain', 'expected' => false ], // when Popups uses gateway!=mwApiPlain we don't require PageImages nor TextExtracts [ 'textExtracts' => false, 'pageImages' => false, 'gateway' => 'restbaseHTML', 'expected' => true ], ]; } /** * @covers ::isTitleExcluded * @dataProvider provideTestIsTitleExcluded * @param string[] $excludedPages * @param Title $title * @param bool $expected */ public function testIsTitleExcluded( array $excludedPages, Title $title, $expected ) { $this->setMwGlobals( [ 'wgPopupsPageDisabled' => $excludedPages ] ); $context = $this->getContext(); $this->assertSame( $expected, $context->isTitleExcluded( $title ), 'The title is' . ( $expected ? ' ' : ' not ' ) . 'excluded.' ); } public static function provideTestIsTitleExcluded() { $excludedPages = [ 'Special:Userlogin', 'Special:CreateAccount', 'User:A' ]; return [ [ $excludedPages, Title::newFromText( 'Main_Page' ), false ], [ $excludedPages, Title::newFromText( 'Special:CreateAccount' ), true ], [ $excludedPages, Title::newFromText( 'User:A' ), true ], [ $excludedPages, Title::newFromText( 'User:A/B' ), true ], [ $excludedPages, Title::newFromText( 'User:B' ), false ], [ $excludedPages, Title::newFromText( 'User:B/A' ), false ], // test canonical name handling [ $excludedPages, Title::newFromText( 'Special:UserLogin' ), true ], ]; } /** * Test if special page in different language is excluded * * @covers ::isTitleExcluded */ public function testIsTranslatedTitleExcluded() { $page = 'Specjalna:Preferencje'; $excludedPages = [ 'Special:Preferences' ]; $this->setMwGlobals( [ 'wgPopupsPageDisabled' => $excludedPages, 'wgLanguageCode' => 'pl' ] ); $context = $this->getContext(); $this->assertTrue( $context->isTitleExcluded( Title::newFromText( $page ) ), 'The title is excluded.' ); } /** * @covers ::conflictsWithNavPopupsGadget */ public function testConflictsWithNavPopupsGadget() { $integrationMock = $this->createMock( PopupsGadgetsIntegration::class ); $user = $this->createMock( User::class ); $integrationMock->expects( $this->once() ) ->method( 'conflictsWithNavPopupsGadget' ) ->with( $user ) ->willReturn( true ); $context = $this->getContext( null, $integrationMock ); $this->assertTrue( $context->conflictsWithNavPopupsGadget( $user ), 'A conflict is identified.' ); } /** * @covers ::getConfigBitmaskFromUser * @dataProvider provideTestGetConfigBitmaskFromUser * @param bool $navPops * @param bool $refTooltips * @param bool $refEnabled * @param int $expected */ public function testGetConfigBitmaskFromUser( $navPops, $refTooltips, $refEnabled, $expected ) { $contextMock = $this->createPartialMock( PopupsContext::class, [ 'conflictsWithNavPopupsGadget', 'conflictsWithRefTooltipsGadget', 'isReferencePreviewsEnabled', ] ); $contextMock->method( 'conflictsWithNavPopupsGadget' ) ->willReturn( $navPops ); $contextMock->method( 'conflictsWithRefTooltipsGadget' ) ->willReturn( $refTooltips ); $contextMock->method( 'isReferencePreviewsEnabled' ) ->willReturn( $refEnabled ); $this->assertSame( $expected, $contextMock->getConfigBitmaskFromUser( $this->createMock( User::class ) ) ); } public static function provideTestGetConfigBitmaskFromUser() { return [ [ true, true, true, 7, ], [ false, true, false, 2, ], [ true, false, true, 5, ], [ false, false, false, 0, ], ]; } }