includes/specials/SpecialRecentchangeslinked.php

   1 <?php
   2 /**
   3  * Implements Special:Recentchangeslinked
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License as published by
   7  * the Free Software Foundation; either version 2 of the License, or
   8  * (at your option) any later version.
   9  *
  10  * This program is distributed in the hope that it will be useful,
  11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  13  * GNU General Public License for more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along
  16  * with this program; if not, write to the Free Software Foundation, Inc.,
  17  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  18  * http://www.gnu.org/copyleft/gpl.html
  19  *
  20  * @file
  21  * @ingroup SpecialPage
  22  */
  23
  24 /**
  25  * This is to display changes made to all articles linked in an article.
  26  *
  27  * @ingroup SpecialPage
  28  */
  29 class SpecialRecentchangeslinked extends SpecialRecentChanges {
  30         var $rclTargetTitle;
  31
  32         function __construct(){
  33                 parent::__construct( 'Recentchangeslinked' );
  34         }
  35
  36         public function getDefaultOptions() {
  37                 $opts = parent::getDefaultOptions();
  38                 $opts->add( 'target', '' );
  39                 $opts->add( 'showlinkedto', false );
  40                 $opts->add( 'tagfilter', '' );
  41                 return $opts;
  42         }
  43
  44         public function parseParameters( $par, FormOptions $opts ) {
  45                 $opts['target'] = $par;
  46         }
  47
  48         public function feedSetup() {
  49                 $opts = parent::feedSetup();
  50                 $opts['target'] = $this->getRequest()->getVal( 'target' );
  51                 return $opts;
  52         }
  53
  54         public function getFeedObject( $feedFormat ){
  55                 $feed = new ChangesFeed( $feedFormat, false );
  56                 $feedObj = $feed->getFeedObject(
  57                         $this->msg( 'recentchangeslinked-title', $this->getTargetTitle()->getPrefixedText() )
  58                                 ->inContentLanguage()->text(),
  59                         $this->msg( 'recentchangeslinked-feed' )->inContentLanguage()->text(),
  60                         $this->getTitle()->getFullUrl()
  61                 );
  62                 return array( $feed, $feedObj );
  63         }
  64
  65         public function doMainQuery( $conds, $opts ) {
  66                 $target = $opts['target'];
  67                 $showlinkedto = $opts['showlinkedto'];
  68                 $limit = $opts['limit'];
  69
  70                 if ( $target === '' ) {
  71                         return false;
  72                 }
  73                 $outputPage = $this->getOutput();
  74                 $title = Title::newFromURL( $target );
  75                 if( !$title || $title->getInterwiki() != '' ){
  76                         $outputPage->wrapWikiMsg( "<div class=\"errorbox\">\n$1\n</div><br style=\"clear: both\" />", 'allpagesbadtitle' );
  77                         return false;
  78                 }
  79
  80                 $outputPage->setPageTitle( $this->msg( 'recentchangeslinked-title', $title->getPrefixedText() ) );
  81
  82                 /*
  83                  * Ordinary links are in the pagelinks table, while transclusions are
  84                  * in the templatelinks table, categorizations in categorylinks and
  85                  * image use in imagelinks.  We need to somehow combine all these.
  86                  * Special:Whatlinkshere does this by firing multiple queries and
  87                  * merging the results, but the code we inherit from our parent class
  88                  * expects only one result set so we use UNION instead.
  89                  */
  90
  91                 $dbr = wfGetDB( DB_SLAVE, 'recentchangeslinked' );
  92                 $id = $title->getArticleID();
  93                 $ns = $title->getNamespace();
  94                 $dbkey = $title->getDBkey();
  95
  96                 $tables = array( 'recentchanges' );
  97                 $select = array( $dbr->tableName( 'recentchanges' ) . '.*' );
  98                 $join_conds = array();
  99                 $query_options = array();
 100
 101                 // left join with watchlist table to highlight watched rows
 102                 $uid = $this->getUser()->getId();
 103                 if( $uid ) {
 104                         $tables[] = 'watchlist';
 105                         $select[] = 'wl_user';
 106                         $join_conds['watchlist'] = array( 'LEFT JOIN', "wl_user={$uid} AND wl_title=rc_title AND wl_namespace=rc_namespace" );
 107                 }
 108                 if ( $this->getUser()->isAllowed( 'rollback' ) ) {
 109                         $tables[] = 'page';
 110                         $join_conds['page'] = array('LEFT JOIN', 'rc_cur_id=page_id');
 111                         $select[] = 'page_latest';
 112                 }
 113                 if ( !$this->including() ) { // bug 23293
 114                         ChangeTags::modifyDisplayQuery( $tables, $select, $conds, $join_conds,
 115                                 $query_options, $opts['tagfilter'] );
 116                 }
 117
 118                 if ( !wfRunHooks( 'SpecialRecentChangesQuery', array( &$conds, &$tables, &$join_conds, $opts, &$query_options, &$select ) ) ) {
 119                         return false;
 120                 }
 121
 122                 if( $ns == NS_CATEGORY && !$showlinkedto ) {
 123                         // special handling for categories
 124                         // XXX: should try to make this less klugy
 125                         $link_tables = array( 'categorylinks' );
 126                         $showlinkedto = true;
 127                 } else {
 128                         // for now, always join on these tables; really should be configurable as in whatlinkshere
 129                         $link_tables = array( 'pagelinks', 'templatelinks' );
 130                         // imagelinks only contains links to pages in NS_FILE
 131                         if( $ns == NS_FILE || !$showlinkedto ) {
 132                                 $link_tables[] = 'imagelinks';
 133                         }
 134                 }
 135
 136                 if( $id == 0 && !$showlinkedto ) {
 137                         return false; // nonexistent pages can't link to any pages
 138                 }
 139
 140                 // field name prefixes for all the various tables we might want to join with
 141                 $prefix = array( 'pagelinks' => 'pl', 'templatelinks' => 'tl', 'categorylinks' => 'cl', 'imagelinks' => 'il' );
 142
 143                 $subsql = array(); // SELECT statements to combine with UNION
 144
 145                 foreach( $link_tables as $link_table ) {
 146                         $pfx = $prefix[$link_table];
 147
 148                         // imagelinks and categorylinks tables have no xx_namespace field, and have xx_to instead of xx_title
 149                         if( $link_table == 'imagelinks' ) {
 150                                 $link_ns = NS_FILE;
 151                         } elseif( $link_table == 'categorylinks' ) {
 152                                 $link_ns = NS_CATEGORY;
 153                         } else {
 154                                 $link_ns = 0;
 155                         }
 156
 157                         if( $showlinkedto ) {
 158                                 // find changes to pages linking to this page
 159                                 if( $link_ns ) {
 160                                         if( $ns != $link_ns ) {
 161                                                 continue;
 162                                         } // should never happen, but check anyway
 163                                         $subconds = array( "{$pfx}_to" => $dbkey );
 164                                 } else {
 165                                         $subconds = array( "{$pfx}_namespace" => $ns, "{$pfx}_title" => $dbkey );
 166                                 }
 167                                 $subjoin = "rc_cur_id = {$pfx}_from";
 168                         } else {
 169                                 // find changes to pages linked from this page
 170                                 $subconds = array( "{$pfx}_from" => $id );
 171                                 if( $link_table == 'imagelinks' || $link_table == 'categorylinks' ) {
 172                                         $subconds["rc_namespace"] = $link_ns;
 173                                         $subjoin = "rc_title = {$pfx}_to";
 174                                 } else {
 175                                         $subjoin = "rc_namespace = {$pfx}_namespace AND rc_title = {$pfx}_title";
 176                                 }
 177                         }
 178
 179                         if( $dbr->unionSupportsOrderAndLimit()) {
 180                                 $order = array( 'ORDER BY' => 'rc_timestamp DESC' );
 181                         } else {
 182                                 $order = array();
 183                         }
 184
 185                         $query = $dbr->selectSQLText(
 186                                 array_merge( $tables, array( $link_table ) ),
 187                                 $select,
 188                                 $conds + $subconds,
 189                                 __METHOD__,
 190                                 $order + $query_options,
 191                                 $join_conds + array( $link_table => array( 'INNER JOIN', $subjoin ) )
 192                         );
 193
 194                         if( $dbr->unionSupportsOrderAndLimit())
 195                                 $query = $dbr->limitResult( $query, $limit );
 196
 197                         $subsql[] = $query;
 198                 }
 199
 200                 if( count($subsql) == 0 ) {
 201                         return false; // should never happen
 202                 }
 203                 if( count($subsql) == 1 && $dbr->unionSupportsOrderAndLimit() ) {
 204                         $sql = $subsql[0];
 205                 } else {
 206                         // need to resort and relimit after union
 207                         $sql = $dbr->unionQueries($subsql, false).' ORDER BY rc_timestamp DESC';
 208                         $sql = $dbr->limitResult($sql, $limit, false);
 209                 }
 210
 211                 $res = $dbr->query( $sql, __METHOD__ );
 212
 213                 if( $res->numRows() == 0 ) {
 214                         $this->mResultEmpty = true;
 215                 }
 216
 217                 return $res;
 218         }
 219
 220         /**
 221          * @param $opts FormOptions
 222          * @return array
 223          */
 224         function getExtraOptions( $opts ){
 225                 $opts->consumeValues( array( 'showlinkedto', 'target', 'tagfilter' ) );
 226                 $extraOpts = array();
 227                 $extraOpts['namespace'] = $this->namespaceFilterForm( $opts );
 228                 $extraOpts['target'] = array( $this->msg( 'recentchangeslinked-page' )->escaped(),
 229                         Xml::input( 'target', 40, str_replace('_',' ',$opts['target']) ) .
 230                         Xml::check( 'showlinkedto', $opts['showlinkedto'], array('id' => 'showlinkedto') ) . ' ' .
 231                         Xml::label( $this->msg( 'recentchangeslinked-to' )->text(), 'showlinkedto' ) );
 232                 $tagFilter = ChangeTags::buildTagFilterSelector( $opts['tagfilter'] );
 233                 if ($tagFilter) {
 234                         $extraOpts['tagfilter'] = $tagFilter;
 235                 }
 236                 return $extraOpts;
 237         }
 238
 239         /**
 240          * @return Title
 241          */
 242         function getTargetTitle() {
 243                 if ( $this->rclTargetTitle === null ) {
 244                         $opts = $this->getOptions();
 245                         if ( isset( $opts['target'] ) && $opts['target'] !== '' ) {
 246                                 $this->rclTargetTitle = Title::newFromText( $opts['target'] );
 247                         } else {
 248                                 $this->rclTargetTitle = false;
 249                         }
 250                 }
 251                 return $this->rclTargetTitle;
 252         }
 253
 254         function setTopText( FormOptions $opts ) {
 255                 $target = $this->getTargetTitle();
 256                 if( $target ) {
 257                         $this->getOutput()->addBacklinkSubtitle( $target );
 258                 }
 259         }
 260
 261         public function getFeedQuery() {
 262                 $target = $this->getTargetTitle();
 263                 if( $target ) {
 264                         return "target=" . urlencode( $target->getPrefixedDBkey() );
 265                 } else {
 266                         return false;
 267                 }
 268         }
 269
 270         function setBottomText( FormOptions $opts ) {
 271                 if( isset( $this->mResultEmpty ) && $this->mResultEmpty ) {
 272                         $this->getOutput()->addWikiMsg( 'recentchangeslinked-noresult' );
 273                 }
 274         }
 275 }