API:Logevents

From MediaWiki.org
Jump to: navigation, search
Tools clipart.png This page is part of the MediaWiki action API documentation.
MediaWiki APIsAPI:Main page



MediaWiki action API

v · d · e
Logevents
Prefix le
Required rights none
Post only? No
Generated help Current
Version added
≥ 1.9

Get a list of all logged events, à la Special:Log. This module cannot be used as a generator.

Parameters[edit | edit source]

  • leprop: Which properties to get. (Default: ids|title|type|user|timestamp|comment|details)
    • ids: Page ID of the page in question and log ID
    • title: Title of the page in question
    • type: Type of log entry
    • user: User responsible for the log entry
    • userid: The user ID who was responsible for the log event. When specified for account creation events, the userid of the creating user is returned. When absent, the userid returned is that of the created account (see bugzilla:71020).
    • timestamp: Time and date the log entry was created
    • comment: Log comment
    • parsedcomment: The parsed comment of the event
    • details: Extra information (not present for all log types)
    • tags: List tags for the event
  • letype: Only list log entries of this type. Note that extensions may add other log types.
    • block
    • delete
    • import
    • merge
    • move
    • newusers
    • patrol
    • protect
    • stable
    • rights
    • upload
  • leaction: Filter log actions to only this type. Overrides letype even if the action isn't related to letype. 1.17+
    • block/block
    • block/reblock
    • block/unblock
    • delete/delete
    • delete/event
    • delete/restore
    • delete/revision
    • import/interwiki
    • import/upload
    • merge/merge
    • move/move_redir
    • move/move
    • newusers/autocreate
    • newusers/create2
    • newusers/create
    • newusers/newusers
    • patrol/patrol
    • protect/modify
    • protect/move_prot
    • protect/protect
    • protect/unprotect
    • rights/autopromote
    • rights/erevoke
    • rights/rights
    • upload/overwrite
    • upload/revert
    • upload/upload
  • leuser: Only list log entries made by this user
  • letitle: Only list log entries related to this title
  • lestart: The timestamp to start listing from
  • leend: The timestamp to end listing at
  • ledir: Direction to list in. (Default: older)
    • older: List newest log entries first. Note: lestart has to be later than leend.
    • newer: List oldest log entries first. Note: lestart has to be earlier than leend.
  • lelimit: Maximum number of log entries to list No more than 500 (5000 for bots) allowed. (Default: 10)
  • leprefix: Filter entries that start with this prefix. Disabled in Miser Mode
  • letag: Only list event entries tagged with this tag

Example[edit | edit source]

List the 3 most recent page moves

api.php?action=query&list=logevents&letype=move&lelimit=3 [try in ApiSandbox]
Result 
<?xml version="1.0" encoding="utf-8"?>
<api>
  <query-continue>
    <logevents lestart="2008-03-25T21:26:37Z" />
  </query-continue>
  <query>
    <logevents>
      <item
       logid="0"
       pageid="16577509"
       ns="1"
       title="Talk:Parisii (France)"
       type="move"
       action="move"
       user="QuartierLatin1968"
       timestamp="2008-03-25T21:31:39Z"
       comment="It is wrong to use such an anachronistic name.">
        <move new_ns="1" new_title="Talk:Parisii (Gaul)" />
      </item>
      <item
       logid="0"
       pageid="16577508"
       ns="0"
       title="Parisii (France)"
       type="move"
       action="move"
       user="QuartierLatin1968"
       timestamp="2008-03-25T21:31:38Z"
       comment="It is wrong to use such an anachronistic name.">
        <move new_ns="0" new_title="Parisii (Gaul)" />
      </item>
      <item
       logid="0"
       pageid="16577421"
       ns="10"
       title="Template:User Brunei work group"
       type="move"
       action="move"
       user="Black Falcon"
       timestamp="2008-03-25T21:28:02Z"
       comment="Has become a full WikiProject">
        <move new_ns="10" new_title="Template:User WikiProject Brunei" />
      </item>
    </logevents>
  </query>
</api>

Error Codes[edit | edit source]

Code Info
leparam_user User name username not found
leparam_title Bad title value 'title'
This happens when you set letitle to an invalid title.

Notes[edit | edit source]

For autoblock unblock entries, the page title is shown as "User:$blockid". This is indeed not a User page, just the way it is stored. As per bug 17781

Child elements[edit | edit source]

Here are some examples of child elements that reveal log parameters:

Block

<block flags="nocreate" duration="3 days" expiry="2014-09-18T20:35:54Z" />

Move

<move new_ns="0" new_title="Foo" suppressredirect="" />

Patrol

<patrol cur="12" prev="0" auto="1" />

Rights

<rights new="sysop" old="" />

See also[edit | edit source]

Log actionsManual:Log actions Events: BlockingManual:Block and unblock – ImportingManual:Importing revisions – Merging historiesManual:Merging histories – Page deletionManual:Page deletion – Page movingManual:Page moving – Page restorationManual:Page restoration – PatrollingManual:Patrolling – ProtectionManual:Protection – Renaming a userExtension:Renameuser – RevisionDeleteManual:RevisionDelete – ThankingExtension:Thanks – UploadingManual:Uploading – User creationManual:User creation – User rights managementManual:User rights
Miscellaneous: APIAPI:Logevents – logging tableManual:Logging table – Null revisionManual:Null revision
Retrieved from "https://www.mediawiki.org/w/index.php?title=API:Logevents&oldid=1907924"