Page addition to a user's watchlist. More...

Inheritance diagram for WatchAction:

Collaboration diagram for WatchAction:

Public Member Functions
	getName ()
	Return the name of the action this object responds to.
	onSubmit ($data)
	Process the form on POST submission.
	onSuccess ()
	Do something exciting on successful processing of the form.
	requiresUnblock ()
	Whether this action can still be executed by a blocked user.
	show ()
	This can be either formed or formless depending on the session token given.
Static Public Member Functions
static	doUnwatch (Title $title, User $user)
static	doWatch (Title $title, User $user)
static	getUnwatchToken (Title $title, User $user, $action= 'unwatch')
	Get token to unwatch (or watch) a page for a user.
static	getWatchToken (Title $title, User $user, $action= 'watch')
	Get token to watch (or unwatch) a page for a user.
Protected Member Functions
	alterForm (HTMLForm $form)
	Play with the HTMLForm if you need to more substantially.
	checkCanExecute (User $user)
	Checks if the given user (identified by an object) can perform this action.
	getDescription ()
	Returns the description that goes below the <h1> tag.
	getFormFields ()
	Just get an empty form with a single submit button.
	preText ()
	Add pre- or post-text to the form.

Detailed Description

Page addition to a user's watchlist.

Definition at line 28 of file WatchAction.php.

Member Function Documentation

WatchAction::alterForm ( HTMLForm $ form ) [protected]

Play with the HTMLForm if you need to more substantially.

Parameters:

$form HTMLForm

Reimplemented from FormAction.

Reimplemented in UnwatchAction.

Definition at line 143 of file WatchAction.php.

References HTMLForm\setSubmitTextMsg().

WatchAction::checkCanExecute ( User $ user ) [protected]

Checks if the given user (identified by an object) can perform this action.

Can be overridden by sub-classes with more complicated permissions schemes. Failures here must throw subclasses of ErrorPageError

Parameters:

$user User: the user to check, or null to use the context user

Exceptions:

UserBlockedError|ReadOnlyError|PermissionsError

Returns:: bool True on success

Reimplemented from Action.

Definition at line 81 of file WatchAction.php.

References User\isAnon().

Referenced by show().

static WatchAction::doUnwatch	(	Title $	title,
		User $	user
	)		`[static]`

Definition at line 100 of file WatchAction.php.

References Action\$page, array(), Action\factory(), User\removeWatch(), and wfRunHooks().

Referenced by ApiWatch\execute(), UnwatchAction\onSubmit(), ProtectionForm\save(), and ApiBase\setWatch().

static WatchAction::doWatch	(	Title $	title,
		User $	user
	)		`[static]`

Definition at line 90 of file WatchAction.php.

References Action\$page, User\addWatch(), array(), Action\factory(), and wfRunHooks().

Referenced by ApiWatch\execute(), onSubmit(), ProtectionForm\save(), and ApiBase\setWatch().

WatchAction::getDescription ( ) [protected]

Returns the description that goes below the <h1> tag.

Returns:: String

Reimplemented from Action.

Reimplemented in UnwatchAction.

Definition at line 38 of file WatchAction.php.

References Action\msg().

WatchAction::getFormFields ( ) [protected]

Just get an empty form with a single submit button.

Returns:: array

Reimplemented from FormAction.

Definition at line 46 of file WatchAction.php.

References array().

WatchAction::getName ( )

Return the name of the action this object responds to.

Returns:: String lowercase

Reimplemented from Action.

Reimplemented in UnwatchAction.

Definition at line 30 of file WatchAction.php.

Referenced by show().

static WatchAction::getUnwatchToken	(	Title $	title,
		User $	user,
		$	action = `'unwatch'`
	)		`[static]`

Get token to unwatch (or watch) a page for a user.

Parameters:

Title	$title	Title object of page to unwatch
User	$user	User for whom the action is going to be performed
string	$action	Optionally override the action to 'watch'

Returns:: string Token

Since:: 1.18

Definition at line 139 of file WatchAction.php.

References getWatchToken().

Referenced by LegacyTemplate\watchThisPage().

static WatchAction::getWatchToken	(	Title $	title,
		User $	user,
		$	action = `'watch'`
	)		`[static]`

Get token to watch (or unwatch) a page for a user.

Parameters:

Title	$title	Title object of page to watch
User	$user	User for whom the action is going to be performed
string	$action	Optionally override the action to 'unwatch'

Returns:: string Token

Since:: 1.18

Definition at line 119 of file WatchAction.php.

References array(), Title\getDBkey(), and User\getEditToken().

Referenced by SkinTemplate\buildContentNavigationUrls(), UnwatchedpagesPage\formatResult(), getUnwatchToken(), and LegacyTemplate\watchThisPage().

WatchAction::onSubmit ( $ data )

Process the form on POST submission.

If you return false from getFormFields(), this will obviously never be reached. If you don't want to do anything with the form, just return false here

Parameters:

$data Array

Returns:: Bool|Array true for success, false for didn't-try, array of errors on failure

Reimplemented from FormAction.

Reimplemented in UnwatchAction.

Definition at line 50 of file WatchAction.php.

References doWatch(), Action\getTitle(), Action\getUser(), wfProfileIn(), and wfProfileOut().

Referenced by show().

WatchAction::onSuccess ( )

Do something exciting on successful processing of the form.

This might be to show a confirmation message (watch, rollback, etc) or to redirect somewhere else (edit, protect, etc).

Reimplemented from FormAction.

Reimplemented in UnwatchAction.

Definition at line 151 of file WatchAction.php.

References Action\getOutput(), and Action\getTitle().

Referenced by show().

WatchAction::preText ( ) [protected]

Add pre- or post-text to the form.

Returns:: String HTML which will be sent to $form->addPreText()

Reimplemented from FormAction.

Reimplemented in UnwatchAction.

Definition at line 147 of file WatchAction.php.

References Action\msg().

WatchAction::requiresUnblock ( )

Whether this action can still be executed by a blocked user.

Returns:: Bool

Reimplemented from Action.

Definition at line 34 of file WatchAction.php.

WatchAction::show ( )

This can be either formed or formless depending on the session token given.

Reimplemented from FormAction.

Definition at line 60 of file WatchAction.php.

References $form, $user, array(), checkCanExecute(), FormAction\getForm(), getName(), Action\getTitle(), Action\getUser(), onSubmit(), onSuccess(), and Action\setHeaders().

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

includes/actions/WatchAction.php

Public Member Functions

Static Public Member Functions

Protected Member Functions

Detailed Description

Member Function Documentation