includes/widget/search/SimpleSearchResultSetWidget.php

   1 <?php
   2
   3 namespace MediaWiki\Widget\Search;
   4
   5 use MediaWiki\Interwiki\InterwikiLookup;
   6 use MediaWiki\Linker\LinkRenderer;
   7 use SearchResultSet;
   8 use SpecialSearch;
   9 use Title;
  10 use Html;
  11
  12 /**
  13  * Renders one or more SearchResultSets into a sidebar grouped by
  14  * interwiki prefix. Includes a per-wiki header indicating where
  15  * the results are from.
  16  *
  17  * @deprecated since 1.31. Use InterwikiSearchResultSetWidget
  18  */
  19 class SimpleSearchResultSetWidget implements SearchResultSetWidget {
  20         /** @var SpecialSearch */
  21         protected $specialSearch;
  22         /** @var SearchResultWidget */
  23         protected $resultWidget;
  24         /** @var string[]|null */
  25         protected $customCaptions;
  26         /** @var LinkRenderer */
  27         protected $linkRenderer;
  28         /** @var InterwikiLookup */
  29         protected $iwLookup;
  30
  31         public function __construct(
  32                 SpecialSearch $specialSearch,
  33                 SearchResultWidget $resultWidget,
  34                 LinkRenderer $linkRenderer,
  35                 InterwikiLookup $iwLookup
  36         ) {
  37                 wfDeprecated( __METHOD__, '1.31' );
  38                 $this->specialSearch = $specialSearch;
  39                 $this->resultWidget = $resultWidget;
  40                 $this->linkRenderer = $linkRenderer;
  41                 $this->iwLookup = $iwLookup;
  42         }
  43
  44         /**
  45          * @param string $term User provided search term
  46          * @param SearchResultSet|SearchResultSet[] $resultSets List of interwiki
  47          *  results to render.
  48          * @return string HTML
  49          */
  50         public function render( $term, $resultSets ) {
  51                 if ( !is_array( $resultSets ) ) {
  52                         $resultSets = [ $resultSets ];
  53                 }
  54
  55                 $this->loadCustomCaptions();
  56
  57                 $iwResults = [];
  58                 foreach ( $resultSets as $resultSet ) {
  59                         foreach ( $resultSet as $result ) {
  60                                 if ( !$result->isBrokenTitle() ) {
  61                                         $iwResults[$result->getTitle()->getInterwiki()][] = $result;
  62                                 }
  63                         }
  64                 }
  65
  66                 $out = '';
  67                 foreach ( $iwResults as $iwPrefix => $results ) {
  68                         $out .= $this->headerHtml( $iwPrefix, $term );
  69                         $out .= "<ul class='mw-search-iwresults'>";
  70                         // TODO: Assumes interwiki results are never paginated
  71                         $position = 0;
  72                         foreach ( $results as $result ) {
  73                                 $out .= $this->resultWidget->render( $result, $term, $position++ );
  74                         }
  75                         $out .= "</ul>";
  76                 }
  77
  78                 return "<div id='mw-search-interwiki'>" .
  79                         "<div id='mw-search-interwiki-caption'>" .
  80                                 $this->specialSearch->msg( 'search-interwiki-caption' )->parse() .
  81                         '</div>' .
  82                         $out .
  83                 "</div>";
  84         }
  85
  86         /**
  87          * Generates an appropriate HTML header for the given interwiki prefix
  88          *
  89          * @param string $iwPrefix Interwiki prefix of wiki to show header for
  90          * @param string $term User provided search term
  91          * @return string HTML
  92          */
  93         protected function headerHtml( $iwPrefix, $term ) {
  94                 if ( isset( $this->customCaptions[$iwPrefix] ) ) {
  95                         $caption = $this->customCaptions[$iwPrefix];
  96                 } else {
  97                         $interwiki = $this->iwLookup->fetch( $iwPrefix );
  98                         $parsed = wfParseUrl( wfExpandUrl( $interwiki ? $interwiki->getURL() : '/' ) );
  99                         $caption = $this->specialSearch->msg( 'search-interwiki-default', $parsed['host'] )->escaped();
 100                 }
 101
 102                 $href = Title::makeTitle( NS_SPECIAL, 'Search', null, $iwPrefix )->getLocalURL(
 103                         [ 'search' => $term, 'fulltext' => 1 ]
 104                 );
 105                 $searchLink = Html::rawElement(
 106                         'a',
 107                         [ 'href' => $href ],
 108                         $this->specialSearch->msg( 'search-interwiki-more' )->escaped()
 109                 );
 110
 111                 return "<div class='mw-search-interwiki-project'>" .
 112                         "<span class='mw-search-interwiki-more'>{$searchLink}</span>" .
 113                         $caption .
 114                 "</div>";
 115         }
 116
 117         protected function loadCustomCaptions() {
 118                 if ( $this->customCaptions !== null ) {
 119                         return;
 120                 }
 121
 122                 $this->customCaptions = [];
 123                 $customLines = explode( "\n", $this->specialSearch->msg( 'search-interwiki-custom' )->escaped() );
 124                 foreach ( $customLines as $line ) {
 125                         $parts = explode( ':', $line, 2 );
 126                         if ( count( $parts ) === 2 ) {
 127                                 $this->customCaptions[$parts[0]] = $parts[1];
 128                         }
 129                 }
 130         }
 131 }