DotclearWatch / Blog - Mot-clé - update

Mise à jour bloquée

Jean-Christian Denis — Sun, 27 Oct 2024 09:22:00 +0100

Il se peut que la mise à jour de Dotclear ne puisse aboutir si des fichiers de votre installation ont été modifiés. Ce n'est pas forcément grave, un outil est là pour palier à ce problème.

Mise à jour bloquée par le digests

La mise à jour de Dotclear compare les fichiers de son installation pour vérifier qu'ils n'ont pas été modifiés. Si c'est le cas la mise à jour est alors impossible. Cela est normal, vous pouvez avoir volontairement modifié des choses sur votre installation et cela évite d'écraser ces modifications. Mais cela peut également être dû à votre hébergeur qui ferait des blagues ou encore un fausse manipulation de votre part.
Lors de la mise à jour, Dotclear vous prévient que certains fichiers ont été modifiés et empêche la mise à jour, le nouveau Tableau de bords de mise à jour contient un outil permettant de passer outre cette restriction, il suffit de se rendre dans l'onglet Digests et de suivre les instructions, une liste des fichiers potentiellement modifiés est présente permettant de vérifier ce qui va être écrasé. On peut alors ensuite forcer Dotclear à ignorer ces modifications et faire la mise à jour. A noter que tous ces fichiers seront écrasés.

Voici une petite animation pour voir le processus dans son entier:

Forcer la mise à jour

Gestion de mises à jour

Jean-Christian Denis — Sun, 11 Feb 2024 10:10:00 +0100

La version 2.29 de Dotclear embarque un nouveau tableau de bord exclusivement dédié à la gestion des mises à jour.

Tout ce qui est lié aux mises à jour de Dotclear (et des plugins) est désormais disponible dans un tableau de bord à part où il est possible de vider les différents caches de Dotclear, de choisir des mises à jour intermédiaires (si disponibles), de rejouer des mises à jour, de gérer les sauvegardes, de passer outre les fichiers altérés, de mettre à jour des plugins. Ce tableau de bord fonctionne exclusivement comme le mode sans échec des versions précédentes, c'est à dire qu'il ne charge aucun plugin.

Tableau de bord de mises à jour, févr. 2024

Ce tableau de bord est disponible en suivant le lien depuis le menu "Mise à jour" du tableau de bord normal. Vous serez également redirigé vers ce tableau de bord si une mise à jour est disponible.

Liens vers le tableau de bord de mises à jour, févr. 2024

Une fois la mise à jour effectuée vous êtes déconnecté de l'interface d'administration comme auparavant à ceci près que vous atterrissez sur la page de login du tableau de bord de mises à jour. Un lien en bas de cette page permet de revenir au tableau de bord normal.

Connexion au tableau de bord de mises à jour, févr. 2024

Un lien en haut du tableau de bord de mises à jour permet également de revenir au tableau de bord normal.

Le contenu de ce document a été écrit suivant le code de la version 2.29 de Dotclear.

Fichier Install d'un module

Jean-Christian Denis — Sun, 16 Jul 2023 20:51:00 +0100

Le fichier Install.php, placé dans le dossier src du module, permet d'effectuer ses opérations d'installation et de mise à jour.

Le fichier Install.php fait partie du processus reconnu par le gestionnaire de modules, il est donc automatiquement pris en compte coté admin si il existe.

Il est placé dans le sous dossier src du module,
Il contient une classe du nom de Install,
Il est dans l'espace de nom PHP Dotclear\Plugin\monPlugin ou Dotclear\Theme\monTheme,
La classe doit étendre la classe Process,
Seules les méthodes init() et process() sont utilisées,

Ce fichier est chargé en préambule de la page d'accueil de l'admin, de la page de gestion de l'apparence du blog, et de la page de gestion des plugins. Généralement il permet d'enregistrer des paramètres, de créer des tables, etc.
La méthode init() de la classe doit vérifier que la version installée n'existe pas ou qu'elle est à mettre à jour, elle doit renvoyer false si il n'y a pas besoin d'effectuer ces opérations d'installation / mise à jour. Pour aider, la classe My embarque un contexte qui permet cela My::checkContext(My::INSTALL).

Exemple du plugin blogroll de la distribution qui ajoute une table à la base de données :

<?php
declare(strict_types=1);

namespace Dotclear\Plugin\blogroll;

use dcCore;
use Dotclear\Core\Process;
use Dotclear\Database\Structure;
use initBlogroll;

class Install extends Process
{
    public static function init(): bool
    {
        return self::status(My::checkContext(My::INSTALL));
    }

    public static function process(): bool
    {
        if (!self::status()) {
            return false;
        }

        $schema = new Structure(dcCore::app()->con, dcCore::app()->prefix);

        $schema->{initBlogroll::LINK_TABLE_NAME}
            ->link_id('bigint', 0, false)
            ->blog_id('varchar', 32, false)
            ->link_href('varchar', 255, false)
            ->link_title('varchar', 255, false)
            ->link_desc('varchar', 255, true)
            ->link_lang('varchar', 5, true)
            ->link_xfn('varchar', 255, true)
            ->link_position('integer', 0, false, 0)

            ->primary('pk_link', 'link_id')
            ->index('idx_link_blog_id', 'btree', 'blog_id')
            ->reference('fk_link_blog', 'blog_id', 'blog', 'blog_id', 'cascade', 'cascade')
        ;

        (new Structure(dcCore::app()->con, dcCore::app()->prefix))->synchronize($schema);

        return true;
    }
}

Le contenu de ce document a été écrit suivant le code de la version 2.27 de Dotclear.