• var: additional items can be added to the choicelist

• var: array of OutputFormatter objects

Create a new choice list

• string $name: the name of the field (db name, and html field name
• string $description: used in the html title or longdesc for the field

Create a DBList object within this class that is connected to the available choices in the database and will handle the actual parsing of user input etc

If php supported multiple inheritance, then $this->list would not be a member of the class, rather DBList would be multiply inherited along with Field.

• string $table: the name of the DB table to query
• mixed $fields: array or string specifying the field(s) to query
• string $restriction: a restriction that will be applied to the query (WHERE...)
• string $order: the order to display the results (ORDER BY...)
• string $idfield: the name of the field that will be used to identify the selected item (value=)
• string $limit: limits that will be applied to the query (LIMIT...)
• string $join: any tables that should be LEFT JOINed in the query to make sense of it
• boolean $distinct: return only DISTINCT rows (default: false)

• AnchorTableList::connectDB() : overloading of ChoiceList's connectDB to allow for remembering the

Display the field inside a table

• return: a single row HTML representation of the field

• integer $cols: the number of columns to include in the table (extras are padded out)

Field::displayInTable()

render this form widget in an html table

• CheckBoxTableList::displayInTable()

Field::getValue()

Obtain the value of the field, taking account of default values

prepends a value to the dropdown list

• array $a: see DBChoiceList for details

Set the value of this field, both in the Field and in the DBList

• string $value: value to be set

Field::set()

set the value of this field

Create a set of OutputFormatter objects to handle the display of this object.

called as: setFormat($id, $f1, $v1, $f2, $v2, ...) {

• f1, v1 etc must be in pairs.
• f1 is an sprintf format (see PHP manual)
• v1 is an array of array indices that will be used to fill the fields in the sprintf format from a $data array passed to the formatter when asked to display itself

Obtain the SQL data necessary for including the foreign key in the DBRow to which we belong.

trip the complex field within us to sync(), which allows us to then know our actual value (at last).

• return: name='value' from parent class

• boolean $force: force the field to return a name=value statement even if it would prefer not to
• $name

Field::sqlSetStr()

create an SQL-injection-cleansed string for db statements

Update the value of the field and also the complex field within based on the user data.

This does *not* create new elements within the complex field (list) at this stage: that is deferred until the latest possible point for all error checking to be performed.

• return: did the field change?

• array $data: a set of name => value pairs from which the value of this field will be extracted

Field::update()

update the value of the object with the user-supplied data in $data