DotclearWatch / Blog - Mot-clé - 2.33

Sortie de Dotclear 2.33

Jean-Christian Denis — Thu, 13 Feb 2025 10:05:00 +0000

Ce jeudi 13 Février 2025 sort la version 2.33 du moteur de blogs Dotclear.

Cette version améliore encore l'aspect graphique de l'interface, elle continue la migration des outils javascript, elle corrige quelques bugs, modifie la gestion des status et enfin ajoute la possibilité d'utiliser les sessions coté publique. On reparle de ces changements dans un billet dédié.

2.33

Jean-Christian Denis — Thu, 13 Feb 2025 10:04:00 +0000

Sortie le 13 Fevrier 2025, cette version de Dotclear ouvre de nouveaux horizons pour les plugins.

Résumé

Beaucoup d'amélioration continue dans cette version avec l'avancement de l'utilisation de Vanilla JS, des Helper\Form, des métadonnée de média... Mais également deux gros changements sur les statuts et le sessions public.

Nouveautés

Amélioration de l'expérience utilisateur coté admin
Amélioration de la gestion des média. (et de leurs métadonnées)
Avancement de l'utilisation de Vanilla JS plutôt que JQuery
Avancement de l'utilisation de Helper/Form coté admin
Ajout d'un behavior coreBlogBeforeGetPostsAddingParameters
Harmonisation et ouverture des status
Outils d'utilisation de session en Frontend
Déplacement des schémas de base de données et de paramètres de blog

Le changelog complet est disponible sur le dépôt.

Aide

Afin de tester les modifications apporté à cette version de Dotclear, je propose 3 petits plugins utilisant ces nouvelles fonctionnalités. Ces plugins n'apportent pas grand chose par eux mêmes mais sont assez simple pour présenter et comprendre ces changements :

Gestion de session publique : FrontendSession
Ajout de status de billet coté admin : Proofreading
Ajout de status de billet et permissions utilisateur coté publique : RestrictedReading

Requête sur les billets

Jean-Christian Denis — Thu, 13 Feb 2025 10:02:00 +0000

La version 2.33 de Dotclear modifie la gestion des status et ouvre les session coté publique apportant des modification dans les requêtes.

L'ouverture des statuts de billets de la version 2.33 de Dotclear oblige a modifier les requêtes liées aux billets, en effet il faut désormais tenir compte qu'il est possible d'avoir de nouveaux statuts encore inconnues jusqu'ici. Par exemple là ou il suffisait de tester si un billet avec un statut POST_PUBLISHED pour l'afficher, maintenant un nouveau statut POST_SUBSCRIBER amené par un plugin pourrait tout à fait avoir le droit d'être également affiché. Pour faciliter cette limite entre billet autorisé et billet restreint, les groupes de status ont une limite de niveau définie à partir de laquelle un billet est considéré comme restreint, c'est la propriété threshold. Elle peut être testé avec :

if (App::status()->post()->isRestricted($rs->post_status)) { }

Mais cela est loin d'être suffisant, la version 2.33 de Dotclear ouvre également les sessions coté publique. On peut alors imaginer qu'un billet sera restreint aux lecteurs lambda du blog mais autorisé aux lecteurs enregistrés coté publique. Le billet peut alors être restreint ou non suivant sont niveau mais également suivant le niveau de l'utilisateur.

Pour faciliter la gestion de ces requêtes complexes et pourvoir d'un coup accorder à nos besoins toutes les requêtes d'une page (il y en a pour les catégories de billets, les tags de billets, etc...) un nouveau behavior fait son apparition : coreBlogBeforeGetPostsAddingParameters. Il va permettre aux plugins d'interagir avec les requêtes de billets de manière globale. A travers ce behavior un plugin peut modifier les paramètres de requête : post_type, post_status, et comment_status. Le plugin va pouvoir ainsi ajouter son post_status à la requête si l'utilisateur est enregistré.

Le plugin d'exemple concret et simple RestrictedReading permet de comprendre la mise en œuvre de ces changements.
Voici le contenu de son fichier Prepend.php :

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

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

        // Ajout d'une nouvelle permission pour les uilisateurs
        App::auth()->setPermissionType(My::USER_PERMISSION, __('Restricted reading'));

        // Ajout d'un nouveau status pour les billets
        if (App::status()->post()->set(
            (new Status(My::POST_STATUS , My::id(), 'Restricted reading', 'Restricted reading (>1)', My::fileURL('icon.svg'))),
        )) {
            // Ajout du behavior de modification des requêtes de billets
            App::behavior()->addBehaviors([
                'coreBlogBeforeGetPostsAddingParameters' => self::coreBlogBeforeGetPostsAddingParameters(...),
            ]);

            return true;
        }

        return false;
    }

    /**
     * Utilisation du behavior pour l'ajout de l'autorisation d'afficher le billet si :
     * * Le billet a le status My::POST_STATUS 
     * * L'utilisateur est enregistré avec la permissions My::USER_PERMISSION
     */
    public static function coreBlogBeforeGetPostsAddingParameters(ArrayObject $params, string|null $arg = null): void
    {
        if (App::task()->checkContext('FRONTEND') && App::auth()->check(My::USER_PERMISSION, App::blog()->id()) === true) {
            if (!isset($params['post_status'])) {
                $params['post_status'] = [];
            }
            if (!is_array($params['post_status'])) {
                $params['post_status'] = [$params['post_status']];
            }

            $params['post_status'][] = My::POST_STATUS;
        }
    }

