MediaWiki  1.23.0
LogEventsList Class Reference
Inheritance diagram for LogEventsList:
Collaboration diagram for LogEventsList:

Public Member Functions

 __construct ( $context, $unused=null, $flags=0)
 Constructor. More...
 
 beginLogEventsList ()
 
 endLogEventsList ()
 
 getDisplayTitle ()
 Deprecated alias for getTitle(); do not use. More...
 
 getTypeSelector ()
 Returns log page selector. More...
 
 logLine ( $row)
 
 showHeader ( $type)
 Set page title and show header for this log type. More...
 
 showOptions ( $types=array(), $user='', $page='', $pattern='', $year=0, $month=0, $filter=null, $tagFilter='')
 Show options for the log list. More...
 
- Public Member Functions inherited from ContextSource
 canUseWikiPage ()
 Check whether a WikiPage object can be get with getWikiPage(). More...
 
 exportSession ()
 Export the resolved user IP, HTTP headers, user ID, and session ID. More...
 
 getConfig ()
 Get the Config object. More...
 
 getContext ()
 Get the RequestContext object. More...
 
 getLang ()
 Get the Language object. More...
 
 getLanguage ()
 Get the Language object. More...
 
 getOutput ()
 Get the OutputPage object. More...
 
 getRequest ()
 Get the WebRequest object. More...
 
 getSkin ()
 Get the Skin object. More...
 
 getTitle ()
 Get the Title object. More...
 
 getUser ()
 Get the User object. More...
 
 getWikiPage ()
 Get the WikiPage object. More...
 
 msg ()
 Get a Message object with context set Parameters are the same as wfMessage() More...
 
 setContext (IContextSource $context)
 Set the IContextSource object. More...
 

Static Public Member Functions

static getExcludeClause ( $db, $audience='public', User $user=null)
 SQL clause to skip forbidden log types for this user. More...
 
static isDeleted ( $row, $field)
 
static showLogExtract (&$out, $types=array(), $page='', $user='', $param=array())
 Show log extract. More...
 
static typeAction ( $row, $type, $action, $right='')
 
static userCan ( $row, $field, User $user=null)
 Determine if the current user is allowed to view a particular field of this log row, if it's marked as deleted. More...
 
static userCanBitfield ( $bitfield, $field, User $user=null)
 Determine if the current user is allowed to view a particular field of this log row, if it's marked as deleted. More...
 

Public Attributes

 $flags
 
const NO_ACTION_LINK = 1
 
const NO_EXTRA_USER_LINKS = 2
 
const USE_REVDEL_CHECKBOXES = 4
 

Protected Attributes

Array $mDefaultQuery
 

Private Member Functions

 getDefaultQuery ()
 
 getExtraInputs ( $types)
 
 getFilterLinks ( $filter)
 
 getShowHideLinks ( $row)
 
 getTitleInput ( $title)
 
 getTitlePattern ( $pattern)
 
 getTypeMenu ( $queryTypes)
 
 getUserInput ( $user)
 

Detailed Description

Definition at line 26 of file LogEventsList.php.

Constructor & Destructor Documentation

◆ __construct()

LogEventsList::__construct (   $context,
  $unused = null,
  $flags = 0 
)

Constructor.

The first two parameters used to be $skin and $out, but now only a context is needed, that's why there's a second unused parameter.

Parameters
IContextSource | Skin$contextContext to use; formerly it was a Skin object. Use of Skin is deprecated.
null$unusedUnused; used to be an OutputPage object.
int$flagsCan be a combination of self::NO_ACTION_LINK, self::NO_EXTRA_USER_LINKS or self::USE_REVDEL_CHECKBOXES.

Definition at line 48 of file LogEventsList.php.

References ContextSource\$context, $flags, flags, and ContextSource\setContext().

Member Function Documentation

◆ beginLogEventsList()

LogEventsList::beginLogEventsList ( )
Returns
string

Definition at line 308 of file LogEventsList.php.

◆ endLogEventsList()

LogEventsList::endLogEventsList ( )
Returns
string

Definition at line 315 of file LogEventsList.php.

◆ getDefaultQuery()

LogEventsList::getDefaultQuery ( )
private

Definition at line 186 of file LogEventsList.php.

References $mDefaultQuery, and ContextSource\getRequest().

Referenced by getFilterLinks().

◆ getDisplayTitle()

LogEventsList::getDisplayTitle ( )

Deprecated alias for getTitle(); do not use.

Deprecated:
in 1.20; use getTitle() instead.
Returns
Title

Definition at line 65 of file LogEventsList.php.

References ContextSource\getTitle(), and wfDeprecated().

◆ getExcludeClause()

static LogEventsList::getExcludeClause (   $db,
  $audience = 'public',
User  $user = null 
)
static

SQL clause to skip forbidden log types for this user.

