mirror of
https://github.com/silverstripe/silverstripe-framework
synced 2024-09-01 23:37:43 +02:00
Inform-merge: from the changeset: r32477: Merge 2.0-inform from trunk previously r32478: Merge 2.0-inform from trunk previously r32481: merge 2.0infom with lastes chunk r32483: merge 2.0infom with lastes chunk r33526: Final styling of all forms and combined communication form add/alter javascript for height adjustment of First / Second block r33580: styling for combined form communication in myinfom pages r33706: styling of combined form (communication) in Email r33881: made compatible to $extraClass r33885: added defaultVal r33887: fixed typo r34728: modified SmallFieldHolder?() r34729: added "validationError"-class r34914: WIP3866: Factfinder: Hide "self emplyed" block r34964: Change current plan upto TraumaInsurance? r35038: disabled friggin field focus r35230: #1032 Fixed hash-link insertion r35887: conditionally setting parameters in sourceID() - to avoid empty overrides r35892: Saving value in SQL-compatible format (YYYY-MM-DD instead of DD/MM/YYYY), with fallback for non-sql values (just passed through without conversion) r35928: Removed "create a" from PageType?-dropdown, sorting alphabetically, falling back to $singular_name r35990: branched off for membertablefield r35994: fix for membertablefield r36024: added array-condition needed for DMYDateField r36083: fix bug for compositeField -> dropDatalessField r36394: removed debug code r36826: change wrong indent format r36828: WIP 4262: Logging out of My Inform goes to blank page r36858: Fixed error caused in r12472 while merging to Session-class r37132: Merged partial changesets from branches/2.0-nzct, only adding childID to detailform when not in add-mode r40815: add an unsubscribe record when a member subscribe a newslettertype r41113: fix the bug described in http://support.silverstripe.com/info/ticket/31: CRM not showing search results r43226: fixed search (partial merge from trunk) r43268: merged createNewPassword() from trunk, was referencing a non-existinent global function randomString() git-svn-id: svn://svn.silverstripe.com/silverstripe/open/modules/sapphire/trunk@45473 467b73ca-7a2a-4603-9d3b-597d59a354a9
271 lines
7.4 KiB
PHP
Executable File
271 lines
7.4 KiB
PHP
Executable File
<?php
|
|
|
|
require_once("forms/Form.php");
|
|
|
|
/**
|
|
* DataObjectSet designed for form fields.
|
|
* It extends the DataObjectSet with the ability to get a sequential set of fields.
|
|
*/
|
|
class FieldSet extends DataObjectSet {
|
|
protected $sequentialSet;
|
|
|
|
/**
|
|
* Return a sequential set of all fields that have data. This excludes wrapper composite fields
|
|
* as well as heading / help text fields.
|
|
*/
|
|
public function dataFields() {
|
|
if(!$this->sequentialSet) $this->collateDataFields($this->sequentialSet);
|
|
return $this->sequentialSet;
|
|
}
|
|
|
|
protected function collateDataFields(&$list) {
|
|
foreach($this as $field) {
|
|
|
|
if($field->isComposite()) $field->collateDataFields($list);
|
|
if($field->hasData()) {
|
|
$name = $field->Name();
|
|
if(isset($list[$name])) {
|
|
if($this->form) $errSuffix = " in your '{$this->form->class}' form called '" . $this->form->Name() . "'";
|
|
user_error("collateDataFields() I noticed that a field called '$name' appears twice$errSuffix.", E_USER_ERROR);
|
|
}
|
|
$list[$name] = $field;
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add an extra field to a tab within this fieldset.
|
|
* This is most commonly used when overloading getCMSFields()
|
|
* @param tabName The name of the tab or tabset. Subtabs can be referred to as TabSet.Tab or TabSet.Tab.Subtab.
|
|
* This function will create any missing tabs.
|
|
* @param field The {@link FormField} object to add to the end of that tab.
|
|
* @param insertBefore The name of the field to insert before. Optional.
|
|
*/
|
|
public function addFieldToTab($tabName, $field, $insertBefore = null) {
|
|
// This is a cache that must be flushed
|
|
$this->sequentialSet = null;
|
|
|
|
// Find the tab
|
|
$tab = $this->findOrMakeTab($tabName);
|
|
|
|
// Add the field to the end of this set
|
|
if($insertBefore) $tab->insertBefore($field, $insertBefore);
|
|
else $tab->push($field);
|
|
}
|
|
|
|
/**
|
|
* Remove the given field from the given tab in the field.
|
|
*/
|
|
public function removeFieldFromTab($tabName, $fieldName) {
|
|
// This is a cache that must be flushed
|
|
$this->sequentialSet = null;
|
|
|
|
// Find the tab
|
|
$tab = $this->findOrMakeTab($tabName);
|
|
$tab->removeByName($fieldName);
|
|
}
|
|
|
|
/**
|
|
* Remove a field from this fieldset by name.
|
|
* It musn't be buried in a composite field.--- changed
|
|
* It could be buried in a composite field now. --- 5/09/2006
|
|
*/
|
|
public function removeByName($fieldName) {
|
|
foreach($this->items as $i => $child) {
|
|
if(is_object($child) && ($child->Name() == $fieldName || $child->Title() == $fieldName)) {
|
|
// unset($this->items[$i]);
|
|
array_splice( $this->items, $i, 1 );
|
|
break;
|
|
} else if($child->isComposite()) $child->removeByName($fieldName);
|
|
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add a number of extra fields to a tab within this fieldset.
|
|
* This is most commonly used when overloading getCMSFields()
|
|
* @param tabName The name of the tab or tabset. Subtabs can be referred to as TabSet.Tab or TabSet.Tab.Subtab.
|
|
* This function will create any missing tabs.
|
|
* @param fields An array of {@link FormField} objects.
|
|
*/
|
|
public function addFieldsToTab($tabName, $fields) {
|
|
$this->sequentialSet = null;
|
|
|
|
// Find the tab
|
|
$tab = $this->findOrMakeTab($tabName);
|
|
|
|
// Add the fields to the end of this set
|
|
foreach($fields as $field) $tab->push($field);
|
|
}
|
|
|
|
public function replaceField($fieldName, $newField) {
|
|
if($this->sequentialSet) $this->sequentialSet = null;
|
|
foreach($this->items as $i => $field) {
|
|
if(is_object($field)) {
|
|
if($field->Name() == $fieldName) {
|
|
$this->items[$i] = $newField;
|
|
return true;
|
|
|
|
} else if($field->isComposite()) {
|
|
if($field->replaceField($fieldName, $newField)) return true;
|
|
}
|
|
}
|
|
}
|
|
return false;
|
|
}
|
|
|
|
|
|
/**
|
|
* Returns the specified tab object, creating it if necessary.
|
|
* @param tabName The tab to return, in the form "Tab.Subtab.Subsubtab"
|
|
*/
|
|
protected function findOrMakeTab($tabName) {
|
|
$parts = explode('.',$tabName);
|
|
|
|
// We could have made this recursive, but I've chosen to keep all the logic code within FieldSet rather than add it to TabSet and Tab too.
|
|
$currentPointer = $this;
|
|
foreach($parts as $part) {
|
|
$parentPointer = $currentPointer;
|
|
$currentPointer = $currentPointer->fieldByName($part);
|
|
// Create any missing tabs
|
|
if(!$currentPointer) {
|
|
if(is_a($parentPointer,'TabSet')) {
|
|
$currentPointer = new Tab($part);
|
|
$parentPointer->push($currentPointer);
|
|
} else {
|
|
user_error("FieldSet::addFieldToTab() Tried to add a tab to a " . $parentPointer->class . " object - '$part' didn't exist.", E_USER_ERROR);
|
|
}
|
|
}
|
|
}
|
|
|
|
return $currentPointer;
|
|
|
|
}
|
|
|
|
/**
|
|
* Returns the named field
|
|
*/
|
|
public function fieldByName($name) {
|
|
foreach($this->items as $child) {
|
|
if($name == $child->Name() || $name == $child->id) return $child;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Returns the named field in a sequential set.
|
|
* use this if your using nested formfields.
|
|
*/
|
|
public function dataFieldByName($name) {
|
|
if($dataFields = $this->dataFields()){
|
|
foreach($dataFields as $child) {
|
|
if($name == $child->Name() || $name == $child->id) return $child;
|
|
}
|
|
}
|
|
}
|
|
|
|
public function insertBefore($item, $name) {
|
|
if($this->sequentialSet) $this->sequentialSet = null;
|
|
|
|
$i = 0;
|
|
|
|
foreach($this->items as $child) {
|
|
if($name == $child->Name() || $name == $child->id) {
|
|
array_splice($this->items, $i, 0, array($item));
|
|
|
|
return;
|
|
}
|
|
|
|
$i++;
|
|
}
|
|
$this->items[] = $item;
|
|
}
|
|
|
|
|
|
/**
|
|
* Inserts an item before the item with name $name
|
|
* It can be buried in a composite field
|
|
* If no item with name $name is found, $item is inserted at the end of the FieldSet
|
|
*
|
|
* @param FormField $item The item to be inserted
|
|
* @param string $name The name of the item that $item should be before
|
|
* @param int $level For internal use only, should not be passed
|
|
*/
|
|
public function insertBeforeRecursive($item, $name, $level = 0) {
|
|
if($this->sequentialSet) $this->sequentialSet = null;
|
|
$i = 0;
|
|
foreach($this->items as $child) {
|
|
if($name == $child->Name() || $name == $child->id) {
|
|
array_splice($this->items, $i, 0, array($item));
|
|
|
|
return $level;
|
|
} else if($child->isComposite()) {
|
|
if($level = $child->insertBeforeRecursive($item,$name,$level+1)) return $level;
|
|
}
|
|
|
|
$i++;
|
|
}
|
|
if ($level === 0) {
|
|
$this->items[] = $item;
|
|
return 0;
|
|
}
|
|
return false;
|
|
}
|
|
|
|
public function insertAfter($item, $name) {
|
|
if($this->sequentialSet) $this->sequentialSet = null;
|
|
|
|
$i = 0;
|
|
|
|
foreach($this->items as $child) {
|
|
if($name == $child->Name() || $name == $child->id) {
|
|
array_splice($this->items, $i + 1, 0, array($item));
|
|
|
|
return;
|
|
}
|
|
|
|
$i++;
|
|
}
|
|
$this->items[] = $item;
|
|
}
|
|
|
|
public function push($item, $key = null) {
|
|
if($this->sequentialSet) $this->sequentialSet = null;
|
|
return parent::push($item, $key = null);
|
|
}
|
|
|
|
public function setForm($form) {
|
|
foreach($this as $field) $field->setForm($form);
|
|
}
|
|
|
|
/**
|
|
* Load the given data into this form.
|
|
* @param data An map of data to load into the FieldSet.
|
|
*/
|
|
public function setValues($data) {
|
|
foreach($this->dataFields() as $field) {
|
|
$fieldName = $field->Name();
|
|
if(isset($data[$fieldName])) $field->setValue($data[$fieldName]);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Convert this form into a readonly form
|
|
*/
|
|
function transform($trans) {
|
|
$this->sequentialSet = null;
|
|
$newFields = new FieldSet();
|
|
foreach($this as $field) {
|
|
$newFields->push($field->transform($trans));
|
|
}
|
|
return $newFields;
|
|
}
|
|
|
|
function makeReadonly() {
|
|
return $this->transform(new ReadonlyTransformation());
|
|
}
|
|
|
|
|
|
}
|
|
|
|
?>
|