getInstance() public method

Generator method to return a new instance of the element type class.
public getInstance ( ) : BaseEventTypeElement
return BaseEventTypeElement
 /**
  * Initialise an element of $element_type for returning as an individual form. If the $previous_id is provided,
  * then the default values of the element will be overridden with the properties of the previous intance of the
  * element. Similarly, $additional allows specific values to be set on the element.
  *
  * Abstracted to allow overrides in specific module controllers
  *
  * @param ElementType $element_type
  * @param integer $previous_id
  * @param array() $additional - additional attributes for the element
  * @return \BaseEventTypeElement
  */
 protected function getElementForElementForm($element_type, $previous_id = 0, $additional)
 {
     $element_class = $element_type->class_name;
     $element = $element_type->getInstance();
     $this->setElementDefaultOptions($element, "create");
     if ($previous_id && $element->canCopy()) {
         $previous_element = $element_class::model()->findByPk($previous_id);
         $element->loadFromExisting($previous_element);
     }
     if ($additional) {
         foreach (array_keys($additional) as $add) {
             if ($element->isAttributeSafe($add)) {
                 $element->{$add} = $additional[$add];
             }
         }
     }
     return $element;
 }
 /**
  * Processes provided form data to create 1 or more elements of the provided type.
  *
  * @param ElementType $element_type
  * @param $data
  * @return array
  * @throws Exception
  */
 protected function getElementsForElementType(ElementType $element_type, $data)
 {
     $elements = array();
     $el_cls_name = $element_type->class_name;
     $f_key = CHtml::modelName($el_cls_name);
     if (isset($data[$f_key])) {
         $keys = array_keys($data[$f_key]);
         if (is_array($data[$f_key][$keys[0]]) && !count(array_filter(array_keys($data[$f_key]), 'is_string'))) {
             // there is more than one element of this type
             $pk_field = $el_cls_name::model()->tableSchema->primaryKey;
             foreach ($data[$f_key] as $i => $attrs) {
                 if (!$this->event->isNewRecord && !isset($attrs[$pk_field])) {
                     throw new Exception('missing primary key field for multiple elements for editing an event');
                 }
                 if ($pk = @$attrs[$pk_field]) {
                     $element = $el_cls_name::model()->findByPk($pk);
                 } else {
                     $element = $element_type->getInstance();
                 }
                 $element->attributes = Helper::convertNHS2MySQL($attrs);
                 $this->setElementComplexAttributesFromData($element, $data, $i);
                 $element->event = $this->event;
                 $elements[] = $element;
             }
         } else {
             if ($this->event->isNewRecord || !($element = $el_cls_name::model()->find('event_id=?', array($this->event->id)))) {
                 $element = $element_type->getInstance();
             }
             $element->attributes = Helper::convertNHS2MySQL($data[$f_key]);
             $this->setElementComplexAttributesFromData($element, $data);
             $element->event = $this->event;
             $elements[] = $element;
         }
     }
     return $elements;
 }