4 * Class containing static functions for working with
5 * logs of patrol events
7 * @author Rob Church <robchur@gmail.com>
12 * Record a log event for a change being patrolled
14 * @param $rc Mixed: change identifier or RecentChange object
15 * @param $auto Boolean: was this patrol event automatic?
19 public static function record( $rc, $auto = false ) {
20 if( !( $rc instanceof RecentChange
) ) {
21 $rc = RecentChange
::newFromId( $rc );
22 if( !is_object( $rc ) )
25 $title = Title
::makeTitleSafe( $rc->getAttribute( 'rc_namespace' ), $rc->getAttribute( 'rc_title' ) );
26 if( is_object( $title ) ) {
27 $params = self
::buildParams( $rc, $auto );
28 $log = new LogPage( 'patrol', false, $auto ?
"skipUDP" : "UDP" ); # False suppresses RC entries
29 $log->addEntry( 'patrol', $title, '', $params );
36 * Generate the log action text corresponding to a patrol log item
38 * @param $title Title of the page that was patrolled
39 * @param $params Array: log parameters (from logging.log_params)
40 * @param $lang Language object to use, or false
43 public static function makeActionText( $title, $params, $lang ) {
44 list( $cur, /* $prev */, $auto ) = $params;
45 if( is_object( $lang ) ) {
46 # Standard link to the page in question
47 $link = Linker
::link( $title );
48 if( $title->exists() ) {
49 # Generate a diff link
57 htmlspecialchars( wfMsg( 'patrol-log-diff', $lang->formatNum( $cur, true ) ) ),
60 array( 'known', 'noclasses' )
63 # Don't bother with a diff link, it's useless
64 $diff = htmlspecialchars( wfMsg( 'patrol-log-diff', $cur ) );
66 # Indicate whether or not the patrolling was automatic
67 $auto = $auto ?
wfMsgHtml( 'patrol-log-auto' ) : '';
69 return wfMsgHtml( 'patrol-log-line', $diff, $link, $auto );
71 $text = $title->getPrefixedText();
72 $diff = htmlspecialchars( wfMsgForContent( 'patrol-log-diff', $cur ) );
73 return wfMsgForContent( 'patrol-log-line', $diff, "[[$text]]", '' );
78 * Prepare log parameters for a patrolled change
80 * @param $change RecentChange to represent
81 * @param $auto Boolean: whether the patrol event was automatic
84 private static function buildParams( $change, $auto ) {
86 $change->getAttribute( 'rc_this_oldid' ),
87 $change->getAttribute( 'rc_last_oldid' ),