visualizer / classes / Visualizer / Plugin.php

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

251 lines 7.7 KB

Raw Download Zip

1	<?php
2	// +----------------------------------------------------------------------+
3	// \| Copyright 2013 Madpixels (email : visualizer@madpixels.net) \|
4	// +----------------------------------------------------------------------+
5	// \| This program is free software; you can redistribute it and/or modify \|
6	// \| it under the terms of the GNU General Public License, version 2, as \|
7	// \| published by the Free Software Foundation. \|
8	// \| \|
9	// \| This program is distributed in the hope that it will be useful, \|
10	// \| but WITHOUT ANY WARRANTY; without even the implied warranty of \|
11	// \| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the \|
12	// \| GNU General Public License for more details. \|
13	// \| \|
14	// \| You should have received a copy of the GNU General Public License \|
15	// \| along with this program; if not, write to the Free Software \|
16	// \| Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, \|
17	// \| MA 02110-1301 USA \|
18	// +----------------------------------------------------------------------+
19	// \| Author: Eugene Manuilov <eugene@manuilov.org> \|
20	// +----------------------------------------------------------------------+
21	/**
22	* The core plugin class.
23	*
24	* @category Visualizer
25	*
26	* @since 1.0.0
27	*/
28	class Visualizer_Plugin {
29
30	const NAME = 'visualizer';
31	const VERSION = '4.0.5';
32
33	// custom post types
34	const CPT_VISUALIZER = 'visualizer';
35
36	// custom meta fields
37	const CF_CHART_IMAGE = 'visualizer-chart-image';
38	const CF_CHART_TYPE = 'visualizer-chart-type';
39	const CF_SOURCE = 'visualizer-source';
40	const CF_SERIES = 'visualizer-series';
41	const CF_DEFAULT_DATA = 'visualizer-default-data';
42	const CF_SETTINGS = 'visualizer-settings';
43	const CF_CHART_LIBRARY = 'visualizer-chart-library';
44	const CF_ERROR = 'visualizer-error';
45	const CF_REMOTE_DB_PARAMS = 'visualizer-remote-db-params';
46
47	const CF_SOURCE_FILTER = 'visualizer-source-filter';
48	const CF_FILTER_CONFIG = 'visualizer-filter-config';
49	const CF_EDITABLE_TABLE = 'visualizer-editable-table';
50
51	// custom actions
52	const ACTION_GET_CHARTS = 'visualizer-get-charts';
53	const ACTION_CREATE_CHART = 'visualizer-create-chart';
54	const ACTION_EDIT_CHART = 'visualizer-edit-chart';
55	const ACTION_CLONE_CHART = 'visualizer-clone-chart';
56	const ACTION_DELETE_CHART = 'visualizer-delete-chart';
57	const ACTION_UPLOAD_DATA = 'visualizer-upload-data';
58	const ACTION_EXPORT_DATA = 'visualizer-export-data';
59
60	const STORE_URL = 'https://store.themeisle.com/';
61
62	/**
63	*Action used for fetching specific users/roles for permissions.
64	*/
65	const ACTION_FETCH_PERMISSIONS_DATA = 'visualizer-fetch-permissions-data';
66
67	/**
68	*Action used for fetching db import data.
69	*/
70	const ACTION_FETCH_DB_DATA = 'visualizer-fetch-db-data';
71	const ACTION_SAVE_DB_QUERY = 'visualizer-save-db-query';
72
73	const ACTION_JSON_GET_ROOTS = 'visualizer-json-get-roots';
74	const ACTION_JSON_GET_DATA = 'visualizer-json-get-data';
75	const ACTION_JSON_SET_DATA = 'visualizer-json-set-data';
76	const ACTION_JSON_SET_SCHEDULE = 'visualizer-json-set-schedule';
77	const CF_JSON_URL = 'visualizer-json-url';
78	const CF_JSON_ROOT = 'visualizer-json-root';
79	const CF_JSON_SCHEDULE = 'visualizer-json-schedule';
80	const CF_JSON_PAGING = 'visualizer-json-paging';
81	const CF_JSON_HEADERS = 'visualizer-json-headers';
82	const CF_EDITOR = 'visualizer-editor';
83
84	const ACTION_SAVE_FILTER_QUERY = 'visualizer-save-filter-query';
85
86	// custom filters
87	const FILTER_CHART_WRAPPER_CLASS = 'visualizer-chart-wrapper-class';
88	const FILTER_GET_CHART_SERIES = 'visualizer-get-chart-series';
89	const FILTER_GET_CHART_DATA = 'visualizer-get-chart-data';
90	const FILTER_GET_CHART_SETTINGS = 'visualizer-get-chart-settings';
91	const FILTER_UNDO_REVISIONS = 'visualizer-undo-revisions';
92	const FILTER_HANDLE_REVISIONS = 'visualizer-handle-revisions';
93	const FILTER_GET_CHART_DATA_AS = 'visualizer-get-chart-data-as';
94	const FILTER_HANDLE_CACHE_EXPIRATION_TIME = 'visualizer-handle-expiration-time';
95	const FILTER_CHART_TITLE = 'the_title';
96
97	const CF_DB_SCHEDULE = 'visualizer-db-schedule';
98	const CF_DB_QUERY = 'visualizer-db-query';
99
100	const CF_CHART_URL = 'visualizer-chart-url';
101	const CF_CHART_SCHEDULE = 'visualizer-chart-schedule';
102	// Added by Ash/Upwork
103	const PRO_TEASER_URL = 'https://themeisle.com/plugins/visualizer-charts-and-graphs/upgrade/';
104	const PRO_TEASER_TITLE = 'Check PRO version ';
105
106	const CF_CHART_CACHE = 'visualizer-chart-cache';
107	const CF_JSON_WOOCOMMERCE_SOURCE = 'visualizer-woocommerce-source';
108	const CF_IS_WOOCOMMERCE_SOURCE = 'visualizer-is-woocommerce-source';
109
110	/**
111	* Name of the option for WordPress DB.
112	*/
113	const WP_DB_NAME = 'WordPress DB';
114
115	// Added by Ash/Upwork
116	/**
117	* Singletone instance of the plugin.
118	*
119	* @since 1.0.0
120	*
121	* @access private
122	* @var Visualizer_Plugin
123	*/
124	private static $_instance = null;
125
126	/**
127	* The array of registered modules.
128	*
129	* @since 1.0.0
130	*
131	* @access private
132	* @var array
133	*/
134	private $_modules = array();
135
136	/**
137	* Returns the date queries supported in the library date filter.
138	*/
139	public static function getSupportedDateFilter() {
140	return apply_filters( 'visualizer_filter_by_date', array( '' => __( 'All dates', 'visualizer' ), 'yesterday' => __( 'Yesterday', 'visualizer' ), 'last week' => __( 'Last Week', 'visualizer' ), 'last month' => __( 'Last Month', 'visualizer' ), 'last year' => __( 'Last Year', 'visualizer' ) ) );
141	}
142
143	/**
144	* Private constructor.
145	*
146	* @since 1.0.0
147	*
148	* @access private
149	*/
150	private function __construct() {
151	if ( VISUALIZER_DEBUG ) {
152	add_action( 'themeisle_log_event', array( $this, 'themeisle_log_event_debug' ), 10, 5 );
153	}
154	}
155
156	/**
157	* Returns singletone instance of the plugin.
158	*
159	* @since 1.0.0
160	*
161	* @static
162	* @access public
163	* @return Visualizer_Plugin
164	*/
165	public static function instance() {
166	if ( is_null( self::$_instance ) ) {
167	self::$_instance = new Visualizer_Plugin();
168	}
169
170	return self::$_instance;
171	}
172
173	/**
174	* Returns chart types.
175	*
176	* @since 1.0.0
177	*
178	* @static
179	* @access public
180	* @return array
181	*/
182	public static function getChartTypes() {
183	$array = array_keys( Visualizer_Module_Admin::_getChartTypesLocalized() );
184
185	return $array;
186	}
187
188	/**
189	* Returns a module if it was registered before. Otherwise NULL.
190	*
191	* @since 1.0.0
192	*
193	* @access public
194	*
195	* @param string $name The name of the module to return.
196	*
197	* @return Visualizer_Module\|null Returns a module if it was registered or NULL.
198	*/
199	public function getModule( $name ) {
200	return isset( $this->_modules[ $name ] ) ? $this->_modules[ $name ] : null;
201	}
202
203	/**
204	* Determines whether the module has been registered or not.
205	*
206	* @since 1.0.0
207	*
208	* @access public
209	*
210	* @param string $name The name of a module to check.
211	*
212	* @return boolean TRUE if the module has been registered. Otherwise FALSE.
213	*/
214	public function hasModule( $name ) {
215	return isset( $this->_modules[ $name ] );
216	}
217
218	/**
219	* Register new module in the plugin.
220	*
221	* @since 1.0.0
222	*
223	* @access public
224	*
225	* @param string $class_name The name of the module to use in the plugin.
226	*/
227	public function setModule( $class_name ) {
228	$this->_modules[ $class_name ] = new $class_name( $this );
229	}
230
231	/**
232	* Private clone method.
233	*
234	* @since 1.0.0
235	*
236	* @access private
237	*/
238	private function __clone() {
239	}
240
241	/**
242	* For local testing, overrides the 'themeisle_log_event' hook and redirects to error.log.
243	*/
244	final public function themeisle_log_event_debug( $name, $message, $type, $file, $line ) {
245	if ( Visualizer_Plugin::NAME !== $name ) {
246	return;
247	}
248	error_log( sprintf( '%s (%s): %s in %s:%s', $name, $type, $message, $file, $line ) );
249	}
250	}
251