1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
<?php
/**
* Matomo - free/libre analytics platform
*
* @link https://matomo.org
* @license https://www.gnu.org/licenses/gpl-3.0.html GPL v3 or later
*/
namespace Piwik\UpdateCheck;
/**
* Base class to define a custom release channel. Plugins can add their own custom release channels by extending this
* class in a `plugin/$plugin/ReleaseChannel` folder. Custom release channels can be useful for example to provide
* nightly builds, to manage updates for clients via a central server, to package a special Matomo version for clients
* with custom plugins etc.
*
* This is not a public API, and it may change without any announcement.
*/
abstract class ReleaseChannel
{
/**
* Get the ID for this release channel. E.g., this string will be saved in the config to identify the chosen release
* channel
* @return string
*/
abstract public function getId();
/**
* Get a human-readable name for this release channel, will be visible in the UI. Should be already translated.
* @return string
*/
abstract public function getName();
/**
* Whether only stable versions are wanted or also beta versions.
* @return bool
*/
public function doesPreferStable()
{
return true;
}
/**
* Get the latest available version number for this release channel. Eg '2.15.0-b4' or '2.15.0'. Should be
* a semantic version number in format MAJOR.MINOR.PATCH (https://semver.org/). Returning an empty string in case
* one cannot connect to the remote server can be acceptable.
* @return string
*/
abstract public function getUrlToCheckForLatestAvailableVersion();
/**
* Get the URL to download a specific Matomo archive for the given version number. The returned URL should not
* include a URI scheme, meaning it should start with '://...'.
*
* @param string $version
* @return string
*/
abstract public function getDownloadUrlWithoutScheme($version);
/**
* Get the description for this release channel. Will be shown directly next to the name of the release in the
* Admin UI. For example 'Recommended' or 'Long Term Support version'.
* @return string
*/
public function getDescription()
{
return '';
}
/**
* Get the order for this release channel. The lower the number the more important this release channel is. The
* release channel having the lowest order will be shown first and will be used as default release channel in case
* no valid release channel is defined.
* @return int
*/
public function getOrder()
{
return 99;
}
/**
* If the channel should be possible to be enabled in the system settings.
*/
public function isSelectableInSettings(): bool
{
return true;
}
}
|
