updateprogram.php — VikAppointments Services Booking Calendar 1.2.18

vikappointments / admin / models / updateprogram.php

vikappointments / admin / models Last commit date

updateprogram.php

158 lines

1	<?php
2	/**
3	* @package VikAppointments
4	* @subpackage core
5	* @author E4J s.r.l.
6	* @copyright Copyright (C) 2021 E4J s.r.l. All Rights Reserved.
7	* @license http://www.gnu.org/licenses/gpl-2.0.html GNU/GPL
8	* @link https://vikwp.com
9	*/
10
11	// No direct access
12	defined('ABSPATH') or die('No script kiddies please!');
13
14	VAPLoader::import('libraries.mvc.model');
15
16	/**
17	* VikAppointments update program model.
18	*
19	* @since 1.7
20	*/
21	class VikAppointmentsModelUpdateprogram extends JModelVAP
22	{
23	/**
24	* Checks whether there's a registered system able to
25	* handle the updates of the program.
26	*
27	* @return boolean
28	*/
29	public function isSupported()
30	{
31	/**
32	* Get internal event dispatcher to automatically
33	* include the parameters array, which will be used
34	* to fetch the version of the program.
35	*
36	* @see VAPFactory
37	*
38	* @since 1.7
39	*/
40	$dispatcher = VAPFactory::getEventDispatcher();
41
42	// try to get a cached response
43	return $dispatcher->is('onUpdaterSupported');
44	}
45
46	/**
47	* Checks whether the system registered some details about
48	* the latest version of the program.
49	*
50	* @return object An object containing the resulting details.
51	*/
52	public function getVersionDetails()
53	{
54	/**
55	* Get internal event dispatcher to automatically
56	* include the parameters array, which will be used
57	* to fetch the version of the program.
58	*
59	* @see VAPFactory
60	*
61	* @since 1.7
62	*/
63	$dispatcher = VAPFactory::getEventDispatcher();
64
65	// try to get a cached response
66	return $dispatcher->triggerOnce('onGetVersionContents');
67	}
68
69	/**
70	* Validates the current version of VikAppointments against the
71	* latest one stored on the manufacturer servers.
72	*
73	* @param boolean $cache True to look for a cached response.
74	*
75	* @return object An object containing the resulting details.
76	*/
77	public function checkVersion($cache = false)
78	{
79	if ($cache)
80	{
81	// try to get a cached response
82	$result = $this->getVersionDetails();
83
84	if ($result)
85	{
86	// cached result, return it
87	return $result;
88	}
89	}
90
91	/**
92	* Get internal event dispatcher to automatically
93	* include the parameters array, which will be used
94	* to fetch the version of the program.
95	*
96	* @see VAPFactory
97	*
98	* @since 1.7
99	*/
100	$dispatcher = VAPFactory::getEventDispatcher();
101
102	// make request
103	$result = $dispatcher->triggerOnce('onCheckVersion');
104
105	if (!$result)
106	{
107	// use empty "failure" placeholder
108	$result = new stdClass;
109	$result->status = 0;
110	}
111
112	return $result;
113	}
114
115	/**
116	* Launches the update to the latest available version.
117	*
118	* @return boolean True on success, false otherwise.
119	*/
120	public function doUpdate()
121	{
122	/**
123	* Get internal event dispatcher to automatically
124	* include the parameters array, which will be used
125	* to fetch the version of the program.
126	*
127	* @see VAPFactory
128	*
129	* @since 1.7
130	*/
131	$dispatcher = VAPFactory::getEventDispatcher();
132
133	$status = false;
134
135	try
136	{
137	// trigger update and search for a positive result
138	$status = $dispatcher->is('onDoUpdate');
139
140	if (!$status)
141	{
142	// The plugin never returns FALSE, because
143	// in case of errors an exception is thrown.
144	// For this reason, if we are here, probably
145	// the plugin hasn't been enabled.
146	$this->setError('Updater plugin disabled.');
147	}
148	}
149	catch (Exception $e)
150	{
151	// an error occurred while updating
152	$this->setError($e->getMessage());
153	}
154
155	return $status;
156	}
157	}
158