silverstripe-framework/forms/FormScaffolder.php

205 lines
5.9 KiB
PHP
Raw Normal View History

<?php
/**
2014-08-15 08:53:05 +02:00
*
* @package framework
* @subpackage forms
*
* @uses DBField::scaffoldFormField()
* @uses DataObject::fieldLabels()
*/
class FormScaffolder extends Object {
2014-08-15 08:53:05 +02:00
/**
* @var DataObject $obj The object defining the fields to be scaffolded
* through its metadata like $db, $searchable_fields, etc.
*/
protected $obj;
2014-08-15 08:53:05 +02:00
/**
2014-08-15 08:53:05 +02:00
* @var boolean $tabbed Return fields in a tabset, with all main fields in the path "Root.Main",
* relation fields in "Root.<relationname>" (if {@link $includeRelations} is enabled).
*/
public $tabbed = false;
2014-08-15 08:53:05 +02:00
/**
2014-08-15 08:53:05 +02:00
* @var boolean $ajaxSafe
*/
public $ajaxSafe = false;
2014-08-15 08:53:05 +02:00
/**
* @var array $restrictFields Numeric array of a field name whitelist.
* If left blank, all fields from {@link DataObject->db()} will be included.
2014-08-15 08:53:05 +02:00
*
* @todo Implement restrictions for has_many and many_many relations.
*/
public $restrictFields;
2014-08-15 08:53:05 +02:00
/**
* @var array $fieldClasses Optional mapping of fieldnames to subclasses of {@link FormField}.
* By default the scaffolder will determine the field instance by {@link DBField::scaffoldFormField()}.
2014-08-15 08:53:05 +02:00
*
* @todo Implement fieldClasses for has_many and many_many relations
*/
public $fieldClasses;
2014-08-15 08:53:05 +02:00
/**
* @var boolean $includeRelations Include has_one, has_many and many_many relations
*/
public $includeRelations = false;
2014-08-15 08:53:05 +02:00
/**
* @param DataObject $obj
* @param array $params
*/
public function __construct($obj) {
$this->obj = $obj;
parent::__construct();
}
2014-08-15 08:53:05 +02:00
/**
* Gets the form fields as defined through the metadata
* on {@link $obj} and the custom parameters passed to FormScaffolder.
* Depending on those parameters, the fields can be used in ajax-context,
* contain {@link TabSet}s etc.
2014-08-15 08:53:05 +02:00
*
* @return FieldList
*/
public function getFieldList() {
$fields = new FieldList();
2014-08-15 08:53:05 +02:00
// tabbed or untabbed
if($this->tabbed) {
$fields->push(new TabSet("Root", $mainTab = new Tab("Main")));
$mainTab->setTitle(_t('SiteTree.TABMAIN', "Main"));
}
2014-08-15 08:53:05 +02:00
// Add logical fields directly specified in db config
foreach($this->obj->config()->db as $fieldName => $fieldType) {
// Skip restricted fields
if($this->restrictFields && !in_array($fieldName, $this->restrictFields)) continue;
2014-08-15 08:53:05 +02:00
// @todo Pass localized title
if($this->fieldClasses && isset($this->fieldClasses[$fieldName])) {
$fieldClass = $this->fieldClasses[$fieldName];
$fieldObject = new $fieldClass($fieldName);
} else {
$fieldObject = $this
->obj
->dbObject($fieldName)
->scaffoldFormField(null, $this->getParamsArray());
}
// Allow fields to opt-out of scaffolding
if(!$fieldObject) {
continue;
}
$fieldObject->setTitle($this->obj->fieldLabel($fieldName));
if($this->tabbed) {
$fields->addFieldToTab("Root.Main", $fieldObject);
} else {
$fields->push($fieldObject);
}
}
2014-08-15 08:53:05 +02:00
// add has_one relation fields
if($this->obj->hasOne()) {
foreach($this->obj->hasOne() as $relationship => $component) {
if($this->restrictFields && !in_array($relationship, $this->restrictFields)) continue;
$fieldName = $component === 'SilverStripe\\ORM\\DataObject'
2013-07-10 02:44:24 +02:00
? $relationship // Polymorphic has_one field is composite, so don't refer to ID subfield
: "{$relationship}ID";
if($this->fieldClasses && isset($this->fieldClasses[$fieldName])) {
$fieldClass = $this->fieldClasses[$fieldName];
$hasOneField = new $fieldClass($fieldName);
} else {
$hasOneField = $this->obj->dbObject($fieldName)->scaffoldFormField(null, $this->getParamsArray());
}
2013-07-10 02:44:24 +02:00
if(empty($hasOneField)) continue; // Allow fields to opt out of scaffolding
$hasOneField->setTitle($this->obj->fieldLabel($relationship));
if($this->tabbed) {
$fields->addFieldToTab("Root.Main", $hasOneField);
} else {
$fields->push($hasOneField);
}
}
}
2014-08-15 08:53:05 +02:00
// only add relational fields if an ID is present
if($this->obj->ID) {
// add has_many relation fields
if($this->obj->hasMany()
&& ($this->includeRelations === true || isset($this->includeRelations['has_many']))) {
foreach($this->obj->hasMany() as $relationship => $component) {
if($this->tabbed) {
$relationTab = $fields->findOrMakeTab(
2014-08-15 08:53:05 +02:00
"Root.$relationship",
$this->obj->fieldLabel($relationship)
);
}
$fieldClass = (isset($this->fieldClasses[$relationship]))
2014-08-15 08:53:05 +02:00
? $this->fieldClasses[$relationship]
: 'GridField';
2014-08-15 08:53:05 +02:00
$grid = Object::create($fieldClass,
$relationship,
$this->obj->fieldLabel($relationship),
$this->obj->$relationship(),
GridFieldConfig_RelationEditor::create()
);
if($this->tabbed) {
$fields->addFieldToTab("Root.$relationship", $grid);
} else {
$fields->push($grid);
}
}
}
if($this->obj->manyMany()
&& ($this->includeRelations === true || isset($this->includeRelations['many_many']))) {
foreach($this->obj->manyMany() as $relationship => $component) {
if($this->tabbed) {
$relationTab = $fields->findOrMakeTab(
2014-08-15 08:53:05 +02:00
"Root.$relationship",
$this->obj->fieldLabel($relationship)
);
}
$fieldClass = (isset($this->fieldClasses[$relationship]))
? $this->fieldClasses[$relationship]
: 'GridField';
2014-08-15 08:53:05 +02:00
$grid = Object::create($fieldClass,
$relationship,
$this->obj->fieldLabel($relationship),
$this->obj->$relationship(),
GridFieldConfig_RelationEditor::create()
);
if($this->tabbed) {
$fields->addFieldToTab("Root.$relationship", $grid);
} else {
$fields->push($grid);
}
}
}
}
2014-08-15 08:53:05 +02:00
return $fields;
}
2014-08-15 08:53:05 +02:00
/**
* Return an array suitable for passing on to {@link DBField->scaffoldFormField()}
* without tying this call to a FormScaffolder interface.
2014-08-15 08:53:05 +02:00
*
* @return array
*/
protected function getParamsArray() {
return array(
'tabbed' => $this->tabbed,
'includeRelations' => $this->includeRelations,
'restrictFields' => $this->restrictFields,
'fieldClasses' => $this->fieldClasses,
'ajaxSafe' => $this->ajaxSafe
);
}
}