Skip to content
Snippets Groups Projects
class.forms.php 134 KiB
Newer Older
  • Learn to ignore specific revisions
  •     var $_assignees = null;
    
    Peter Rotich's avatar
    Peter Rotich committed
    
    
        function getFields() {
    
            if ($this->fields)
                return $this->fields;
    
            $fields = array(
                'assignee' => new AssigneeField(array(
                        'id'=>1,
                        'label' => __('Assignee'),
                        'flags' => hexdec(0X450F3),
                        'required' => true,
                        'validator-error' => __('Assignee selection required'),
    
    Peter Rotich's avatar
    Peter Rotich committed
                        'configuration' => array(
                            'criteria' => array(
                                'available' => true,
                                ),
                           ),
    
    Peter Rotich's avatar
    Peter Rotich committed
                        )
                    ),
                'comments' => new TextareaField(array(
                        'id' => 2,
                        'label'=> '',
                        'required'=>false,
                        'default'=>'',
                        'configuration' => array(
                            'html' => true,
    
                            'size' => 'small',
    
    Peter Rotich's avatar
    Peter Rotich committed
                            'placeholder' => __('Optional reason for the assignment'),
                            ),
                        )
                    ),
                );
    
    
            if (isset($this->_assignees))
    
                $fields['assignee']->setChoices($this->_assignees);
    
    
    
    Peter Rotich's avatar
    Peter Rotich committed
            $this->setFields($fields);
    
            return $this->fields;
        }
    
    
        function getField($name) {
    
            if (($fields = $this->getFields())
                    && isset($fields[$name]))
                return $fields[$name];
        }
    
    
    Peter Rotich's avatar
    Peter Rotich committed
        function isValid() {
    
    
            if (!parent::isValid() || !($f=$this->getField('assignee')))
    
    Peter Rotich's avatar
    Peter Rotich committed
                return false;
    
            // Do additional assignment validation
            if (!($assignee = $this->getAssignee())) {
    
                $f->addError(__('Unknown assignee'));
    
    Peter Rotich's avatar
    Peter Rotich committed
            } elseif ($assignee instanceof Staff) {
                // Make sure the agent is available
                if (!$assignee->isAvailable())
    
                    $f->addError(__('Agent is unavailable for assignment'));
            } elseif ($assignee instanceof Team) {
                // Make sure the team is active and has members
                if (!$assignee->isActive())
                    $f->addError(__('Team is disabled'));
                elseif (!$assignee->getNumMembers())
                    $f->addError(__('Team does not have members'));
    
    Peter Rotich's avatar
    Peter Rotich committed
            }
    
            return !$this->errors();
        }
    
        function render($options) {
    
            switch(strtolower($options['template'])) {
            case 'simple':
                $inc = STAFFINC_DIR . 'templates/dynamic-form-simple.tmpl.php';
                break;
            default:
                throw new Exception(sprintf(__('%s: Unknown template style %s'),
                            'FormUtils', $options['template']));
            }
    
            $form = $this;
            include $inc;
        }
    
    
        function setAssignees($assignees) {
            $this->_assignees = $assignees;
            $this->_fields = array();
        }
    
        function getAssignees() {
            return $this->_assignees;
        }
    
    
    Peter Rotich's avatar
    Peter Rotich committed
        function getAssignee() {
    
    
    Peter Rotich's avatar
    Peter Rotich committed
            if (!isset($this->_assignee))
                $this->_assignee = $this->getField('assignee')->getClean();
    
    Peter Rotich's avatar
    Peter Rotich committed
    
            return $this->_assignee;
        }
    
    
        function getComments() {
            return $this->getField('comments')->getClean();
    
    Peter Rotich's avatar
    Peter Rotich committed
        }
    }
    
    class ClaimForm extends AssignmentForm {
    
        var $_fields;
    
        function setFields($fields) {
            $this->_fields = $fields;
            parent::setFields($fields);
        }
    
        function getFields() {
    
            if ($this->_fields)
                return $this->_fields;
    
    Peter Rotich's avatar
    Peter Rotich committed
            $fields = parent::getFields();
    
            // Disable && hide assignee field selection
            if (isset($fields['assignee'])) {
                $visibility = new VisibilityConstraint(
                        new Q(array()), VisibilityConstraint::HIDDEN);
    
                $fields['assignee']->set('visibility', $visibility);
            }
    
            // Change coments placeholder to reflect claim
            if (isset($fields['comments'])) {
                $fields['comments']->configure('placeholder',
                        __('Optional reason for the claim'));
            }
    
    
            $this->setFields($fields);
    
            return $this->fields;
    
    Peter Rotich's avatar
    Peter Rotich committed
        }
    
    Peter Rotich's avatar
    Peter Rotich committed
    }
    
    class TransferForm extends Form {
    
        static $id = 'transfer';
        var $_dept = null;
    
        function __construct($source=null, $options=array()) {
            parent::__construct($source, $options);
        }
    
        function getFields() {
    
            if ($this->fields)
                return $this->fields;
    
            $fields = array(
                'dept' => new DepartmentField(array(
                        'id'=>1,
                        'label' => __('Department'),
                        'flags' => hexdec(0X450F3),
                        'required' => true,
                        'validator-error' => __('Department selection required'),
                        )
                    ),
                'comments' => new TextareaField(array(
                        'id' => 2,
                        'label'=> '',
                        'required'=>false,
                        'default'=>'',
                        'configuration' => array(
                            'html' => true,
    
    Peter Rotich's avatar
    Peter Rotich committed
                            'size' => 'small',
    
    Peter Rotich's avatar
    Peter Rotich committed
                            'placeholder' => __('Optional reason for the transfer'),
                            ),
                        )
                    ),
                );
    
            $this->setFields($fields);
    
            return $this->fields;
        }
    
        function isValid() {
    
            if (!parent::isValid())
                return false;
    
            // Do additional validations
            if (!($dept = $this->getDept()))
                $this->getField('dept')->addError(
                        __('Unknown department'));
    
            return !$this->errors();
        }
    
        function render($options) {
    
            switch(strtolower($options['template'])) {
            case 'simple':
                $inc = STAFFINC_DIR . 'templates/dynamic-form-simple.tmpl.php';
                break;
            default:
                throw new Exception(sprintf(__('%s: Unknown template style %s'),
                            get_class(), $options['template']));
            }
    
            $form = $this;
            include $inc;
    
        }
    
        function getDept() {
    
            if (!isset($this->_dept)) {
                if (($id = $this->getField('dept')->getClean()))
                    $this->_dept = Dept::lookup($id);
            }
    
            return $this->_dept;
        }
    }
    
    
    /**
     * FieldUnchanged
     *
     * Thrown in the to_database() method to indicate the value should not be
     * saved in the database (it wasn't changed in the request)
     */
    class FieldUnchanged extends Exception {}