Helper class to keep track of options when mixing links and form elements. More...

Inheritance diagram for FormOptions:

Public Member Functions
	add ($name, $default, $type=self::AUTO)
	consumeValue ($name)
	consumeValues ($names)
	delete ($name)
	fetchValuesFromRequest (WebRequest $r, $values=false)
	getAllValues ()
	Format options to an array ( name => value)
	getChangedValues ()
	Return options modified as an array ( name => value )
	getUnconsumedValues ($all=false)
	Getting the data out for use.
	getValue ($name)
	Get the value for the given option name.
	reset ($name)
	Delete the option value.
	setValue ($name, $value, $force=false)
	Use to set the value of an option.
	validateIntBounds ($name, $min, $max)
	Validate and set an option integer value The value will be altered to fit in the range.
	validateName ($name, $strict=false)
	Verify the given option name exist.
ArrayAccess functions
Those function implements PHP ArrayAccess interface See also: http://php.net/manual/en/class.arrayaccess.php
	offsetExists ($name)
	Whether option exist.
	offsetGet ($name)
	Retrieve an option value.
	offsetSet ($name, $value)
	Set an option to given value.
	offsetUnset ($name)
	Delete the option.
Static Public Member Functions
static	guessType ($data)
	Used to find out which type the data is.
Public Attributes
Type constants
Used internally to map an option value to a WebRequest accessor
const	AUTO = -1
	Mark value for automatic detection (for simple data types only)
const	STRING = 0
	String type, maps guessType() to WebRequest::getText()
const	INT = 1
	Integer type, maps guessType() to WebRequest::getInt()
const	BOOL = 2
	Boolean type, maps guessType() to WebRequest::getBool()
const	INTNULL = 3
	Integer type or null, maps to WebRequest::getIntOrNull() This is useful for the namespace selector.
Protected Member Functions
	getValueReal ($option)
Protected Attributes
	$options = array()

Detailed Description

Helper class to keep track of options when mixing links and form elements.

Todo:: This badly need some examples and tests :-)

Definition at line 33 of file FormOptions.php.

Member Function Documentation

FormOptions::add	(	$	name,
		$	default,
		$	type = `self::AUTO`
	)

Definition at line 59 of file FormOptions.php.

References $name, array(), guessType(), and options().

Referenced by SpecialLog\execute(), and SpecialNewpages\setup().

FormOptions::consumeValue ( $ name )

Todo:: Document

Parameters:

string $name Option name

Exceptions:

MWException If option does not exist.

Returns:: mixed Value or the default value if it is null.

Definition at line 185 of file FormOptions.php.

References $name, getValueReal(), options(), and validateName().

FormOptions::consumeValues ( $ names )

Todo:: Document

Parameters:

array $names array of option names

Returns:: null

Definition at line 197 of file FormOptions.php.

References $name, $out, array(), as, getValueReal(), options(), and validateName().

FormOptions::delete ( $ name )

Definition at line 74 of file FormOptions.php.

References $name, options(), and validateName().

FormOptions::fetchValuesFromRequest	(	WebRequest $	r,
		$	values = `false`
	)

Definition at line 284 of file FormOptions.php.

References $name, $value, as, WebRequest\getBool(), WebRequest\getInt(), WebRequest\getIntOrNull(), WebRequest\getText(), and options().

Referenced by SpecialNewpages\setup().

FormOptions::getAllValues ( )

Format options to an array ( name => value)

Returns:: Array

Definition at line 272 of file FormOptions.php.

References $name, array(), as, getValueReal(), and options().

FormOptions::getChangedValues ( )

Return options modified as an array ( name => value )

Returns:: Array

Definition at line 256 of file FormOptions.php.

References $name, array(), as, and options().

FormOptions::getUnconsumedValues ( $ all = false )

Getting the data out for use.

Parameters:

$all	Boolean: whether to include unchanged options (default: false)

Returns:: Array

Definition at line 238 of file FormOptions.php.

References $name, array(), as, getValueReal(), and options().

FormOptions::getValue ( $ name )

Get the value for the given option name.

Internally use getValueReal()

Parameters:

string $name option name

Returns:: Mixed

Definition at line 149 of file FormOptions.php.

References $name, getValueReal(), options(), and validateName().

Referenced by offsetGet(), and SpecialLog\show().

FormOptions::getValueReal ( $ option ) [protected]

Todo:: Document

Parameters:

array $option array structure describing the option

Returns:: Mixed. Value or the default value if it is null

Definition at line 160 of file FormOptions.php.

Referenced by consumeValue(), consumeValues(), getAllValues(), getUnconsumedValues(), getValue(), and validateIntBounds().

static FormOptions::guessType ( $ data ) [static]

Used to find out which type the data is.

All types are defined in the 'Type constants' section of this class Please note we do not support detection of INTNULL MediaWiki type which will be assumed as INT if the data is an integer.

Parameters:

$data Mixed: value to guess type for

Exceptions:

MWException
MWException	Unsupported datatype

Returns:: int Type constant

Definition at line 90 of file FormOptions.php.

References BOOL, INT, and STRING.

Referenced by add().

FormOptions::offsetExists ( $ name )

Whether option exist.

Returns:: bool

Definition at line 321 of file FormOptions.php.

References $name, and options().

FormOptions::offsetGet ( $ name )

Retrieve an option value.

Returns:: Mixed

Definition at line 328 of file FormOptions.php.

References $name, and getValue().

FormOptions::offsetSet	(	$	name,
		$	value
	)

Set an option to given value.

Definition at line 332 of file FormOptions.php.

References $name, $value, and setValue().

FormOptions::offsetUnset ( $ name )

Delete the option.

Definition at line 336 of file FormOptions.php.

References $name.

FormOptions::reset ( $ name )

Delete the option value.

This will make future calls to getValue() return the default value.

Parameters:

string $name option name

Returns:: null

Definition at line 174 of file FormOptions.php.

References $name, options(), and validateName().

Referenced by SpecialRecentChanges\buildMainQueryConds().

FormOptions::setValue	(	$	name,
		$	value,
		$	force = `false`
	)

Use to set the value of an option.

Parameters:

string	$name	option name
	$value	Mixed: value for the option
	$force	Boolean: whether to set the value when it is equivalent to the default value for this option (default false).