MediaWiki  master
OldChangesList.php
Go to the documentation of this file.
1 <?php
28 
29 class OldChangesList extends ChangesList {
30 
41  public function recentChangesLine( &$rc, $watched = false, $linenumber = null ) {
42  $classes = $this->getHTMLClasses( $rc, $watched );
43  // use mw-line-even/mw-line-odd class only if linenumber is given (feature from T16468)
44  if ( $linenumber ) {
45  if ( $linenumber & 1 ) {
46  $classes[] = 'mw-line-odd';
47  } else {
48  $classes[] = 'mw-line-even';
49  }
50  }
51 
52  $html = $this->formatChangeLine( $rc, $classes, $watched );
53 
54  if ( $this->watchlist ) {
55  $classes[] = Sanitizer::escapeClass( 'watchlist-' .
56  $rc->mAttribs['rc_namespace'] . '-' . $rc->mAttribs['rc_title'] );
57  }
58 
59  $attribs = $this->getDataAttributes( $rc );
60 
61  if ( !$this->getHookRunner()->onOldChangesListRecentChangesLine(
62  $this, $html, $rc, $classes, $attribs )
63  ) {
64  return false;
65  }
66  $attribs = array_filter( $attribs,
67  [ Sanitizer::class, 'isReservedDataAttribute' ],
68  ARRAY_FILTER_USE_KEY
69  );
70 
71  $dateheader = ''; // $html now contains only <li>...</li>, for hooks' convenience.
72  $this->insertDateHeader( $dateheader, $rc->mAttribs['rc_timestamp'] );
73 
74  $html = $this->getHighlightsContainerDiv() . $html;
75  $attribs['class'] = $classes;
76 
77  return $dateheader . Html::rawElement( 'li', $attribs, $html ) . "\n";
78  }
79 
87  private function formatChangeLine( RecentChange $rc, array &$classes, $watched ) {
88  $html = '';
89  $unpatrolled = $this->showAsUnpatrolled( $rc );
90 
91  if ( $rc->mAttribs['rc_log_type'] ) {
92  $logtitle = SpecialPage::getTitleFor( 'Log', $rc->mAttribs['rc_log_type'] );
93  $this->insertLog( $html, $logtitle, $rc->mAttribs['rc_log_type'], false );
94  $flags = $this->recentChangesFlags( [ 'unpatrolled' => $unpatrolled,
95  'bot' => $rc->mAttribs['rc_bot'] ], '' );
96  if ( $flags !== '' ) {
97  $html .= ' ' . $flags;
98  }
99  // Log entries (old format) or log targets, and special pages
100  } elseif ( $rc->mAttribs['rc_namespace'] == NS_SPECIAL ) {
101  [ $name, $htmlubpage ] = MediaWikiServices::getInstance()->getSpecialPageFactory()->
102  resolveAlias( $rc->mAttribs['rc_title'] );
103  if ( $name == 'Log' ) {
104  $this->insertLog( $html, $rc->getTitle(), $htmlubpage, false );
105  }
106  // Regular entries
107  } else {
108  $this->insertDiffHist( $html, $rc );
109  # M, N, b and ! (minor, new, bot and unpatrolled)
110  $html .= $this->recentChangesFlags(
111  [
112  'newpage' => $rc->mAttribs['rc_type'] == RC_NEW,
113  'minor' => $rc->mAttribs['rc_minor'],
114  'unpatrolled' => $unpatrolled,
115  'bot' => $rc->mAttribs['rc_bot']
116  ],
117  ''
118  );
119  $html .= $this->getArticleLink( $rc, $unpatrolled, $watched );
120  }
121  # Edit/log timestamp
122  $this->insertTimestamp( $html, $rc );
123  # Bytes added or removed
124  if ( $this->getConfig()->get( MainConfigNames::RCShowChangedSize ) ) {
125  $cd = $this->formatCharacterDifference( $rc );
126  if ( $cd !== '' ) {
127  $html .= $cd . ' <span class="mw-changeslist-separator"></span> ';
128  }
129  }
130 
131  if ( $rc->mAttribs['rc_type'] == RC_LOG ) {
132  $html .= $this->insertLogEntry( $rc );
133  } elseif ( $this->isCategorizationWithoutRevision( $rc ) ) {
134  $html .= $this->insertComment( $rc );
135  } else {
136  # User tool links
137  $this->insertUserRelatedLinks( $html, $rc );
138  # LTR/RTL direction mark
139  $html .= $this->getLanguage()->getDirMark();
140  $html .= $this->insertComment( $rc );
141  }
142 
143  # Tags
144  $this->insertTags( $html, $rc, $classes );
145  # Rollback
146  $this->insertRollback( $html, $rc );
147  # For subclasses
148  $this->insertExtra( $html, $rc, $classes );
149 
150  # How many users watch this page
151  if ( $rc->numberofWatchingusers > 0 ) {
152  $html .= ' ' . $this->numberofWatchingusers( $rc->numberofWatchingusers );
153  }
154 
155  $html = Html::rawElement( 'span', [
156  'class' => 'mw-changeslist-line-inner',
157  'data-target-page' => $rc->getTitle(), // Used for reliable determination of the affiliated page
158  ], $html );
159  if ( is_callable( $this->changeLinePrefixer ) ) {
160  $prefix = call_user_func( $this->changeLinePrefixer, $rc, $this, false );
161  $html = Html::rawElement( 'span', [ 'class' => 'mw-changeslist-line-prefix' ], $prefix ) . $html;
162  }
163 
164  return $html;
165  }
166 }
const RC_NEW
Definition: Defines.php:117
const NS_SPECIAL
Definition: Defines.php:53
const RC_LOG
Definition: Defines.php:118
formatCharacterDifference(RecentChange $old, RecentChange $new=null)
Format the character difference of one or several changes.
insertDateHeader(&$s, $rc_timestamp)
insertRollback(&$s, &$rc)
Insert a rollback link.
showAsUnpatrolled(RecentChange $rc)
getHighlightsContainerDiv()
Get the container for highlights that are used in the new StructuredFilters system.
recentChangesFlags( $flags, $nothing="\u{00A0}")
Returns the appropriate flags for new page, minor change and patrolling.
getDataAttributes(RecentChange $rc)
Get recommended data attributes for a change line.
numberofWatchingusers( $count)
Returns the string which indicates the number of watching users.
getHTMLClasses( $rc, $watched)
Get an array of default HTML class attributes for the change.
getArticleLink(&$rc, $unpatrolled, $watched)
Get the HTML link to the changed page, possibly with a prefix from hook handlers, and a suffix for te...
insertUserRelatedLinks(&$s, &$rc)
Insert links to user page, user talk page and eventually a blocking link.
insertLogEntry( $rc)
Insert a formatted action.
insertLog(&$s, $title, $logtype, $useParentheses=true)
insertTags(&$s, &$rc, &$classes)
insertComment( $rc)
Insert a formatted comment.
insertExtra(&$s, &$rc, &$classes)
isCategorizationWithoutRevision( $rcObj)
Determines whether a revision is linked to this change; this may not be the case when the categorizat...
insertDiffHist(&$s, &$rc, $unpatrolled=null)
insertTimestamp(&$s, $rc)
Insert time timestamp string from $rc into $s.
This class is a collection of static functions that serve two purposes:
Definition: Html.php:57
A class containing constants representing the names of configuration variables.
Service locator for MediaWiki core services.
HTML sanitizer for MediaWiki.
Definition: Sanitizer.php:46
Parent class for all special pages.
Definition: SpecialPage.php:65
recentChangesLine(&$rc, $watched=false, $linenumber=null)
Format a line using the old system (aka without any javascript).
Utility class for creating new RC entries.