xref: /plugin/struct/meta/Column.php (revision d1b04e896c4b5d192246ab47bfafeb0c91d92ffc)
11c502704SAndreas Gohr<?php
21c502704SAndreas Gohr
31c502704SAndreas Gohrnamespace plugin\struct\meta;
41c502704SAndreas Gohr
51c502704SAndreas Gohruse plugin\struct\types\AbstractBaseType;
61c502704SAndreas Gohr
71c502704SAndreas Gohr/**
81c502704SAndreas Gohr * Class Column
91c502704SAndreas Gohr *
101c502704SAndreas Gohr * This represents a single column within a schema and contains the configured BaseType as well as the
117182938bSAndreas Gohr * column reference to the data table.
127182938bSAndreas Gohr *
137182938bSAndreas Gohr * It basically combines the information how a column's content behaves (as defines in the BaseType and its
147182938bSAndreas Gohr * configuration) with where to find that content and adds some basic meta data (like sort or enabled)
151c502704SAndreas Gohr *
161c502704SAndreas Gohr * @package plugin\struct\meta
171c502704SAndreas Gohr */
181c502704SAndreas Gohrclass Column {
191c502704SAndreas Gohr
201c502704SAndreas Gohr    /** @var int fields are sorted by this value */
211c502704SAndreas Gohr    protected $sort;
221c502704SAndreas Gohr    /** @var AbstractBaseType the type of this column */
231c502704SAndreas Gohr    protected $type;
241c502704SAndreas Gohr    /** @var int the column in the datatable. columns count from 1 */
251c502704SAndreas Gohr    protected $colref;
261c502704SAndreas Gohr    /** @var bool is this column still enabled? */
271c502704SAndreas Gohr    protected $enabled=true;
2863d51bbfSAndreas Gohr    /** @var  string backreference to the table this column is part of */
2963d51bbfSAndreas Gohr    protected $table;
301c502704SAndreas Gohr
311c502704SAndreas Gohr    /**
321c502704SAndreas Gohr     * Column constructor.
331c502704SAndreas Gohr     * @param int $sort
341c502704SAndreas Gohr     * @param AbstractBaseType $type
351c502704SAndreas Gohr     * @param int $colref
361c502704SAndreas Gohr     * @param bool $enabled
3763d51bbfSAndreas Gohr     * @param string $table
381c502704SAndreas Gohr     */
3963d51bbfSAndreas Gohr    public function __construct($sort, AbstractBaseType $type, $colref=0, $enabled=true, $table='') {
401c502704SAndreas Gohr        $this->sort = (int) $sort;
411c502704SAndreas Gohr        $this->type = $type;
421c502704SAndreas Gohr        $this->colref = (int) $colref;
431c502704SAndreas Gohr        $this->enabled = (bool) $enabled;
4463d51bbfSAndreas Gohr        $this->table = $table;
451c502704SAndreas Gohr    }
461c502704SAndreas Gohr
471c502704SAndreas Gohr    /**
481c502704SAndreas Gohr     * @return int
491c502704SAndreas Gohr     */
501c502704SAndreas Gohr    public function getSort() {
511c502704SAndreas Gohr        return $this->sort;
521c502704SAndreas Gohr    }
531c502704SAndreas Gohr
541c502704SAndreas Gohr    /**
551c502704SAndreas Gohr     * @return int
561c502704SAndreas Gohr     */
571c502704SAndreas Gohr    public function getTid() {
5804eb61a6SAndreas Gohr        return $this->type->getTid();
591c502704SAndreas Gohr    }
601c502704SAndreas Gohr
611c502704SAndreas Gohr    /**
6290ae6c2dSAndreas Gohr     * @return string
6390ae6c2dSAndreas Gohr     */
6490ae6c2dSAndreas Gohr    public function getLabel() {
6590ae6c2dSAndreas Gohr        return $this->type->getLabel();
6690ae6c2dSAndreas Gohr    }
6790ae6c2dSAndreas Gohr
6890ae6c2dSAndreas Gohr    /**
691c502704SAndreas Gohr     * @return AbstractBaseType
701c502704SAndreas Gohr     */
711c502704SAndreas Gohr    public function getType() {
721c502704SAndreas Gohr        return $this->type;
731c502704SAndreas Gohr    }
741c502704SAndreas Gohr
751c502704SAndreas Gohr    /**
761c502704SAndreas Gohr     * @return int
771c502704SAndreas Gohr     */
781c502704SAndreas Gohr    public function getColref() {
791c502704SAndreas Gohr        return $this->colref;
801c502704SAndreas Gohr    }
811c502704SAndreas Gohr
821c502704SAndreas Gohr    /**
83*d1b04e89SAndreas Gohr     * Returns the full column name. When table is set, prefixed by the table name
84*d1b04e89SAndreas Gohr     *
85*d1b04e89SAndreas Gohr     * @return string
86*d1b04e89SAndreas Gohr     */
87*d1b04e89SAndreas Gohr    public function getColName() {
88*d1b04e89SAndreas Gohr        $col = 'col'.$this->colref;
89*d1b04e89SAndreas Gohr        if($this->table) $col = $this->table.'.'.$col;
90*d1b04e89SAndreas Gohr        return $col;
91*d1b04e89SAndreas Gohr    }
92*d1b04e89SAndreas Gohr
93*d1b04e89SAndreas Gohr    /**
941c502704SAndreas Gohr     * @return boolean
951c502704SAndreas Gohr     */
961c502704SAndreas Gohr    public function isEnabled() {
971c502704SAndreas Gohr        return $this->enabled;
981c502704SAndreas Gohr    }
991c502704SAndreas Gohr
100ae697e1fSAndreas Gohr    /**
10163d51bbfSAndreas Gohr     * @return string
10263d51bbfSAndreas Gohr     */
10363d51bbfSAndreas Gohr    public function getTable() {
10463d51bbfSAndreas Gohr        return $this->table;
10563d51bbfSAndreas Gohr    }
10663d51bbfSAndreas Gohr
10763d51bbfSAndreas Gohr    /**
10890ae6c2dSAndreas Gohr     * @return bool
10990ae6c2dSAndreas Gohr     */
11090ae6c2dSAndreas Gohr    public function isMulti() {
11190ae6c2dSAndreas Gohr        return $this->type->isMulti();
11290ae6c2dSAndreas Gohr    }
11390ae6c2dSAndreas Gohr
11490ae6c2dSAndreas Gohr    /**
115ae697e1fSAndreas Gohr     * Returns a list of all available types
116ae697e1fSAndreas Gohr     *
117ae697e1fSAndreas Gohr     * @return array
118ae697e1fSAndreas Gohr     */
119ae697e1fSAndreas Gohr    static public function allTypes() {
120ae697e1fSAndreas Gohr        $types = array();
121ae697e1fSAndreas Gohr        $files = glob(DOKU_PLUGIN . 'struct/types/*.php');
122ae697e1fSAndreas Gohr        foreach($files as $file) {
123ae697e1fSAndreas Gohr            $file = basename($file, '.php');
124ae697e1fSAndreas Gohr            if(substr($file, 0, 8) == 'Abstract') continue;
125ae697e1fSAndreas Gohr            $types[] = $file;
126ae697e1fSAndreas Gohr        }
127ae697e1fSAndreas Gohr        sort($types);
1281c502704SAndreas Gohr
129ae697e1fSAndreas Gohr        return $types;
130ae697e1fSAndreas Gohr    }
1311c502704SAndreas Gohr
1321c502704SAndreas Gohr}
133