MediaWiki REL1_30
MarkpatrolledAction.php
Go to the documentation of this file.
1<?php
24
31
32 public function getName() {
33 return 'markpatrolled';
34 }
35
36 protected function getDescription() {
37 // Disable default header "subtitle"
38 return '';
39 }
40
41 public function getRestriction() {
42 return 'patrol';
43 }
44
45 protected function getRecentChange( $data = null ) {
46 $rc = null;
47 // Note: This works both on initial GET url and after submitting the form
48 $rcId = $data ? intval( $data['rcid'] ) : $this->getRequest()->getInt( 'rcid' );
49 if ( $rcId ) {
50 $rc = RecentChange::newFromId( $rcId );
51 }
52 if ( !$rc ) {
53 throw new ErrorPageError( 'markedaspatrollederror', 'markedaspatrollederrortext' );
54 }
55 return $rc;
56 }
57
58 protected function preText() {
59 $rc = $this->getRecentChange();
60 $title = $rc->getTitle();
61 $linkRenderer = MediaWikiServices::getInstance()->getLinkRenderer();
62
63 // Based on logentry-patrol-patrol (see PatrolLogFormatter)
64 $revId = $rc->getAttribute( 'rc_this_oldid' );
65 $query = [
66 'curid' => $rc->getAttribute( 'rc_cur_id' ),
67 'diff' => $revId,
68 'oldid' => $rc->getAttribute( 'rc_last_oldid' )
69 ];
70 $revlink = $linkRenderer->makeLink( $title, $revId, [], $query );
71 $pagelink = $linkRenderer->makeLink( $title, $title->getPrefixedText() );
72
73 return $this->msg( 'confirm-markpatrolled-top' )->params(
74 $title->getPrefixedText(),
75 // Provide pre-rendered link as parser would render [[:$1]] as bold non-link
76 Message::rawParam( $pagelink ),
77 Message::rawParam( $revlink )
78 )->parse();
79 }
80
81 protected function alterForm( HTMLForm $form ) {
82 $form->addHiddenField( 'rcid', $this->getRequest()->getInt( 'rcid' ) );
83 $form->setTokenSalt( 'patrol' );
84 $form->setSubmitTextMsg( 'confirm-markpatrolled-button' );
85 }
86
91 public function onSubmit( $data ) {
92 $user = $this->getUser();
93 $rc = $this->getRecentChange( $data );
94 $errors = $rc->doMarkPatrolled( $user );
95
96 if ( in_array( [ 'rcpatroldisabled' ], $errors ) ) {
97 throw new ErrorPageError( 'rcpatroldisabled', 'rcpatroldisabledtext' );
98 }
99
100 // Guess where the user came from
101 // TODO: Would be nice to see where the user actually came from
102 if ( $rc->getAttribute( 'rc_type' ) == RC_NEW ) {
103 $returnTo = 'Newpages';
104 } elseif ( $rc->getAttribute( 'rc_log_type' ) == 'upload' ) {
105 $returnTo = 'Newfiles';
106 } else {
107 $returnTo = 'Recentchanges';
108 }
109 $return = SpecialPage::getTitleFor( $returnTo );
110
111 if ( in_array( [ 'markedaspatrollederror-noautopatrol' ], $errors ) ) {
112 $this->getOutput()->setPageTitle( $this->msg( 'markedaspatrollederror' ) );
113 $this->getOutput()->addWikiMsg( 'markedaspatrollederror-noautopatrol' );
114 $this->getOutput()->returnToMain( null, $return );
115 return true;
116 }
117
118 if ( $errors ) {
119 if ( !in_array( [ 'hookaborted' ], $errors ) ) {
120 throw new PermissionsError( 'patrol', $errors );
121 }
122 // The hook itself has handled any output
123 return $errors;
124 }
125
126 $this->getOutput()->setPageTitle( $this->msg( 'markedaspatrolled' ) );
127 $this->getOutput()->addWikiMsg( 'markedaspatrolledtext', $rc->getTitle()->getPrefixedText() );
128 $this->getOutput()->returnToMain( null, $return );
129 return true;
130 }
131
132 public function onSuccess() {
133 // Required by parent class. Redundant as our onSubmit handles output already.
134 }
135
136 public function doesWrites() {
137 return true;
138 }
139}
getOutput()
Get the OutputPage being used for this instance.
Definition Action.php:207
msg( $key)
Get a Message object with context set Parameters are the same as wfMessage()
Definition Action.php:256
getUser()
Shortcut to get the User being used for this instance.
Definition Action.php:217
getRequest()
Get the WebRequest being used for this instance.
Definition Action.php:197
An error page which can definitely be safely rendered using the OutputPage.
An action which shows a form and does something based on the input from the form.
Object handling generic submission, CSRF protection, layout and other logic for UI forms.
Definition HTMLForm.php:128
Mark a revision as patrolled on a page.
getName()
Return the name of the action this object responds to.
alterForm(HTMLForm $form)
Play with the HTMLForm if you need to more substantially.
doesWrites()
Indicates whether this action may perform database writes.
getDescription()
Returns the description that goes below the <h1> tag.
getRestriction()
Get the permission required to perform this action.
onSuccess()
Do something exciting on successful processing of the form.
preText()
Add pre- or post-text to the form.
MediaWikiServices is the service locator for the application scope of MediaWiki.
Show an error when a user tries to do something they do not have the necessary permissions for.
static newFromId( $rcid)
Obtain the recent change with a given rc_id value.
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,...
null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify $query
Definition hooks.txt:1610
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses after processing after in associative array form before processing starts Return false to skip default processing and return $ret $linkRenderer
Definition hooks.txt:2026
const RC_NEW
Definition Defines.php:144