Parameters
DatabaseBase$db
string$audiencePublic/user
User$userUser to check, or null to use $wgUser
Returns
string|bool String on success, false on failure.

Definition at line 651 of file LogEventsList.php.

References $right, $user, $wgUser, array(), as, and global.

Referenced by WikiExporter\dumpFrom(), ApiQueryLogEvents\execute(), ApiQueryLogEvents\getCacheMode(), and LogPager\limitType().

◆ getExtraInputs()

LogEventsList::getExtraInputs (   $types)
private
Parameters
array$types
Returns
string

Definition at line 291 of file LogEventsList.php.

References $user, ContextSource\getRequest(), Xml\inputLabel(), IP\isIPAddress(), ContextSource\msg(), User\newFromName(), and text.

Referenced by showOptions().

◆ getFilterLinks()

LogEventsList::getFilterLinks (   $filter)
private
Parameters
array$filter
Returns
string Formatted HTML

Definition at line 155 of file LogEventsList.php.

References $link, $messages, $query, $type, array(), as, getDefaultQuery(), ContextSource\getLanguage(), ContextSource\getTitle(), Html\hidden(), Linker\linkKnown(), and ContextSource\msg().

Referenced by showOptions().

◆ getShowHideLinks()

LogEventsList::getShowHideLinks (   $row)
private

◆ getTitleInput()

LogEventsList::getTitleInput (   $title)
private
Parameters
string$title
Returns
string Formatted HTML

Definition at line 265 of file LogEventsList.php.

References $title, Xml\inputLabel(), ContextSource\msg(), and text.

Referenced by showOptions().

◆ getTitlePattern()

LogEventsList::getTitlePattern (   $pattern)
private
Parameters
$pattern
Returns
string Checkbox

Definition at line 281 of file LogEventsList.php.

References Xml\checkLabel(), ContextSource\msg(), and text.

Referenced by showOptions().

◆ getTypeMenu()

LogEventsList::getTypeMenu (   $queryTypes)
private
Parameters
array$queryTypes
Returns
string Formatted HTML

Definition at line 205 of file LogEventsList.php.

References $selector, and getTypeSelector().

Referenced by showOptions().

◆ getTypeSelector()

LogEventsList::getTypeSelector ( )

Returns log page selector.

Returns
XmlSelect
Since
1.19

Definition at line 218 of file LogEventsList.php.

References $name, $type, array(), as, ContextSource\getUser(), and LogPage\validTypes().

Referenced by getTypeMenu().

◆ getUserInput()

LogEventsList::getUserInput (   $user)
private
Parameters
string$user
Returns
string Formatted HTML

Definition at line 249 of file LogEventsList.php.

References $user, Xml\inputLabel(), ContextSource\msg(), and text.

Referenced by showOptions().

◆ isDeleted()

static LogEventsList::isDeleted (   $row,
  $field 
)
static
Parameters
stdClass$rowRow
int$fieldOne of DELETED_* bitfield constants
Returns
bool

Definition at line 480 of file LogEventsList.php.

Referenced by ApiQueryLogEvents\extractRowInfo(), ProtectedPagesPager\formatValue(), and RevDel_LogItem\getHTML().

◆ logLine()

LogEventsList::logLine (   $row)
Parameters
stdClass$rowA single row from the result set
Returns
string Formatted HTML list item

Definition at line 323 of file LogEventsList.php.

References $comment, $revert, $time, array(), flags, ChangeTags\formatSummaryRow(), ContextSource\getContext(), ContextSource\getLanguage(), getShowHideLinks(), ContextSource\getUser(), list, LogFormatter\newFromEntry(), DatabaseLogEntry\newFromRow(), and Html\rawElement().

◆ showHeader()

LogEventsList::showHeader (   $type)

Set page title and show header for this log type.

Parameters
array$type
Deprecated:
in 1.19

Definition at line 75 of file LogEventsList.php.

References $out, $type, ContextSource\getOutput(), LogPage\isLogType(), ContextSource\msg(), and wfDeprecated().

◆ showLogExtract()

static LogEventsList::showLogExtract ( $out,
  $types = array(),
  $page = '',
  $user = '',
  $param = array() 
)
static

Show log extract.

