xref: /plugin/struct/meta/Column.php (revision 2987727967455b4335cb8dba900196317113c849) 
1<?php
2
3namespace plugin\struct\meta;
4
5use plugin\struct\types\AbstractBaseType;
6
7/**
8 * Class Column
9 *
10 * This represents a single column within a schema and contains the configured BaseType as well as the
11 * column reference to the data table.
12 *
13 * It basically combines the information how a column's content behaves (as defines in the BaseType and its
14 * configuration) with where to find that content and adds some basic meta data (like sort or enabled)
15 *
16 * @package plugin\struct\meta
17 */
18class Column {
19
20    /** @var int fields are sorted by this value */
21    protected $sort;
22    /** @var AbstractBaseType the type of this column */
23    protected $type;
24    /** @var int the column in the datatable. columns count from 1 */
25    protected $colref;
26    /** @var bool is this column still enabled? */
27    protected $enabled=true;
28    /** @var  string backreference to the table this column is part of */
29    protected $table;
30
31    /**
32     * Column constructor.
33     * @param int $sort
34     * @param AbstractBaseType $type
35     * @param int $colref
36     * @param bool $enabled
37     * @param string $table
38     */
39    public function __construct($sort, AbstractBaseType $type, $colref=0, $enabled=true, $table='') {
40        $this->sort = (int) $sort;
41        $this->type = $type;
42        $this->colref = (int) $colref;
43        $this->enabled = (bool) $enabled;
44        $this->table = $table;
45    }
46
47    /**
48     * @return int
49     */
50    public function getSort() {
51        return $this->sort;
52    }
53
54    /**
55     * @return int
56     */
57    public function getTid() {
58        return $this->type->getTid();
59    }
60
61    /**
62     * @return string
63     */
64    public function getLabel() {
65        return $this->type->getLabel();
66    }
67
68    /**
69     * @return string
70     */
71    public function getTranslatedLabel() {
72        return $this->type->getTranslatedLabel();
73    }
74
75    /**
76     * @return AbstractBaseType
77     */
78    public function getType() {
79        return $this->type;
80    }
81
82    /**
83     * @return int
84     */
85    public function getColref() {
86        return $this->colref;
87    }
88
89    /**
90     * Returns the full column name. When table is set, prefixed by the table name
91     *
92     * @return string
93     */
94    public function getColName() {
95        if($this->isMulti()) throw new StructException('Calling getColName on a multi value column makes no sense.');
96
97        $col = 'col'.$this->colref;
98        if($this->table) $col = 'data_'.$this->table.'.'.$col;
99        return $col;
100    }
101
102    /**
103     * @return boolean
104     */
105    public function isEnabled() {
106        return $this->enabled;
107    }
108
109    /**
110     * @return string
111     */
112    public function getTable() {
113        return $this->table;
114    }
115
116    /**
117     * @return bool
118     */
119    public function isMulti() {
120        return $this->type->isMulti();
121    }
122
123    /**
124     * Returns a list of all available types
125     *
126     * @return array
127     */
128    static public function allTypes() {
129        $types = array();
130        $files = glob(DOKU_PLUGIN . 'struct/types/*.php');
131        foreach($files as $file) {
132            $file = basename($file, '.php');
133            if(substr($file, 0, 8) == 'Abstract') continue;
134            $types[] = $file;
135        }
136        sort($types);
137
138        return $types;
139    }
140
141}
142