MediaWiki  1.30.0
RCCacheEntryFactory.php
Go to the documentation of this file.
1 <?php
23 
25 
26  /* @var IContextSource */
27  private $context;
28 
29  /* @var string[] */
30  private $messages;
31 
35  private $linkRenderer;
36 
42  public function __construct(
44  ) {
45  $this->context = $context;
46  $this->messages = $messages;
47  $this->linkRenderer = $linkRenderer;
48  }
49 
56  public function newFromRecentChange( RecentChange $baseRC, $watched ) {
57  $user = $this->context->getUser();
58  $counter = $baseRC->counter;
59 
60  $cacheEntry = RCCacheEntry::newFromParent( $baseRC );
61 
62  // Should patrol-related stuff be shown?
63  $cacheEntry->unpatrolled = ChangesList::isUnpatrolled( $baseRC, $user );
64 
65  $cacheEntry->watched = $cacheEntry->mAttribs['rc_type'] == RC_LOG ? false : $watched;
66  $cacheEntry->numberofWatchingusers = $baseRC->numberofWatchingusers;
67 
68  $cacheEntry->link = $this->buildCLink( $cacheEntry );
69  $cacheEntry->timestamp = $this->buildTimestamp( $cacheEntry );
70 
71  // Make "cur" and "diff" links. Do not use link(), it is too slow if
72  // called too many times (50% of CPU time on RecentChanges!).
73  $showDiffLinks = $this->showDiffLinks( $cacheEntry, $user );
74 
75  $cacheEntry->difflink = $this->buildDiffLink( $cacheEntry, $showDiffLinks, $counter );
76  $cacheEntry->curlink = $this->buildCurLink( $cacheEntry, $showDiffLinks, $counter );
77  $cacheEntry->lastlink = $this->buildLastLink( $cacheEntry, $showDiffLinks );
78 
79  // Make user links
80  $cacheEntry->userlink = $this->getUserLink( $cacheEntry );
81 
82  if ( !ChangesList::isDeleted( $cacheEntry, Revision::DELETED_USER ) ) {
83  $cacheEntry->usertalklink = Linker::userToolLinks(
84  $cacheEntry->mAttribs['rc_user'],
85  $cacheEntry->mAttribs['rc_user_text']
86  );
87  }
88 
89  return $cacheEntry;
90  }
91 
98  private function showDiffLinks( RecentChange $cacheEntry, User $user ) {
99  return ChangesList::userCan( $cacheEntry, Revision::DELETED_TEXT, $user );
100  }
101 
107  private function buildCLink( RecentChange $cacheEntry ) {
108  $type = $cacheEntry->mAttribs['rc_type'];
109 
110  // New unpatrolled pages
111  if ( $cacheEntry->unpatrolled && $type == RC_NEW ) {
112  $clink = $this->linkRenderer->makeKnownLink( $cacheEntry->getTitle() );
113  // Log entries
114  } elseif ( $type == RC_LOG ) {
115  $logType = $cacheEntry->mAttribs['rc_log_type'];
116 
117  if ( $logType ) {
118  $clink = $this->getLogLink( $logType );
119  } else {
120  wfDebugLog( 'recentchanges', 'Unexpected log entry with no log type in recent changes' );
121  $clink = $this->linkRenderer->makeLink( $cacheEntry->getTitle() );
122  }
123  // Log entries (old format) and special pages
124  } elseif ( $cacheEntry->mAttribs['rc_namespace'] == NS_SPECIAL ) {
125  wfDebugLog( 'recentchanges', 'Unexpected special page in recentchanges' );
126  $clink = '';
127  // Edits
128  } else {
129  $clink = $this->linkRenderer->makeKnownLink( $cacheEntry->getTitle() );
130  }
131 
132  return $clink;
133  }
134 
135  private function getLogLink( $logType ) {
136  $logtitle = SpecialPage::getTitleFor( 'Log', $logType );
137  $logpage = new LogPage( $logType );
138  $logname = $logpage->getName()->text();
139 
140  $logLink = $this->context->msg( 'parentheses' )
141  ->rawParams(
142  $this->linkRenderer->makeKnownLink( $logtitle, $logname )
143  )->escaped();
144 
145  return $logLink;
146  }
147 
153  private function buildTimestamp( RecentChange $cacheEntry ) {
154  return $this->context->getLanguage()->userTime(
155  $cacheEntry->mAttribs['rc_timestamp'],
156  $this->context->getUser()
157  );
158  }
159 
165  private function buildCurQueryParams( RecentChange $recentChange ) {
166  return [
167  'curid' => $recentChange->mAttribs['rc_cur_id'],
168  'diff' => 0,
169  'oldid' => $recentChange->mAttribs['rc_this_oldid']
170  ];
171  }
172 
180  private function buildCurLink( RecentChange $cacheEntry, $showDiffLinks, $counter ) {
181  $queryParams = $this->buildCurQueryParams( $cacheEntry );
182  $curMessage = $this->getMessage( 'cur' );
183  $logTypes = [ RC_LOG ];
184 
185  if ( !$showDiffLinks || in_array( $cacheEntry->mAttribs['rc_type'], $logTypes ) ) {
186  $curLink = $curMessage;
187  } else {
188  $curUrl = htmlspecialchars( $cacheEntry->getTitle()->getLinkURL( $queryParams ) );
189  $curLink = "<a class=\"mw-changeslist-diff-cur\" href=\"$curUrl\">$curMessage</a>";
190  }
191 
192  return $curLink;
193  }
194 
200  private function buildDiffQueryParams( RecentChange $recentChange ) {
201  return [
202  'curid' => $recentChange->mAttribs['rc_cur_id'],
203  'diff' => $recentChange->mAttribs['rc_this_oldid'],
204  'oldid' => $recentChange->mAttribs['rc_last_oldid']
205  ];
206  }
207 
215  private function buildDiffLink( RecentChange $cacheEntry, $showDiffLinks, $counter ) {
216  $queryParams = $this->buildDiffQueryParams( $cacheEntry );
217  $diffMessage = $this->getMessage( 'diff' );
218  $logTypes = [ RC_NEW, RC_LOG ];
219 
220  if ( !$showDiffLinks ) {
221  $diffLink = $diffMessage;
222  } elseif ( in_array( $cacheEntry->mAttribs['rc_type'], $logTypes ) ) {
223  $diffLink = $diffMessage;
224  } elseif ( $cacheEntry->getAttribute( 'rc_type' ) == RC_CATEGORIZE ) {
225  $rcCurId = $cacheEntry->getAttribute( 'rc_cur_id' );
226  $pageTitle = Title::newFromID( $rcCurId );
227  if ( $pageTitle === null ) {
228  wfDebugLog( 'RCCacheEntryFactory', 'Could not get Title for rc_cur_id: ' . $rcCurId );
229  return $diffMessage;
230  }
231  $diffUrl = htmlspecialchars( $pageTitle->getLinkURL( $queryParams ) );
232  $diffLink = "<a class=\"mw-changeslist-diff\" href=\"$diffUrl\">$diffMessage</a>";
233  } else {
234  $diffUrl = htmlspecialchars( $cacheEntry->getTitle()->getLinkURL( $queryParams ) );
235  $diffLink = "<a class=\"mw-changeslist-diff\" href=\"$diffUrl\">$diffMessage</a>";
236  }
237 
238  return $diffLink;
239  }
240 
249  private function buildLastLink( RecentChange $cacheEntry, $showDiffLinks ) {
250  $lastOldid = $cacheEntry->mAttribs['rc_last_oldid'];
251  $lastMessage = $this->getMessage( 'last' );
252  $type = $cacheEntry->mAttribs['rc_type'];
253  $logTypes = [ RC_LOG ];
254 
255  // Make "last" link
256  if ( !$showDiffLinks || !$lastOldid || in_array( $type, $logTypes ) ) {
257  $lastLink = $lastMessage;
258  } else {
259  $lastLink = $this->linkRenderer->makeKnownLink(
260  $cacheEntry->getTitle(),
261  new HtmlArmor( $lastMessage ),
262  [ 'class' => 'mw-changeslist-diff' ],
263  $this->buildDiffQueryParams( $cacheEntry )
264  );
265  }
266 
267  return $lastLink;
268  }
269 
275  private function getUserLink( RecentChange $cacheEntry ) {
276  if ( ChangesList::isDeleted( $cacheEntry, Revision::DELETED_USER ) ) {
277  $userLink = ' <span class="history-deleted">' .
278  $this->context->msg( 'rev-deleted-user' )->escaped() . '</span>';
279  } else {
280  $userLink = Linker::userLink(
281  $cacheEntry->mAttribs['rc_user'],
282  $cacheEntry->mAttribs['rc_user_text']
283  );
284  }
285 
286  return $userLink;
287  }
288 
294  private function getMessage( $key ) {
295  return $this->messages[$key];
296  }
297 
298 }
Revision\DELETED_USER
const DELETED_USER
Definition: Revision.php:92
RCCacheEntryFactory\showDiffLinks
showDiffLinks(RecentChange $cacheEntry, User $user)
Definition: RCCacheEntryFactory.php:98
$user
please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a account $user
Definition: hooks.txt:244
RCCacheEntryFactory\$context
$context
Definition: RCCacheEntryFactory.php:27
HtmlArmor
Marks HTML that shouldn't be escaped.
Definition: HtmlArmor.php:28
false
processing should stop and the error should be shown to the user * false
Definition: hooks.txt:187
Linker\userLink
static userLink( $userId, $userName, $altUserName=false)
Make user link (or user contributions for unregistered users)
Definition: Linker.php:893
RecentChange
Utility class for creating new RC entries.
Definition: RecentChange.php:67
MediaWiki\Linker\LinkRenderer
Class that generates HTML links for pages.
Definition: LinkRenderer.php:42
RC_LOG
const RC_LOG
Definition: Defines.php:145
use
as see the revision history and available at free of to any person obtaining a copy of this software and associated documentation to deal in the Software without including without limitation the rights to use
Definition: MIT-LICENSE.txt:10
SpecialPage\getTitleFor
static getTitleFor( $name, $subpage=false, $fragment='')
Get a localised Title object for a specified special page name If you don't need a full Title object,...
Definition: SpecialPage.php:82
RCCacheEntryFactory
Definition: RCCacheEntryFactory.php:24
RCCacheEntryFactory\getLogLink
getLogLink( $logType)
Definition: RCCacheEntryFactory.php:135
wfDebugLog
wfDebugLog( $logGroup, $text, $dest='all', array $context=[])
Send a line to a supplementary debug log file, if configured, or main debug log if not.
Definition: GlobalFunctions.php:1140
ChangesList\isDeleted
static isDeleted( $rc, $field)
Determine if said field of a revision is hidden.
Definition: ChangesList.php:593
php
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring php
Definition: injection.txt:35
RCCacheEntryFactory\buildDiffQueryParams
buildDiffQueryParams(RecentChange $recentChange)
Definition: RCCacheEntryFactory.php:200
NS_SPECIAL
const NS_SPECIAL
Definition: Defines.php:54
RCCacheEntry\newFromParent
static newFromParent( $rc)
Definition: RCCacheEntry.php:38
RCCacheEntryFactory\buildCLink
buildCLink(RecentChange $cacheEntry)
Definition: RCCacheEntryFactory.php:107
LogPage
Class to simplify the use of log pages.
Definition: LogPage.php:31
RCCacheEntryFactory\getUserLink
getUserLink(RecentChange $cacheEntry)
Definition: RCCacheEntryFactory.php:275
RCCacheEntryFactory\__construct
__construct(IContextSource $context, $messages, LinkRenderer $linkRenderer)
Definition: RCCacheEntryFactory.php:42
RCCacheEntryFactory\buildCurLink
buildCurLink(RecentChange $cacheEntry, $showDiffLinks, $counter)
Definition: RCCacheEntryFactory.php:180
RCCacheEntryFactory\buildDiffLink
buildDiffLink(RecentChange $cacheEntry, $showDiffLinks, $counter)
Definition: RCCacheEntryFactory.php:215
Linker\userToolLinks
static userToolLinks( $userId, $userText, $redContribsWhenNoEdits=false, $flags=0, $edits=null)
Generate standard user tool links (talk, contributions, block link, etc.)
Definition: Linker.php:926
RCCacheEntryFactory\buildTimestamp
buildTimestamp(RecentChange $cacheEntry)
Definition: RCCacheEntryFactory.php:153
RC_NEW
const RC_NEW
Definition: Defines.php:144
RCCacheEntryFactory\$messages
$messages
Definition: RCCacheEntryFactory.php:30
IContextSource
Interface for objects which can provide a MediaWiki context on request.
Definition: IContextSource.php:55
RCCacheEntryFactory\$linkRenderer
LinkRenderer $linkRenderer
Definition: RCCacheEntryFactory.php:35
RecentChange\getAttribute
getAttribute( $name)
Get an attribute value.
Definition: RecentChange.php:967
RCCacheEntryFactory\buildCurQueryParams
buildCurQueryParams(RecentChange $recentChange)
Definition: RCCacheEntryFactory.php:165
messages
passed in as a query string parameter to the various URLs constructed here(i.e. $prevlink) $ldel you ll need to handle error messages
Definition: hooks.txt:1265
RCCacheEntryFactory\newFromRecentChange
newFromRecentChange(RecentChange $baseRC, $watched)
Definition: RCCacheEntryFactory.php:56
RC_CATEGORIZE
const RC_CATEGORIZE
Definition: Defines.php:147
ChangesList\isUnpatrolled
static isUnpatrolled( $rc, User $user)
Definition: ChangesList.php:709
RecentChange\getTitle
& getTitle()
Definition: RecentChange.php:257
User
The User object encapsulates all of the user-specific settings (user_id, name, rights,...
Definition: User.php:51
Title\newFromID
static newFromID( $id, $flags=0)
Create a new Title from an article ID.
Definition: Title.php:411
RCCacheEntryFactory\buildLastLink
buildLastLink(RecentChange $cacheEntry, $showDiffLinks)
Builds the link to the previous version.
Definition: RCCacheEntryFactory.php:249
Revision\DELETED_TEXT
const DELETED_TEXT
Definition: Revision.php:90
ChangesList\userCan
static userCan( $rc, $field, User $user=null)
Determine if the current user is allowed to view a particular field of this revision,...
Definition: ChangesList.php:605
RCCacheEntryFactory\getMessage
getMessage( $key)
Definition: RCCacheEntryFactory.php:294
$type
$type
Definition: testCompression.php:48