Grace à ce behavior tout le contenu de la page courante tiendra compte du statut du billet et des permissions de l'utilisateur.%%

Les status

Jean-Christian Denis — Thu, 13 Feb 2025 10:01:00 +0000

La version 2.33 de Dotclear modifie la gestion des status des utilisateurs, blogs, billets, commentaires.

Résumé

Dans les versions précédentes chaque entité utilisait des méthodes et valeurs dédiées et bloquées de status, tout ça éparpillé un peu partout. Depuis la version 2.33, tous ces status utilisent une structure commune et sont ouvert à l'ajout de nouveaux status. Cela a entrainé pas mal de modifications de requêtes et de scripts de vérification pour prendre en compte cette ouverture.

Nouvelles classes

De nouvelles classes regroupant les status d'un groupe sont donc accessibles depuis l'application :

Utilisateurs : App::status()->user()
Blogs : App::status()->blog()
Billets : App::status()->post()
Commentaires : App::status()->comment()

Ces classes contiennent une pile de status, qui sont maintenant des objets.
La classe d'un status contient les propriétés suivantes :

Un niveau level
Un identifiant id
Un nom name (et son pluriel plural_name)
Une icone icon (et sa version foncée icon_dark)
Une option hidden pour le cacher des sélections de formulaire

Pour connaitre toutes les méthodes disponibles pour les groupes de status, les classes sont dans :

src\Helper\Stack\Status (générique)
src\Helper\Stack\Statuses (générique)
src\Schema\Status\Blog.php
src\Schema\Status\Comment.php
src\Schema\Status\Post.php
src\Schema\Status\User.php

Les classes regroupant ces status vont faciliter leur gestion en intégrant tous les outils nécessaires comme les combo, les filtres, les colonnes de tableau, les actions... Le code de Dotclear s'en retrouve simplifié et plus harmonieux à sa lecture.

Utilisation

Récupérer le nom et l'image d'un status de blog :

$name  = App::status()->blog()->name((int) $rs->blog_status);
$image = App::status()->blog()->image((int) $rs->blog_status);

Tester si un billet a un status restreint :

if (App::status()->post()->isRestricted((int) $rs->post_status)) { }

Récupérer le combo d'action sur des commentaires :

echo (new Select('comment_status'))
    ->items(App::status()->comment()->combo())
    ->default((string) $rs->comment_status)
    ->label(new Label(__('Comment status:'), Label::IL_TF))
    ->render();

Exemple d'ajout d'un status aux utilisateurs depuis le plugin FrontendSession :

App::status()->user()->set((new Status(
    My::USER_PENDING , 
    My::id(), 
    'Pending registration', 
    'pending registration (>1)', 
    My::fileURL('icon.svg'))
));

La recherche de status se fait par identifiant ou par niveau sur la plupart des méthodes, ces 3 exemples retourneront le même objet :

$status_online = App::status()->blog()->get(1);
$status_online = App::status()->blog()->get(App::status()->blog()::ONLINE);
$status_online = App::status()->blog()->get('online');

Ces quelques exemples montrent l'harmonisation entre les différents status rencontrés dans Dotclear.
Parmis les changements qui risquent de poser problème à certains plugins, il y a la gestion des status dans les requêtes avec un nouveau behavior coreBlogBeforeGetPostsAddingParameters qui est détaillé dans un article de ce blog.

Dépréciés

Comme souvent, ces changements apportent leur lot de dépréciés.

Core\Backend\Combos::getPostStatusesCombo() : App::status()->post()->combo()
Core\Backend\Combos::getBlogStatusesCombo() : App::status()->blog()->combo()
Core\Backend\Combos::getCommentStatusesCombo() : App::status()->comment()->combo()
Core\Backend\Filter\FilterBlogs::getBlogStatusFilter() : App::status()->blog()->filter()
Core\Backend\Filter\FilterComments::getCommentStatusFilter() : App::status()->comment()->filter()
Core\Backend\Filter\FilterPosts::getPostStatusFilter() : App::status()->post()->filter()
App::blog()::BLOG_ONLINE : App::status()->blog()::ONLINE
App::blog()::BLOG_OFFLINE : App::status()->blog()::OFFLINE
App::blog()::BLOG_REMOVED : App::status()->blog()::REMOVED
App::blog()::BLOG_UNDEFINED : App::status()->blog()::UNDEFINED
App::blog()::POST_PENDING : App::status()->post()::PENDING
App::blog()::POST_SCHEDULED : App::status()->post()::SCHEDULED
App::blog()::POST_UNPUBLISHED : App::status()->post()::UNPUBLISHED
App::blog()::POST_PUBLISHED : App::status()->post()::PUBLISHED
App::blog()::COMMENT_JUNK : App::status()->comment()::JUNK
App::blog()::COMMENT_PENDING : App::status()->comment()::PENDING
App::blog()::COMMENT_UNPUBLISHED : App::status()->comment()::UNPUBLISHED
App::blog()::COMMENT_PUBLISHED : App::status()->comment()::PUBLISHED
App::blog()::getPostStatus($s) : App::status()->post()->name($s)
App::blog()::getAllPostStatus() : App::status()->post()->statuses()
App::blog()::getAllCommentStatus() : App::status()->comment()->statuses()
App::blogs()::getAllBlogStatus() : App::status()->blog()->statuses()
App::blogs()::getBlogStatus($s) : App::status()->blog()->name($s)