visualizer / classes / Visualizer / Source.php

Source.php in Visualizer – Tables & Charts Manager with Built-in AI Generator 1.7.6, at classes/Visualizer/Source.php

206 lines 5.1 KB

Raw Download Zip

1	<?php
2
3	// +----------------------------------------------------------------------+
4	// \| Copyright 2013 Madpixels (email : visualizer@madpixels.net) \|
5	// +----------------------------------------------------------------------+
6	// \| This program is free software; you can redistribute it and/or modify \|
7	// \| it under the terms of the GNU General Public License, version 2, as \|
8	// \| published by the Free Software Foundation. \|
9	// \| \|
10	// \| This program is distributed in the hope that it will be useful, \|
11	// \| but WITHOUT ANY WARRANTY; without even the implied warranty of \|
12	// \| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the \|
13	// \| GNU General Public License for more details. \|
14	// \| \|
15	// \| You should have received a copy of the GNU General Public License \|
16	// \| along with this program; if not, write to the Free Software \|
17	// \| Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, \|
18	// \| MA 02110-1301 USA \|
19	// +----------------------------------------------------------------------+
20	// \| Author: Eugene Manuilov <eugene@manuilov.org> \|
21	// +----------------------------------------------------------------------+
22	/**
23	* The abstract class for source managers.
24	*
25	* @category Visualizer
26	* @package Source
27	*
28	* @since 1.0.0
29	* @abstract
30	*/
31	abstract class Visualizer_Source {
32
33	/**
34	* The array of data.
35	*
36	* @since 1.0.0
37	*
38	* @access protected
39	* @var array
40	*/
41	protected $_data = array();
42
43	/**
44	* The array of series.
45	*
46	* @since 1.0.0
47	*
48	* @access protected
49	* @var array
50	*/
51	protected $_series = array();
52
53	/**
54	* Returns source name.
55	*
56	* @since 1.0.0
57	*
58	* @abstract
59	* @access public
60	* @return string The name of source.
61	*/
62	public abstract function getSourceName();
63
64	/**
65	* Fetches information from source, parses it and builds series and data arrays.
66	*
67	* @since 1.0.0
68	*
69	* @abstract
70	* @access public
71	*/
72	public abstract function fetch();
73
74	/**
75	* Returns series parsed from source.
76	*
77	* @since 1.0.0
78	*
79	* @access public
80	* @return array The array of series.
81	*/
82	public function getSeries() {
83	return $this->_series;
84	}
85
86	/**
87	* Returns data parsed from source.
88	*
89	* @since 1.0.0
90	*
91	* @access public
92	* @return string The serialized array of data.
93	*/
94	public function getData() {
95	return serialize( $this->_data );
96	}
97
98	/**
99	* Returns raw data array.
100	*
101	* @since 1.1.0
102	*
103	* @access public
104	* @return array
105	*/
106	public function getRawData() {
107	return $this->_data;
108	}
109
110	/**
111	* Normalizes values according to series' type.
112	*
113	* @since 1.0.0
114	*
115	* @access protected
116	* @param array $data The row of data.
117	* @return array Normalized row of data.
118	*/
119	protected function _normalizeData( $data ) {
120	// normalize values
121	// error_log(print_r($data,true));
122	foreach ( $this->_series as $i => $series ) {
123	// if no value exists for the seires, then add null
124	if ( ! isset( $data[ $i ] ) ) {
125	$data[ $i ] = null;
126	}
127
128	if ( is_null( $data[ $i ] ) ) {
129	continue;
130	}
131
132	switch ( $series['type'] ) {
133	case 'number':
134	$data[ $i ] = ( is_numeric( $data[ $i ] ) ) ? floatval( $data[ $i ] ) : (is_numeric( str_replace( ',', '', $data[ $i ] ) ) ? floatval( str_replace( ',', '', $data[ $i ] ) ) : null);
135	break;
136	case 'boolean':
137	$data[ $i ] = ! empty( $data[ $i ] ) ? filter_validate( $data[ $i ], FILTER_VALIDATE_BOOLEAN ) : null;
138	break;
139	case 'timeofday':
140	$date = new DateTime( '1984-03-16T' . $data[ $i ] );
141	if ( $date ) {
142	$data[ $i ] = array(
143	intval( $date->format( 'H' ) ),
144	intval( $date->format( 'i' ) ),
145	intval( $date->format( 's' ) ),
146	0,
147	);
148	}
149	break;
150	}
151	}
152	// error_log(print_r($data,true));
153	return $data;
154	}
155
156	/**
157	* Validates series tyeps.
158	*
159	* @since 1.0.1
160	*
161	* @static
162	* @access protected
163	* @param array $types The icoming series types.
164	* @return boolean TRUE if sereis types are valid, otherwise FALSE.
165	*/
166	protected static function _validateTypes( $types ) {
167	$allowed_types = array( 'string', 'number', 'boolean', 'date', 'datetime', 'timeofday' );
168	foreach ( $types as $type ) {
169	if ( ! in_array( $type, $allowed_types ) ) {
170	return false;
171	}
172	}
173
174	return true;
175	}
176
177	/**
178	* Re populates series if the source is dynamic.
179	*
180	* @since 1.1.0
181	*
182	* @access public
183	* @param array $series The actual array of series.
184	* @param int $chart_id The chart id.
185	* @return array The re populated array of series or old one.
186	*/
187	public function repopulateSeries( $series, $chart_id ) {
188	return $series;
189	}
190
191	/**
192	* Re populates data if the source is dynamic.
193	*
194	* @since 1.1.0
195	*
196	* @access public
197	* @param array $data The actual array of data.
198	* @param int $chart_id The chart id.
199	* @return array The re populated array of data or old one.
200	*/
201	public function repopulateData( $data, $chart_id ) {
202	return $data;
203	}
204
205	}
206