Either with text and a box (set $msgKey) or without (don't set $msgKey)

Parameters
OutputPage | string$outBy-reference
string | array$typesLog types to show
string | Title$pageThe page title to show log entries for
string$userThe user who made the log entries
array$paramAssociative Array with the following additional options:
  • lim Integer Limit of items to show, default is 50
  • conds Array Extra conditions for the query (e.g. "log_action != 'revision'")
  • showIfEmpty boolean Set to false if you don't want any output in case the loglist is empty if set to true (default), "No matching items in log" is displayed if loglist is empty
  • msgKey Array If you want a nice box with a message, set this to the key of the message. First element is the message key, additional optional elements are parameters for the key that are processed with wfMessage
  • offset Set to overwrite offset parameter in WebRequest set to '' to unset offset
  • wrap String Wrap the message in html (usually something like "<div ...>$1</div>").
  • flags Integer display flags (NO_ACTION_LINK,NO_EXTRA_USER_LINKS)
  • useRequestParams boolean Set true to use Pager-related parameters in the WebRequest
  • useMaster boolean Use master DB
Returns
int Number of total log items (not limited by $lim)

Definition at line 507 of file LogEventsList.php.

References $args, ContextSource\$context, $dir, $flags, $out, $s, $user, array(), DB_MASTER, IContextSource\getLanguage(), RequestContext\getMain(), message, IContextSource\msg(), Xml\openElement(), Html\rawElement(), type, wfGetDB(), and wfRunHooks().

Referenced by Article\confirmDelete(), SpecialContributions\contributionsSub(), Article\delete(), Article\doDelete(), SpecialRevisionDelete\execute(), DeletedContributionsPage\getSubTitle(), SpecialUpload\getUploadForm(), HistoryAction\onView(), ImagePage\openShowImage(), SpecialBlock\postText(), MovePageForm\showForm(), SpecialMergeHistory\showHistory(), SpecialUndelete\showHistory(), FileDeleteForm\showLogEntries(), ProtectionForm\showLogExtract(), MovePageForm\showLogFragment(), UserrightsPage\showLogFragment(), and Article\showMissingArticle().

◆ showOptions()

LogEventsList::showOptions (   $types = array(),
  $user = '',
  $page = '',
  $pattern = '',
  $year = 0,
  $month = 0,
  $filter = null,
  $tagFilter = '' 
)

Show options for the log list.

Parameters
array | string$types
string$user
string$page
string$pattern
int$yearYear
int$monthMonth
array$filter
string$tagFilterTag to select by default

Definition at line 101 of file LogEventsList.php.

References $html, $title, $user, array(), ChangeTags\buildTagFilterSelector(), Xml\dateMenu(), Xml\fieldset(), getExtraInputs(), getFilterLinks(), ContextSource\getOutput(), SpecialPage\getTitleFor(), getTitleInput(), getTitlePattern(), getTypeMenu(), getUserInput(), global, Html\hidden(), ContextSource\msg(), Xml\submitButton(), Xml\tags(), and text.

◆ typeAction()

static LogEventsList::typeAction (   $row,
  $type,
  $action,
  $right = '' 
)
static
Parameters
stdClass$rowRow
string | array$type
string | array$action
string$right
Returns
bool

Definition at line 419 of file LogEventsList.php.

References $right, $type, $wgUser, and global.

Referenced by PopulateLogSearch\doDBUpdates().

◆ userCan()

static LogEventsList::userCan (   $row,
  $field,
User  $user = null 
)
static

Determine if the current user is allowed to view a particular field of this log row, if it's marked as deleted.

Parameters
stdClass$rowRow
int$field
User$userUser to check, or null to use $wgUser
Returns
bool

Definition at line 443 of file LogEventsList.php.

References $user, and userCanBitfield().

Referenced by RevDel_LogItem\canView(), ApiQueryLogEvents\extractRowInfo(), and RevDel_LogItem\getApiData().

◆ userCanBitfield()

static LogEventsList::userCanBitfield (   $bitfield,
  $field,
User  $user = null 
)
static

Determine if the current user is allowed to view a particular field of this log row, if it's marked as deleted.

Parameters
int$bitfieldCurrent field
int$field
User$userUser to check, or null to use $wgUser
Returns
bool

Definition at line 456 of file LogEventsList.php.

References $user, $wgUser, LogPage\DELETED_RESTRICTED, global, and wfDebug().

Referenced by LogFormatter\canView(), ApiQueryWatchlist\extractRowInfo(), ApiQueryRecentChanges\extractRowInfo(), ProtectedPagesPager\formatValue(), userCan(), and ChangesList\userCan().

Member Data Documentation

◆ $flags

LogEventsList::$flags

Definition at line 31 of file LogEventsList.php.

Referenced by __construct(), and showLogExtract().

◆ $mDefaultQuery

Array LogEventsList::$mDefaultQuery
protected

Definition at line 35 of file LogEventsList.php.

Referenced by getDefaultQuery().

◆ NO_ACTION_LINK

const LogEventsList::NO_ACTION_LINK = 1

Definition at line 27 of file LogEventsList.php.

◆ NO_EXTRA_USER_LINKS

const LogEventsList::NO_EXTRA_USER_LINKS = 2

Definition at line 28 of file LogEventsList.php.

◆ USE_REVDEL_CHECKBOXES

const LogEventsList::USE_REVDEL_CHECKBOXES = 4

Definition at line 29 of file LogEventsList.php.

Referenced by SpecialLog\show().


The documentation for this class was generated from the following file: