Compare commits

..

No commits in common. "master" and "v0.9" have entirely different histories.
master ... v0.9

10 changed files with 125 additions and 266 deletions

View File

@ -1,25 +1,3 @@
DotclearWatch 0.9.3 - 2023.10.22
===========================================================
* Require dotclear 2.28
* Require php 8.1
* Add PHP minor version (using PHP constants)
* Add uninstall feature (plugin Uninstaller)
* Fix colored synthax
* Use Helper Form everywhere
DotclearWatch 0.9.2 - 2023.10.14
===========================================================
* Require dotclear 2.28
* Require php 8.1
* Fix last minute update from Dtoclear 2.28
DotclearWatch 0.9.1 - 2023.10.09
===========================================================
* Require dotclear 2.28
* Require php 8.1
* Fix permissions
* Code review
DotclearWatch 0.9 - 2023.10.07
===========================================================
* Require dotclear 2.28

View File

@ -1,7 +1,7 @@
# README
[![Release](https://img.shields.io/badge/release-0.9.3-a2cbe9.svg)](https://git.dotclear.watch/dw/DotclearWatch/releases)
![Date](https://img.shields.io/badge/date-2023.10.22-c44d58.svg)
[![Release](https://img.shields.io/badge/release-0.9-a2cbe9.svg)](https://git.dotclear.watch/dw/DotclearWatch/releases)
![Date](https://img.shields.io/badge/date-2023.10.07-c44d58.svg)]
[![Dotclear](https://img.shields.io/badge/dotclear-v2.28-137bbb.svg)](https://fr.dotclear.org/download)
[![Dotaddict](https://img.shields.io/badge/dotaddict-official-9ac123.svg)](https://plugins.dotaddict.org/dc2/details/DotclearWatch)
[![License](https://img.shields.io/badge/license-GPL--2.0-ececec.svg)](https://git.dotclear.watch/dw/DotclearWatch/src/branch/master/LICENSE)
@ -29,9 +29,9 @@ in aboutConfig global parameters called DotclearWatch->hidden_modules
## REQUIREMENTS
* super admin permission to intall it
* Dotclear 2.28
* PHP 8.1+
* Dotclear super admin permission to intall it
## USAGE

View File

@ -1,27 +1,25 @@
<?php
/**
* @file
* @brief The plugin DotclearWatch definition
* @ingroup DotclearWatch
* @brief DotclearWatch, a plugin for Dotclear 2
*
* @defgroup DotclearWatch Plugin DotclearWatch.
* @package Dotclear
* @subpackage Plugin
*
* QSend report about your Dotclear.
* @author Jean-Christian Denis and contributors
*
* @author Jean-Christian Denis
* @copyright Jean-Christian Denis
* @copyright Jean-Christain Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1);
$this->registerModule(
'Dotclear Watch',
'Send report about your Dotclear',
'Jean-Christian Denis and contributors',
'0.9.3',
'0.9',
[
'requires' => [['core', '2.28']],
'permissions' => 'My',
'requires' => [
['php', '8.1'],
['core', '2.28'],
],
'type' => 'plugin',
'support' => 'https://git.dotclear.watch/dw/' . basename(__DIR__) . '/issues',
'details' => 'https://git.dotclear.watch/dw/' . basename(__DIR__) . '/src/branch/master/README.md',

View File

@ -2,10 +2,10 @@
<modules xmlns:da="http://dotaddict.org/da/">
<module id="DotclearWatch">
<name>Dotclear Watch</name>
<version>0.9.3</version>
<version>0.9</version>
<author>Jean-Christian Denis and contributors</author>
<desc>Send report about your Dotclear</desc>
<file>https://git.dotclear.watch/dw/DotclearWatch/releases/download/v0.9.3/plugin-DotclearWatch.zip</file>
<file>https://git.dotclear.watch/dw/DotclearWatch/releases/download/v0.9/plugin-DotclearWatch.zip</file>
<da:dcmin>2.28</da:dcmin>
<da:details>https://git.dotclear.watch/dw/DotclearWatch/src/branch/master/README.md</da:details>
<da:support>https://git.dotclear.watch/dw/DotclearWatch/issues</da:support>

View File

@ -1,25 +1,22 @@
<?php
/**
* @brief DotclearWatch, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christain Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1);
namespace Dotclear\Plugin\DotclearWatch;
use Dotclear\App;
use Dotclear\Core\Process;
use Dotclear\Helper\Html\Form\{
Img,
Li,
Link,
Ul
};
/**
* @brief DotclearWatch backend class.
* @ingroup DotclearWatch
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
class Backend extends Process
{
public static function init(): bool
@ -34,31 +31,23 @@ class Backend extends Process
}
App::behavior()->addBehaviors([
// Add JS for asynchronous report sending
'adminDashboardHeaders' => function (): string {
return My::jsLoad('service', App::version()->getVersion(My::id()));
},
// Add icon on bottom of dashboard sidebar menu
'adminPageFooterV2' => function (): void {
if (My::settings()->getGlobal('distant_api_url')) {
echo (new Ul())->items([
(new li())->items([
(new Link())
->class('outgoing')
->href('https://stat.dotclear.watch')
->title(__('Uses DotclearWatch plugin statistics'))
->text(__('Shared statistics'))
->items([
(new Img(My::fileURL('icon.svg'))),
]),
]),
])->render();
echo sprintf(
'<ul><li><a href="%s" title="%s" class="outgoing">%s<img src="%s" /></a></ul></li>',
'https://stat.dotclear.watch',
__('Uses DotclearWatch plugin statistics'),
__('Shared statistics'),
My::fileURL('icon.svg')
);
}
},
]);
App::rest()->addFunction(
// Add REST service for asynchronous report sending
'adminDotclearWatchSendReport',
function (): array {
Utils::sendReport();

View File

@ -1,5 +1,13 @@
<?php
/**
* @brief DotclearWatch, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugins
*
* @copyright Olivier Meunier & Association Dotclear
* @copyright GPL-2.0-only
*/
declare(strict_types=1);
namespace Dotclear\Plugin\DotclearWatch;
@ -22,32 +30,14 @@ use Dotclear\Helper\Html\Form\{
};
use Dotclear\Helper\Html\Html;
/**
* @brief DotclearWatch configuration class.
* @ingroup DotclearWatch
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
class Config extends Process
{
/**
* List of hidden modules.
*
* @var string $hidden_modules
*/
private static string $hidden_modules = '';
/**
* Distant API URL.
*
* @var string $distant_api_url
*/
private static string $distant_api_url = '';
public static function init(): bool
{
return self::status(My::checkContext(My::CONFIG));
return self::status(My::checkContext(My::MANAGE));
}
public static function process(): bool
@ -56,7 +46,7 @@ class Config extends Process
return false;
}
if (App::auth()->prefs()->get('interface')->get('colorsyntax')) {
if (self::useColorSynthax()) {
App::behavior()->addBehavior('pluginsToolsHeadersV2', fn (bool $plugin): string => Page::jsLoadCodeMirror(App::auth()->prefs()->get('interface')->get('colorsyntax_theme')));
}
@ -72,7 +62,6 @@ class Config extends Process
Notices::AddSuccessNotice(__('Cache directory sucessfully cleared.'));
}
self::$distant_api_url = !empty($_POST['distant_api_url']) && is_string($_POST['distant_api_url']) ? $_POST['distant_api_url'] : Utils::DISTANT_API_URL;
self::$hidden_modules = '';
foreach (explode(',', $_POST['hidden_modules']) as $hidden) {
$hidden = trim($hidden);
@ -81,6 +70,8 @@ class Config extends Process
}
}
self::$distant_api_url = !empty($_POST['distant_api_url']) && is_string($_POST['distant_api_url']) ? $_POST['distant_api_url'] : Utils::DISTANT_API_URL;
My::settings()->put('hidden_modules', self::$hidden_modules, 'string', 'Hidden modules from report', true, true);
My::settings()->put('distant_api_url', self::$distant_api_url, 'string', 'Distant API report URL', true, true);
Notices::AddSuccessNotice(__('Settings successfully updated.'));
@ -95,7 +86,7 @@ class Config extends Process
}
}
App::backend()->url()->redirect('admin.plugins', ['module' => My::id(), 'conf' => '1']);
App::backend()->url->redirect('admin.plugins', ['module' => My::id(), 'conf' => '1']);
return true;
}
@ -115,12 +106,12 @@ class Config extends Process
]),
(new Para())->items([
(new Label(__('Hidden modules:')))->for('hidden_modules'),
(new Input('hidden_modules'))->class('maximal')->size(65)->maxlength(255)->value(self::$hidden_modules),
(new Input('hidden_modules'))->class('maximal')->size(65)->maxlenght(255)->value(self::$hidden_modules),
]),
(new Note())->class('form-note')->text(__('This is the comma separated list of plugins IDs and themes IDs to ignore in report.')),
(new Para())->items([
(new Label(__('Distant API URL:')))->for('distant_api_url'),
(new Input('distant_api_url'))->class('maximal')->size(65)->maxlength(255)->value(self::$distant_api_url),
(new Input('distant_api_url'))->class('maximal')->size(65)->maxlenght(255)->value(self::$distant_api_url),
]),
(new Note())->class('form-note')->text(__('This is the URL of the API to send report. Leave empty to reset value.')),
(new Para())->items([
@ -147,9 +138,14 @@ class Config extends Process
->class('maximal'),
])->render() .
(
App::auth()->prefs()->get('interface')->get('colorsyntax') ?
self::useColorSynthax() ?
Page::jsRunCodeMirror(My::id() . 'editor', 'report_contents', 'json', App::auth()->prefs()->get('interface')->get('colorsyntax_theme')) : ''
);
}
}
private static function useColorSynthax(): bool
{
return App::auth()->prefs()->get('interface')->get('colorsyntax') && '' != App::auth()->prefs()->get('interface')->get('colorsyntax_theme');
}
}

View File

@ -1,18 +1,21 @@
<?php
/**
* @brief DotclearWatch, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christain Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1);
namespace Dotclear\Plugin\DotclearWatch;
use Dotclear\Core\Process;
/**
* @brief DotclearWatch install class.
* @ingroup DotclearWatch
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
class Install extends Process
{
public static function init(): bool
@ -22,8 +25,9 @@ class Install extends Process
public static function process(): bool
{
if (self::status()) {
My::settings()->put(
$s = My::settings();
if (self::status() && $s !== null) {
$s->put(
'hidden_modules',
'DotclearWatch',
'string',
@ -31,7 +35,7 @@ class Install extends Process
false,
true
);
My::settings()->put(
$s->put(
'distant_api_url',
'https://dotclear.watch/api',
'string',

View File

@ -1,19 +1,27 @@
<?php
/**
* @brief DotclearWatch, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christain Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1);
namespace Dotclear\Plugin\DotclearWatch;
use Dotclear\App;
use Dotclear\Module\MyPlugin;
/**
* @brief DotclearWatch My helper.
* @ingroup DotclearWatch
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
class My extends MyPlugin
{
// Use default permissions
protected static function checkCustomContext(int $context): ?bool
{
return $context === My::INSTALL ? null :
defined('DC_CONTEXT_ADMIN') && App::auth()->isSuperAdmin();
}
}

View File

@ -1,66 +0,0 @@
<?php
declare(strict_types=1);
namespace Dotclear\Plugin\DotclearWatch;
use Dotclear\Core\Process;
use Dotclear\Plugin\Uninstaller\Uninstaller;
/**
* @brief DotclearWatch uninstall class.
* @ingroup DotclearWatch
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
class Uninstall extends Process
{
public static function init(): bool
{
return self::status(My::checkContext(My::UNINSTALL));
}
public static function process(): bool
{
if (!self::status()) {
return false;
}
Uninstaller::instance()
->addUserAction(
'settings',
'delete_all',
My::id()
)
->addUserAction(
'plugins',
'delete',
My::id()
)
->addUserAction(
'versions',
'delete',
My::id()
)
->addDirectAction(
'settings',
'delete_all',
My::id()
)
->addDirectAction(
'plugins',
'delete',
My::id()
)
->addDirectAction(
'versions',
'delete',
My::id()
)
;
// no custom action
return false;
}
}

View File

@ -1,5 +1,15 @@
<?php
/**
* @brief DotclearWatch, a plugin for Dotclear 2
*
* @package Dotclear
* @subpackage Plugin
*
* @author Jean-Christian Denis and contributors
*
* @copyright Jean-Christain Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
declare(strict_types=1);
namespace Dotclear\Plugin\DotclearWatch;
@ -10,48 +20,21 @@ use Dotclear\Helper\Network\HttpClient;
use Dotclear\Module\ModuleDefine;
use Exception;
/**
* @brief DotclearWatch utils class.
* @ingroup DotclearWatch
*
* @author Jean-Christian Denis
* @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
*/
class Utils
{
/**
* The expiration delay before resend report (one week).
*
* @var int EXPIRED_DELAY
*/
/** @var int The expiration delay before resend report (one week) */
public const EXPIRED_DELAY = 604800;
/**
* The default distant API URL.
*
* @var string DISTANT_API_URL
*/
/** @var string The default distant API URL */
public const DISTANT_API_URL = 'https://dotclear.watch/api';
/**
* The distant API version.
*
* @var string DISTANT_API_VERSION
*/
/** @var string The distant API version */
public const DISTANT_API_VERSION = '1.1';
/**
* The hiddens modules IDs.
*
* @var array<int,string> $hiddens
*/
/** @var array<int,string> The hiddens modules IDs */
private static array $hiddens = [];
/**
* Multiblog unique identifiant.
*
* @var string $uid
*/
/** @var string Multiblog unique identifiant */
private static string $uid = '';
/**
@ -91,7 +74,7 @@ class Utils
if ($strict && in_array($define->getId(), $hiddens)) {
continue;
}
$modules[(string) $define->getId()] = (string) $define->get('version');
$modules[$define->getId()] = $define->get('version');
}
return $modules;
@ -117,7 +100,7 @@ class Utils
if ($strict && in_array($define->getId(), $hiddens)) {
continue;
}
$modules[(string) $define->getId()] = (string) $define->get('version');
$modules[$define->getId()] = $define->get('version');
}
return $modules;
@ -255,24 +238,14 @@ class Utils
}
}
/**
* Check if report can be done.
*
* @return bool True if it can
*/
private static function check(): bool
{
return true; // not yet
return defined('DC_CRYPT_ALGO');
}
/**
* Get report key.
*
* @return string The report key
*/
private static function key(): string
{
return Crypt::hmac(self::uid() . My::id(), App::config()->cryptAlgo());
return Crypt::hmac(self::uid() . My::id(), DC_CRYPT_ALGO);
}
private static function uid(): string
@ -288,21 +261,11 @@ class Utils
return self::$uid;
}
/**
* Get blog report uid.
*
* @return string The blog report uid
*/
private static function buid(): string
{
return md5(self::uid() . App::blog()->uid());
}
/**
* Get query URL.
*
* @return string The URL
*/
private static function url(): string
{
$api_url = My::settings()->getGlobal('distant_api_url');
@ -310,9 +273,6 @@ class Utils
return (is_string($api_url) ? $api_url : self::DISTANT_API_URL) . '/' . self::DISTANT_API_VERSION . '/%s/' . self::uid();
}
/**
* Clear report logs.
*/
private static function clear(): void
{
$rs = App::log()->getLogs([
@ -333,9 +293,6 @@ class Utils
App::log()->delLogs($logs);
}
/**
* Log error.
*/
private static function error(string $message): void
{
self::clear();
@ -347,9 +304,6 @@ class Utils
App::log()->addLog($cur);
}
/**
* Write report.
*/
private static function write(string $contents): void
{
self::clear();
@ -361,11 +315,15 @@ class Utils
App::log()->addLog($cur);
}
/**
* Check if report is expired.
*
* @return bool True if expired
*/
private static function read(): string
{
$rs = App::log()->getLogs([
'log_table' => My::id() . '_report',
]);
return $rs->isEmpty() || !is_string($rs->f('log_msg')) ? '' : $rs->f('log_msg');
}
private static function expired(): bool
{
$rs = App::log()->getLogs([
@ -375,11 +333,6 @@ class Utils
return $rs->isEmpty() || !is_string($rs->f('log_dt')) || (int) strtotime($rs->f('log_dt')) + self::EXPIRED_DELAY < time();
}
/**
* Get report content.
*
* @return string Teh report content
*/
private static function contents(): string
{
// Build json response
@ -396,13 +349,12 @@ class Utils
'count' => (int) App::blogs()->getBlogs([], true)->f(0),
],
'core' => [
'version' => App::config()->dotclearVersion(),
'version' => DC_VERSION,
],
'server' => self::getServer(),
'php' => [
'sapi' => php_sapi_name() ?: 'php',
'version' => PHP_VERSION,
'minor' => PHP_MAJOR_VERSION . '.' . PHP_MINOR_VERSION,
'version' => phpversion(),
],
'system' => [
'name' => php_uname('s'),