xref: /plugin/struct/helper/field.php (revision 89be912b2828f73aa728ab2d1347de9d26aada17)
1ed3de3d6SAndreas Gohr<?php
2ba766201SAndreas Gohruse dokuwiki\plugin\struct\meta\Column;
3ba766201SAndreas Gohruse dokuwiki\plugin\struct\meta\Schema;
4ba766201SAndreas Gohruse dokuwiki\plugin\struct\meta\StructException;
5ba766201SAndreas Gohruse dokuwiki\plugin\struct\meta\Value;
693ca6f4fSAndreas Gohruse dokuwiki\plugin\struct\meta\ValueValidator;
7ed3de3d6SAndreas Gohr
8ed3de3d6SAndreas Gohr/**
93ad9c1eaSAndreas Gohr * Allows adding a single struct field as a bureaucracy field
103ad9c1eaSAndreas Gohr *
113ad9c1eaSAndreas Gohr * This class is used when a field of the type struct_field is encountered in the
123ad9c1eaSAndreas Gohr * bureaucracy syntax.
13ed3de3d6SAndreas Gohr */
14ed3de3d6SAndreas Gohrclass helper_plugin_struct_field extends helper_plugin_bureaucracy_field {
15ed3de3d6SAndreas Gohr
163ad9c1eaSAndreas Gohr    /** @var  Column */
173ad9c1eaSAndreas Gohr    public $column;
18ed3de3d6SAndreas Gohr
193ad9c1eaSAndreas Gohr    /**
203ad9c1eaSAndreas Gohr     * Initialize the appropriate column
213ad9c1eaSAndreas Gohr     *
223ad9c1eaSAndreas Gohr     * @param array $args
233ad9c1eaSAndreas Gohr     */
243ad9c1eaSAndreas Gohr    public function initialize($args) {
25*89be912bSSzymon Olewniczak        $this->init($args);
26ed3de3d6SAndreas Gohr
273ad9c1eaSAndreas Gohr        // find the column
283ad9c1eaSAndreas Gohr        try {
293ad9c1eaSAndreas Gohr            $this->column = $this->findColumn($this->opt['label']);
303ad9c1eaSAndreas Gohr        } catch(StructException $e) {
313ad9c1eaSAndreas Gohr            msg(hsc($e->getMessage()), -1);
323ad9c1eaSAndreas Gohr        }
33*89be912bSSzymon Olewniczak
34*89be912bSSzymon Olewniczak        $this->standardArgs($args);
353ad9c1eaSAndreas Gohr    }
363ad9c1eaSAndreas Gohr
373ad9c1eaSAndreas Gohr    /**
386c71c031SAndreas Gohr     * Sets the value and validates it
393ad9c1eaSAndreas Gohr     *
406c71c031SAndreas Gohr     * @param mixed $value
416c71c031SAndreas Gohr     * @return bool value was set successfully validated
423ad9c1eaSAndreas Gohr     */
436c71c031SAndreas Gohr    protected function setVal($value) {
446c71c031SAndreas Gohr        if(!$this->column) {
456c71c031SAndreas Gohr            $value = '';
466c71c031SAndreas Gohr        } else {
4793ca6f4fSAndreas Gohr            $validator = new ValueValidator();
486c71c031SAndreas Gohr            $this->error = !$validator->validateValue($this->column, $value);
496c71c031SAndreas Gohr            if($this->error) {
506c71c031SAndreas Gohr                foreach($validator->getErrors() as $error) {
516c71c031SAndreas Gohr                    msg(hsc($error), -1);
526c71c031SAndreas Gohr                }
536c71c031SAndreas Gohr            }
546c71c031SAndreas Gohr        }
556c71c031SAndreas Gohr
566c71c031SAndreas Gohr        if($value === array() || $value === '') {
576c71c031SAndreas Gohr            if(!isset($this->opt['optional'])) {
586c71c031SAndreas Gohr                $this->error = true;
596c71c031SAndreas Gohr                msg(sprintf($this->getLang('e_required'), hsc($this->opt['label'])), -1);
606c71c031SAndreas Gohr            }
616c71c031SAndreas Gohr        }
626c71c031SAndreas Gohr
636c71c031SAndreas Gohr        $this->opt['value'] = $value;
646c71c031SAndreas Gohr        return !$this->error;
653ad9c1eaSAndreas Gohr    }
663ad9c1eaSAndreas Gohr
673ad9c1eaSAndreas Gohr    /**
683ad9c1eaSAndreas Gohr     * Creates the HTML for the field
693ad9c1eaSAndreas Gohr     *
703ad9c1eaSAndreas Gohr     * @param array $params
713ad9c1eaSAndreas Gohr     * @param Doku_Form $form
723ad9c1eaSAndreas Gohr     * @param int $formid
733ad9c1eaSAndreas Gohr     */
743ad9c1eaSAndreas Gohr    public function renderfield($params, Doku_Form $form, $formid) {
753ad9c1eaSAndreas Gohr        if(!$this->column) return;
763ad9c1eaSAndreas Gohr
773ad9c1eaSAndreas Gohr        // this is what parent does
783ad9c1eaSAndreas Gohr        $this->_handlePreload();
793ad9c1eaSAndreas Gohr        if(!$form->_infieldset) {
803ad9c1eaSAndreas Gohr            $form->startFieldset('');
813ad9c1eaSAndreas Gohr        }
823ad9c1eaSAndreas Gohr        if($this->error) {
833ad9c1eaSAndreas Gohr            $params['class'] = 'bureaucracy_error';
843ad9c1eaSAndreas Gohr        }
853ad9c1eaSAndreas Gohr
863ad9c1eaSAndreas Gohr        // output the field
873ad9c1eaSAndreas Gohr        $value = new Value($this->column, $this->opt['value']);
8895838d50SAndreas Gohr        $field = $this->makeField($value, $params['name']);
893ad9c1eaSAndreas Gohr        $form->addElement($field);
903ad9c1eaSAndreas Gohr    }
913ad9c1eaSAndreas Gohr
9295838d50SAndreas Gohr    /**
9395838d50SAndreas Gohr     * Create the input field
9495838d50SAndreas Gohr     *
9595838d50SAndreas Gohr     * @param Value $field
9695838d50SAndreas Gohr     * @param String $name field's name
9795838d50SAndreas Gohr     * @return string
9895838d50SAndreas Gohr     */
9995838d50SAndreas Gohr    protected function makeField(Value $field, $name) {
10095838d50SAndreas Gohr        $trans = hsc($field->getColumn()->getTranslatedLabel());
10195838d50SAndreas Gohr        $hint = hsc($field->getColumn()->getTranslatedHint());
10295838d50SAndreas Gohr        $class = $hint ? 'hashint' : '';
10395838d50SAndreas Gohr        $lclass = $this->error ? 'bureaucracy_error' : '';
10495838d50SAndreas Gohr        $colname = $field->getColumn()->getFullQualifiedLabel();
1059bdb73ceSAndreas Gohr        $required = $this->opt['optional'] ? '' : ' <sup>*</sup>';
10695838d50SAndreas Gohr
107ee983135SMichael Große        $id = uniqid('struct__', false);
108ee983135SMichael Große        $input = $field->getValueEditor($name, $id);
10995838d50SAndreas Gohr
110ee983135SMichael Große        $html = '<div class="field">';
111ee983135SMichael Große        $html .= "<label class=\"$lclass\" data-column=\"$colname\" for=\"$id\">";
11295838d50SAndreas Gohr        $html .= "<span class=\"label $class\" title=\"$hint\">$trans$required</span>";
11395838d50SAndreas Gohr        $html .= '</label>';
114ee983135SMichael Große        $html .= "<span class=\"input\">$input</span>";
115ee983135SMichael Große        $html .= '</div>';
11695838d50SAndreas Gohr
11795838d50SAndreas Gohr        return $html;
11895838d50SAndreas Gohr    }
11995838d50SAndreas Gohr
1203ad9c1eaSAndreas Gohr    /**
1213ad9c1eaSAndreas Gohr     * Tries to find the correct column and schema
1223ad9c1eaSAndreas Gohr     *
1233ad9c1eaSAndreas Gohr     * @throws StructException
1243ad9c1eaSAndreas Gohr     * @param string $colname
125ba766201SAndreas Gohr     * @return \dokuwiki\plugin\struct\meta\Column
1263ad9c1eaSAndreas Gohr     */
1273ad9c1eaSAndreas Gohr    protected function findColumn($colname) {
1283ad9c1eaSAndreas Gohr        list($table, $label) = explode('.', $colname, 2);
1293ad9c1eaSAndreas Gohr        if(!$table || !$label) {
1303ad9c1eaSAndreas Gohr            throw new StructException('Field \'%s\' not given in schema.field form', $colname);
1313ad9c1eaSAndreas Gohr        }
1323ad9c1eaSAndreas Gohr        $schema = new Schema($table);
1333ad9c1eaSAndreas Gohr        return $schema->findColumn($label);
1343ad9c1eaSAndreas Gohr    }
1353ad9c1eaSAndreas Gohr
1363ad9c1eaSAndreas Gohr    /**
1373ad9c1eaSAndreas Gohr     * This ensures all language strings are still working
1383ad9c1eaSAndreas Gohr     *
1393ad9c1eaSAndreas Gohr     * @return string always 'bureaucracy'
1403ad9c1eaSAndreas Gohr     */
1413ad9c1eaSAndreas Gohr    public function getPluginName() {
1423ad9c1eaSAndreas Gohr        return 'bureaucracy';
1433ad9c1eaSAndreas Gohr    }
144ed3de3d6SAndreas Gohr
145ed3de3d6SAndreas Gohr}
146