improve/_install.php

<?php
/**
 * @brief improve, a plugin for Dotclear 2
 *
 * @package Dotclear
 * @subpackage Plugin
 *
 * @author Jean-Christian Denis and contributors
 *
 * @copyright Jean-Christian Denis
 * @copyright GPL-2.0 https://www.gnu.org/licenses/gpl-2.0.html
 */
declare(strict_types=1);

namespace plugins\improve;

if (!defined('DC_CONTEXT_ADMIN')) {
    return;
}

/* dotclear */
use dcCore;
use dcUtils;

/* php */
use Exception;

/**
 * Improve install class
 *
 * Set default settings and version
 * and manage changes on updates.
 */
class install
{
    /** @var array Improve default settings */
    private static $default_settings = [[
        'disabled',
        'List of hidden action modules',
        'tab;newline;endoffile',
        'string',
    ]];

    public static function process(): ?bool
    {
        if (!self::checkModuleVersion()) {
            return null;
        }
        if (!self::checkDotclearVersion()) {
            throw new Exception(sprintf(
                '%s requires Dotclear %s',
                'improve',
                self::getDotclearVersion()
            ));
        }

        dcCore::app()->blog->settings->addNamespace('improve');
        self::update_0_8_0();
        self::putSettings();
        self::setVersion();

        return true;
    }

    private static function getDotclearVersion(): string
    {
        return dcCore::app()->plugins->moduleInfo('improve', 'requires')[0][1];
    }

    private static function getInstalledVersion(): string
    {
        $version = dcCore::app()->getVersion('improve');

        return is_string($version) ? $version : '0';
    }

    private static function checkModuleVersion(): bool
    {
        return version_compare(
            self::getInstalledVersion(),
            dcCore::app()->plugins->moduleInfo('improve', 'version'),
            '<'
        );
    }

    private static function checkDotclearVersion(): bool
    {
        return method_exists('dcUtils', 'versionsCompare')
            && dcUtils::versionsCompare(DC_VERSION, self::getDotclearVersion(), '>=', false);
    }

    private static function putSettings(): void
    {
        foreach (self::$default_settings as $v) {
            dcCore::app()->blog->settings->improve->put(
                $v[0],
                $v[2],
                $v[3],
                $v[1],
                false,
                true
            );
        }
    }

    private static function setVersion(): void
    {
        dcCore::app()->setVersion('improve', dcCore::app()->plugins->moduleInfo('improve', 'version'));
    }

    /** Update improve < 0.8 : action modules settings name */
    private static function update_0_8_0(): void
    {
        if (version_compare(self::getInstalledVersion(), '0.8', '<')) {
            foreach (dcCore::app()->blog->settings->improve->dumpGlobalSettings() as $id => $values) {
                $newId = str_replace('ImproveAction', '', $id);
                if ($id != $newId) {
                    dcCore::app()->blog->settings->improve->rename($id, strtolower($newId));
                }
            }
        }
    }
}

/* process */
try {
    return install::process();
} catch (Exception $e) {
    dcCore::app()->error->add($e->getMessage());

    return false;
}