tests/phpunit/includes/LinkerTest.php

   1 <?php
   2
   3 use MediaWiki\MediaWikiServices;
   4
   5 /**
   6  * @group Database
   7  */
   8
   9 class LinkerTest extends MediaWikiLangTestCase {
  10
  11         /**
  12          * @dataProvider provideCasesForUserLink
  13          * @covers Linker::userLink
  14          */
  15         public function testUserLink( $expected, $userId, $userName, $altUserName = false, $msg = '' ) {
  16                 $this->setMwGlobals( [
  17                         'wgArticlePath' => '/wiki/$1',
  18                 ] );
  19
  20                 $this->assertEquals(
  21                         $expected,
  22                         Linker::userLink( $userId, $userName, $altUserName ),
  23                         $msg
  24                 );
  25         }
  26
  27         public static function provideCasesForUserLink() {
  28                 # Format:
  29                 # - expected
  30                 # - userid
  31                 # - username
  32                 # - optional altUserName
  33                 # - optional message
  34                 return [
  35
  36                         # ## ANONYMOUS USER ########################################
  37                         [
  38                                 '<a href="/wiki/Special:Contributions/JohnDoe" '
  39                                         . 'class="mw-userlink mw-anonuserlink" '
  40                                         . 'title="Special:Contributions/JohnDoe"><bdi>JohnDoe</bdi></a>',
  41                                 0, 'JohnDoe', false,
  42                         ],
  43                         [
  44                                 '<a href="/wiki/Special:Contributions/::1" '
  45                                         . 'class="mw-userlink mw-anonuserlink" '
  46                                         . 'title="Special:Contributions/::1"><bdi>::1</bdi></a>',
  47                                 0, '::1', false,
  48                                 'Anonymous with pretty IPv6'
  49                         ],
  50                         [
  51                                 '<a href="/wiki/Special:Contributions/0:0:0:0:0:0:0:1" '
  52                                         . 'class="mw-userlink mw-anonuserlink" '
  53                                         . 'title="Special:Contributions/0:0:0:0:0:0:0:1"><bdi>::1</bdi></a>',
  54                                 0, '0:0:0:0:0:0:0:1', false,
  55                                 'Anonymous with almost pretty IPv6'
  56                         ],
  57                         [
  58                                 '<a href="/wiki/Special:Contributions/0000:0000:0000:0000:0000:0000:0000:0001" '
  59                                         . 'class="mw-userlink mw-anonuserlink" '
  60                                         . 'title="Special:Contributions/0000:0000:0000:0000:0000:0000:0000:0001"><bdi>::1</bdi></a>',
  61                                 0, '0000:0000:0000:0000:0000:0000:0000:0001', false,
  62                                 'Anonymous with full IPv6'
  63                         ],
  64                         [
  65                                 '<a href="/wiki/Special:Contributions/::1" '
  66                                         . 'class="mw-userlink mw-anonuserlink" '
  67                                         . 'title="Special:Contributions/::1"><bdi>AlternativeUsername</bdi></a>',
  68                                 0, '::1', 'AlternativeUsername',
  69                                 'Anonymous with pretty IPv6 and an alternative username'
  70                         ],
  71
  72                         # IPV4
  73                         [
  74                                 '<a href="/wiki/Special:Contributions/127.0.0.1" '
  75                                         . 'class="mw-userlink mw-anonuserlink" '
  76                                         . 'title="Special:Contributions/127.0.0.1"><bdi>127.0.0.1</bdi></a>',
  77                                 0, '127.0.0.1', false,
  78                                 'Anonymous with IPv4'
  79                         ],
  80                         [
  81                                 '<a href="/wiki/Special:Contributions/127.0.0.1" '
  82                                         . 'class="mw-userlink mw-anonuserlink" '
  83                                         . 'title="Special:Contributions/127.0.0.1"><bdi>AlternativeUsername</bdi></a>',
  84                                 0, '127.0.0.1', 'AlternativeUsername',
  85                                 'Anonymous with IPv4 and an alternative username'
  86                         ],
  87
  88                         # ## Regular user ##########################################
  89                         # TODO!
  90                 ];
  91         }
  92
  93         /**
  94          * @dataProvider provideCasesForFormatComment
  95          * @covers Linker::formatComment
  96          * @covers Linker::formatAutocomments
  97          * @covers Linker::formatLinksInComment
  98          */
  99         public function testFormatComment(
 100                 $expected, $comment, $title = false, $local = false, $wikiId = null
 101         ) {
 102                 $conf = new SiteConfiguration();
 103                 $conf->settings = [
 104                         'wgServer' => [
 105                                 'enwiki' => '//en.example.org',
 106                                 'dewiki' => '//de.example.org',
 107                         ],
 108                         'wgArticlePath' => [
 109                                 'enwiki' => '/w/$1',
 110                                 'dewiki' => '/w/$1',
 111                         ],
 112                 ];
 113                 $conf->suffixes = [ 'wiki' ];
 114
 115                 $this->setMwGlobals( [
 116                         'wgScript' => '/wiki/index.php',
 117                         'wgArticlePath' => '/wiki/$1',
 118                         'wgCapitalLinks' => true,
 119                         'wgConf' => $conf,
 120                 ] );
 121
 122                 if ( $title === false ) {
 123                         // We need a page title that exists
 124                         $title = Title::newFromText( 'Special:BlankPage' );
 125                 }
 126
 127                 $this->assertEquals(
 128                         $expected,
 129                         Linker::formatComment( $comment, $title, $local, $wikiId )
 130                 );
 131         }
 132
 133         public function provideCasesForFormatComment() {
 134                 $wikiId = 'enwiki'; // $wgConf has a fake entry for this
 135
 136                 // @codingStandardsIgnoreStart Generic.Files.LineLength
 137                 return [
 138                         // Linker::formatComment
 139                         [
 140                                 'a&lt;script&gt;b',
 141                                 'a<script>b',
 142                         ],
 143                         [
 144                                 'a—b',
 145                                 'a&mdash;b',
 146                         ],
 147                         [
 148                                 "&#039;&#039;&#039;not bolded&#039;&#039;&#039;",
 149                                 "'''not bolded'''",
 150                         ],
 151                         [
 152                                 "try &lt;script&gt;evil&lt;/scipt&gt; things",
 153                                 "try <script>evil</scipt> things",
 154                         ],
 155                         // Linker::formatAutocomments
 156                         [
 157                                 '<a href="/wiki/Special:BlankPage#autocomment" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment</span></span>',
 158                                 "/* autocomment */",
 159                         ],
 160                         [
 161                                 '<a href="/wiki/Special:BlankPage#linkie.3F" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment"><a href="/wiki/index.php?title=Linkie%3F&amp;action=edit&amp;redlink=1" class="new" title="Linkie? (page does not exist)">linkie?</a></span></span>',
 162                                 "/* [[linkie?]] */",
 163                         ],
 164                         [
 165                                 '<a href="/wiki/Special:BlankPage#autocomment" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment: </span> post</span>',
 166                                 "/* autocomment */ post",
 167                         ],
 168                         [
 169                                 'pre <a href="/wiki/Special:BlankPage#autocomment" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment</span></span>',
 170                                 "pre /* autocomment */",
 171                         ],
 172                         [
 173                                 'pre <a href="/wiki/Special:BlankPage#autocomment" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment: </span> post</span>',
 174                                 "pre /* autocomment */ post",
 175                         ],
 176                         [
 177                                 '<a href="/wiki/Special:BlankPage#autocomment" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment: </span> multiple? <a href="/wiki/Special:BlankPage#autocomment2" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment2: </span> </span></span>',
 178                                 "/* autocomment */ multiple? /* autocomment2 */ ",
 179                         ],
 180                         [
 181                                 '<a href="/wiki/Special:BlankPage#autocomment_containing_.2F.2A" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment containing /*: </span> T70361</span>',
 182                                 "/* autocomment containing /* */ T70361"
 183                         ],
 184                         [
 185                                 '<a href="/wiki/Special:BlankPage#autocomment_containing_.22quotes.22" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment containing &quot;quotes&quot;</span></span>',
 186                                 "/* autocomment containing \"quotes\" */"
 187                         ],
 188                         [
 189                                 '<a href="/wiki/Special:BlankPage#autocomment_containing_.3Cscript.3Etags.3C.2Fscript.3E" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment containing &lt;script&gt;tags&lt;/script&gt;</span></span>',
 190                                 "/* autocomment containing <script>tags</script> */"
 191                         ],
 192                         [
 193                                 '<a href="#autocomment">→</a>‎<span dir="auto"><span class="autocomment">autocomment</span></span>',
 194                                 "/* autocomment */",
 195                                 false, true
 196                         ],
 197                         [
 198                                 '‎<span dir="auto"><span class="autocomment">autocomment</span></span>',
 199                                 "/* autocomment */",
 200                                 null
 201                         ],
 202                         [
 203                                 '<a href="/wiki/Special:BlankPage#autocomment" title="Special:BlankPage">→</a>‎<span dir="auto"><span class="autocomment">autocomment</span></span>',
 204                                 "/* autocomment */",
 205                                 false, false
 206                         ],
 207                         [
 208                                 '<a class="external" rel="nofollow" href="//en.example.org/w/Special:BlankPage#autocomment">→</a>‎<span dir="auto"><span class="autocomment">autocomment</span></span>',
 209                                 "/* autocomment */",
 210                                 false, false, $wikiId
 211                         ],
 212                         // Linker::formatLinksInComment
 213                         [
 214                                 'abc <a href="/wiki/index.php?title=Link&amp;action=edit&amp;redlink=1" class="new" title="Link (page does not exist)">link</a> def',
 215                                 "abc [[link]] def",
 216                         ],
 217                         [
 218                                 'abc <a href="/wiki/index.php?title=Link&amp;action=edit&amp;redlink=1" class="new" title="Link (page does not exist)">text</a> def',
 219                                 "abc [[link|text]] def",
 220                         ],
 221                         [
 222                                 'abc <a href="/wiki/Special:BlankPage" title="Special:BlankPage">Special:BlankPage</a> def',
 223                                 "abc [[Special:BlankPage|]] def",
 224                         ],
 225                         [
 226                                 'abc <a href="/wiki/index.php?title=%C4%84%C5%9B%C5%BC&amp;action=edit&amp;redlink=1" class="new" title="Ąśż (page does not exist)">ąśż</a> def',
 227                                 "abc [[%C4%85%C5%9B%C5%BC]] def",
 228                         ],
 229                         [
 230                                 'abc <a href="/wiki/Special:BlankPage#section" title="Special:BlankPage">#section</a> def',
 231                                 "abc [[#section]] def",
 232                         ],
 233                         [
 234                                 'abc <a href="/wiki/index.php?title=/subpage&amp;action=edit&amp;redlink=1" class="new" title="/subpage (page does not exist)">/subpage</a> def',
 235                                 "abc [[/subpage]] def",
 236                         ],
 237                         [
 238                                 'abc <a href="/wiki/index.php?title=%22evil!%22&amp;action=edit&amp;redlink=1" class="new" title="&quot;evil!&quot; (page does not exist)">&quot;evil!&quot;</a> def',
 239                                 "abc [[\"evil!\"]] def",
 240                         ],
 241                         [
 242                                 'abc [[&lt;script&gt;very evil&lt;/script&gt;]] def',
 243                                 "abc [[<script>very evil</script>]] def",
 244                         ],
 245                         [
 246                                 'abc [[|]] def',
 247                                 "abc [[|]] def",
 248                         ],
 249                         [
 250                                 'abc <a href="/wiki/index.php?title=Link&amp;action=edit&amp;redlink=1" class="new" title="Link (page does not exist)">link</a> def',
 251                                 "abc [[link]] def",
 252                                 false, false
 253                         ],
 254                         [
 255                                 'abc <a class="external" rel="nofollow" href="//en.example.org/w/Link">link</a> def',
 256                                 "abc [[link]] def",
 257                                 false, false, $wikiId
 258                         ],
 259                 ];
 260                 // @codingStandardsIgnoreEnd
 261         }
 262
 263         /**
 264          * @covers Linker::formatLinksInComment
 265          * @dataProvider provideCasesForFormatLinksInComment
 266          */
 267         public function testFormatLinksInComment( $expected, $input, $wiki ) {
 268
 269                 $conf = new SiteConfiguration();
 270                 $conf->settings = [
 271                         'wgServer' => [
 272                                 'enwiki' => '//en.example.org'
 273                         ],
 274                         'wgArticlePath' => [
 275                                 'enwiki' => '/w/$1',
 276                         ],
 277                 ];
 278                 $conf->suffixes = [ 'wiki' ];
 279                 $this->setMwGlobals( [
 280                         'wgScript' => '/wiki/index.php',
 281                         'wgArticlePath' => '/wiki/$1',
 282                         'wgCapitalLinks' => true,
 283                         'wgConf' => $conf,
 284                 ] );
 285
 286                 $this->assertEquals(
 287                         $expected,
 288                         Linker::formatLinksInComment( $input, Title::newFromText( 'Special:BlankPage' ), false, $wiki )
 289                 );
 290         }
 291
 292         public static function provideCasesForFormatLinksInComment() {
 293                 // @codingStandardsIgnoreStart Generic.Files.LineLength
 294                 return [
 295                         [
 296                                 'foo bar <a href="/wiki/Special:BlankPage" title="Special:BlankPage">Special:BlankPage</a>',
 297                                 'foo bar [[Special:BlankPage]]',
 298                                 null,
 299                         ],
 300                         [
 301                                 '<a class="external" rel="nofollow" href="//en.example.org/w/Foo%27bar">Foo\'bar</a>',
 302                                 "[[Foo'bar]]",
 303                                 'enwiki',
 304                         ],
 305                         [
 306                                 'foo bar <a class="external" rel="nofollow" href="//en.example.org/w/Special:BlankPage">Special:BlankPage</a>',
 307                                 'foo bar [[Special:BlankPage]]',
 308                                 'enwiki',
 309                         ],
 310                         [
 311                                 'foo bar <a class="external" rel="nofollow" href="//en.example.org/w/File:Example">Image:Example</a>',
 312                                 'foo bar [[Image:Example]]',
 313                                 'enwiki',
 314                         ],
 315                 ];
 316                 // @codingStandardsIgnoreEnd
 317         }
 318
 319         public static function provideLinkBeginHook() {
 320                 // @codingStandardsIgnoreStart Generic.Files.LineLength
 321                 return [
 322                         // Modify $html
 323                         [
 324                                 function( $dummy, $title, &$html, &$attribs, &$query, &$options, &$ret ) {
 325                                         $html = 'foobar';
 326                                 },
 327                                 '<a href="/wiki/Special:BlankPage" title="Special:BlankPage">foobar</a>'
 328                         ],
 329                         // Modify $attribs
 330                         [
 331                                 function( $dummy, $title, &$html, &$attribs, &$query, &$options, &$ret ) {
 332                                         $attribs['bar'] = 'baz';
 333                                 },
 334                                 '<a href="/wiki/Special:BlankPage" title="Special:BlankPage" bar="baz">Special:BlankPage</a>'
 335                         ],
 336                         // Modify $query
 337                         [
 338                                 function( $dummy, $title, &$html, &$attribs, &$query, &$options, &$ret ) {
 339                                         $query['bar'] = 'baz';
 340                                 },
 341                                 '<a href="/w/index.php?title=Special:BlankPage&amp;bar=baz" title="Special:BlankPage">Special:BlankPage</a>'
 342                         ],
 343                         // Force HTTP $options
 344                         [
 345                                 function( $dummy, $title, &$html, &$attribs, &$query, &$options, &$ret ) {
 346                                         $options = [ 'http' ];
 347                                 },
 348                                 '<a href="http://example.org/wiki/Special:BlankPage" title="Special:BlankPage">Special:BlankPage</a>'
 349                         ],
 350                         // Force 'forcearticlepath' in $options
 351                         [
 352                                 function( $dummy, $title, &$html, &$attribs, &$query, &$options, &$ret ) {
 353                                         $options = [ 'forcearticlepath' ];
 354                                         $query['foo'] = 'bar';
 355                                 },
 356                                 '<a href="/wiki/Special:BlankPage?foo=bar" title="Special:BlankPage">Special:BlankPage</a>'
 357                         ],
 358                         // Abort early
 359                         [
 360                                 function( $dummy, $title, &$html, &$attribs, &$query, &$options, &$ret ) {
 361                                         $ret = 'foobar';
 362                                         return false;
 363                                 },
 364                                 'foobar'
 365                         ],
 366                 ];
 367                 // @codingStandardsIgnoreEnd
 368         }
 369
 370         /**
 371          * @covers MediaWiki\Linker\LinkRenderer::runLegacyBeginHook
 372          * @dataProvider provideLinkBeginHook
 373          */
 374         public function testLinkBeginHook( $callback, $expected ) {
 375                 $this->setMwGlobals( [
 376                         'wgArticlePath' => '/wiki/$1',
 377                         'wgServer' => '//example.org',
 378                         'wgCanonicalServer' => 'http://example.org',
 379                         'wgScriptPath' => '/w',
 380                         'wgScript' => '/w/index.php',
 381                 ] );
 382
 383                 $this->setMwGlobals( 'wgHooks', [ 'LinkBegin' => [ $callback ] ] );
 384                 $title = SpecialPage::getTitleFor( 'Blankpage' );
 385                 $out = Linker::link( $title );
 386                 $this->assertEquals( $expected, $out );
 387         }
 388
 389         public static function provideLinkEndHook() {
 390                 return [
 391                         // Override $html
 392                         [
 393                                 function ( $dummy, $title, $options, &$html, &$attribs, &$ret ) {
 394                                         $html = 'foobar';
 395                                 },
 396                                 '<a href="/wiki/Special:BlankPage" title="Special:BlankPage">foobar</a>'
 397                         ],
 398                         // Modify $attribs
 399                         [
 400                                 function ( $dummy, $title, $options, &$html, &$attribs, &$ret ) {
 401                                         $attribs['bar'] = 'baz';
 402                                 },
 403                                 '<a href="/wiki/Special:BlankPage" title="Special:BlankPage" bar="baz">Special:BlankPage</a>'
 404                         ],
 405                         // Fully override return value and abort hook
 406                         [
 407                                 function ( $dummy, $title, $options, &$html, &$attribs, &$ret ) {
 408                                         $ret = 'blahblahblah';
 409                                         return false;
 410                                 },
 411                                 'blahblahblah'
 412                         ],
 413
 414                 ];
 415         }
 416
 417         /**
 418          * @covers MediaWiki\Linker\LinkRenderer::buildAElement
 419          * @dataProvider provideLinkEndHook
 420          */
 421         public function testLinkEndHook( $callback, $expected ) {
 422                 $this->setMwGlobals( [
 423                         'wgArticlePath' => '/wiki/$1',
 424                 ] );
 425
 426                 $this->setMwGlobals( 'wgHooks', [ 'LinkEnd' => [ $callback ] ] );
 427
 428                 $title = SpecialPage::getTitleFor( 'Blankpage' );
 429                 $out = Linker::link( $title );
 430                 $this->assertEquals( $expected, $out );
 431         }
 432
 433         /**
 434          * @covers Linker::getLinkColour
 435          */
 436         public function testGetLinkColour() {
 437                 $this->hideDeprecated( 'Linker::getLinkColour' );
 438                 $linkCache = MediaWikiServices::getInstance()->getLinkCache();
 439                 $foobarTitle = Title::makeTitle( NS_MAIN, 'FooBar' );
 440                 $redirectTitle = Title::makeTitle( NS_MAIN, 'Redirect' );
 441                 $userTitle = Title::makeTitle( NS_USER, 'Someuser' );
 442                 $linkCache->addGoodLinkObj(
 443                         1, // id
 444                         $foobarTitle,
 445                         10, // len
 446                         0 // redir
 447                 );
 448                 $linkCache->addGoodLinkObj(
 449                         2, // id
 450                         $redirectTitle,
 451                         10, // len
 452                         1 // redir
 453                 );
 454
 455                 $linkCache->addGoodLinkObj(
 456                         3, // id
 457                         $userTitle,
 458                         10, // len
 459                         0 // redir
 460                 );
 461
 462                 $this->assertEquals(
 463                         '',
 464                         Linker::getLinkColour( $foobarTitle, 0 )
 465                 );
 466
 467                 $this->assertEquals(
 468                         'stub',
 469                         Linker::getLinkColour( $foobarTitle, 20 )
 470                 );
 471
 472                 $this->assertEquals(
 473                         'mw-redirect',
 474                         Linker::getLinkColour( $redirectTitle, 0 )
 475                 );
 476
 477                 $this->assertEquals(
 478                         '',
 479                         Linker::getLinkColour( $userTitle, 20 )
 480                 );
 481         }
 482 }