DotclearWatch / Blog - Mot-clé - class

Déplacement de classes

Jean-Christian Denis — Fri, 13 Oct 2023 08:00:00 +0200

La version 2.28 de Dotclear continuant la transition vers les espaces de noms PHP, la plupart des classes restantes dans le répertoire inc a été déplacée vers le dossier src.

Voici la liste des classes changeant de nom dans cette version.

Frontend :

    'dcTemplate'    => 'Dotclear\Core\Frontend\Tpl',
    'dcUrlHandlers' => 'Dotclear\Core\Frontend\Url',
    'context'       => 'Dotclear\Core\Frontend\Ctx',

    'rsExtPostPublic'    => 'Dotclear\Schema\Extension\PostPublic',
    'rsExtCommentPublic' => 'Dotclear\Schema\Extension\CommentPublic',

Core :

    'dcAuth' => 'Dotclear\Core\Auth',
    'dcBlog' => 'Dotclear\Core\Blog',
    'dcCategories'   => 'Dotclear\Core\Categories',
    'dcDeprecated' => 'Dotclear\Core\Deprecated',
    'dcError'        => 'Dotclear\Core\Error',
    'dcLog'          => 'Dotclear\Core\Log',
    'dcMedia'        => 'Dotclear\Core\Media',
    'dcMeta'         => 'Dotclear\Core\Meta',
    'dcModuleDefine' => 'Dotclear\Module\ModuleDefine',
    'dcModules'      => 'Dotclear\Module\Modules',
    'dcNamespace'    => 'Dotclear\Core\BlogWorkspace',
    'dcNotices'      => 'Dotclear\Core\Notice',
    'dcPlugins'   => 'Dotclear\Module\Plugins',
    'dcPostMedia'    => 'Dotclear\Core\PostMedia',
    'dcPrefs'        => 'Dotclear\Core\UserPreferences',
    'dcRestServer'   => 'Dotclear\Core\Rest',
    'dcSettings'     => 'Dotclear\Core\BlogSettings',
    'dcStore'       => 'Dotclear\Module\Store',
    'dcStoreParser' => 'Dotclear\Module\StoreParser',
    'dcStoreReader' => 'Dotclear\Module\StoreReader',
    'dcThemes'      => 'Dotclear\Module\Themes',
    'dcTrackback'    => 'Dotclear\Core\Trackback',
    'dcUpdate' => 'Dotclear\Core\Backend\Update',
    'dcWorkspace'    => 'Dotclear\Core\UserWorkspace',
    'dcXmlRpc' => 'Dotclear\Core\Frontend\XmlRpc',

    'rsExtPost'    => 'Dotclear\Schema\Extension\Post',
    'rsExtComment' => 'Dotclear\Schema\Extension\Comment',
    'rsExtDates'   => 'Dotclear\Schema\Extension\Dates',
    'rsExtUser'    => 'Dotclear\Schema\Extension\User',
    'rsExtBlog'    => 'Dotclear\Schema\Extension\Blog',

    'dcTraitDynamicProperties' => 'Dotclear\Helper\TraitDynamicProperties',

Nouvelles classes ;

Dotclear\Core\Blogs => App::blogs()
Dotclear\Core\Cache => App::cache()
Dotclear\Core\Filter => App::filter()
Dotclear\Core\Formater => App::formater()
Dotclear\Core\Nonce => App::nonce()
Dotclear\Core\PostType => new PostType(type, admin_url, public_url, label);
Dotclear\Core\PostTypes => App::postTypes()
Dotclear\Core\Users => App::users()
Dotclear\Core\Version => App::version()

Plugins

Avec la nouvelle gestion des permissions des modules, leurs constantes se sont déplacées

initBlogroll::PERMISSION_BLOGROLL => \Dotclear\Plugin\blogroll\Blogroll::PERMISSION_BLOGROLL
initBlogroll::LINK_TABLE_NAME => \Dotclear\Plugin\blogroll\Blogroll::LINK_TABLE_NAME
initAntispam::SPAMRULE_TABLE_NAME => \Dotclear\Plugin\antispam\Antispam::SPAMRULE_TABLE_NAME
initPages::PERMISSION_PAGES => \Dotclear\Plugin\pages\Pages::PERMISSION_PAGES

En savoir plus :

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

Déplacement de classes

Jean-Christian Denis — Wed, 12 Jul 2023 20:10:00 +0100

Pour cette version 2.27, continuant la transition vers les espaces de noms PHP, de nombreuses classes dont principalement celles d'administration se sont vues déplacer dans le dossier src.

Voici la liste des classes changeant de nom dans cette version.

Pour la partie administration :

    'adminBlogFilter'      => 'Dotclear\Core\Backend\Filter\FilterBlogs',
    'adminBlogList'        => 'Dotclear\Core\Backend\Listing\ListingBlogs',
    'adminCommentFilter'   => 'Dotclear\Core\Backend\Filter\FilterComments',
    'adminCommentList'     => 'Dotclear\Core\Backend\Listing\ListingComments',
    'adminGenericFilterV2' => 'Dotclear\Core\Backend\Filter\Filters',
    'adminGenericListV2'   => 'Dotclear\Core\Backend\Listing\Listing',
    'adminMediaFilter'     => 'Dotclear\Core\Backend\Filter\FilterMedia',
    'adminMediaList'       => 'Dotclear\Core\Backend\Listing\ListingMedia',
    'adminMediaPage'       => 'Dotclear\Core\Backend\MediaPage',
    'adminModulesList'     => 'Dotclear\Core\Backend\ModulesList',
    'adminPostFilter'      => 'Dotclear\Core\Backend\Filter\FilterPosts',
    'adminPostList'        => 'Dotclear\Core\Backend\Listing\ListingPosts',
    'adminPostMiniList'    => 'Dotclear\Core\Backend\Listing\ListingPostsMini',
    'adminUserFilter'      => 'Dotclear\Core\Backend\Filter\FilterUsers',
    'adminUserList'        => 'Dotclear\Core\Backend\Listing\ListingUsers',
    'adminThemesList'      => 'Dotclear\Core\Backend\ThemesList',
    'adminUserPref'        => 'Dotclear\Core\Backend\UserPref',
    'dcActions'            => 'Dotclear\Core\Backend\Action\Actions',
    'dcAdmin'              => 'Dotclear\Core\Backend\Utility',
    'dcAdminBlogPref'      => 'Dotclear\Core\Backend\BlogPref',
    'dcAdminCombos'        => 'Dotclear\Core\Backend\Combos',
    'dcAdminFilter'        => 'Dotclear\Core\Backend\Filter\Filter',
    'dcAdminFilters'       => 'Dotclear\Core\Backend\Filter\FiltersLibrary',
    'dcAdminHelper'        => 'Dotclear\Core\Backend\Helper',
    'dcAdminNotices'       => 'Dotclear\Core\Backend\Notices',
    'dcAdminURL'           => 'Dotclear\Core\Backend\Url',
    'dcBlogsActions'       => 'Dotclear\Core\Backend\Action\ActionsBlogs',
    'dcCommentsActions'    => 'Dotclear\Core\Backend\Action\ActionsComments',
    'dcPostsActions'       => 'Dotclear\Core\Backend\Action\ActionsPosts',
    'dcFavorites'          => 'Dotclear\Core\Backend\Favorites',
    'dcMenu'               => 'Dotclear\Core\Backend\Menu',
    'dcPage'               => 'Dotclear\Core\Backend\Page',
    'dcPager'              => 'Dotclear\Core\Backend\Listing\Pager',
    'dcThemeConfig'        => 'Dotclear\Core\Backend\ThemeConfig',

Pour la partie publique :

    'dcPublic' => 'Dotclear\Core\Frontend\Utility',

Pour la partie Core :

    'dcNsProcess' => 'Dotclear\Core\Process',
    'dcUpgrade' => 'Dotclear\Core\Upgrade\Upgrade',

Pour utiliser ces classes il faut ajouter en début de fichier la déclaration use suivi du nom complet de la classe.
Par exemple :

<?php
use Dotclear\Core\Backend\Notices;

// dcAdminNotices::addSuccessNotice(__('Youhou'));
Notices::addSuccessNotice(__('Youhou'));

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

La class Process

Jean-Christian Denis — Tue, 11 Jul 2023 20:41:00 +0100

La classe Process introduite dans les dernières versions de Dotclear devient la norme et est requise quasi partout depuis Dotclear 2.27.

La plupart des classes de plugins et thèmes doivent étendre la classe Process, pour cela il suffit de déclarer son utilisation en début de fichier puis d'étendre votre classe.

<?php
use Dotclear\Core\Process;

class Manage extends Process
{
}

Cette classe est pour l'instant très succincte mais permet de découper le déroulement du script en trois parties.

Première partie

Elle utilise la méthode Process::init() elle permet de vérifier les droits à utiliser votre classe. Elle utilise un mécanisme mémorisant le statut de cette initialisation, verrouillant ou non l'utilisation des méthodes suivantes.

public static function init(): bool
{
    // On enregistre la permissions d'utiliser la classe et on renvoie le résultat
    return self::status(My::checkContext(My::MANAGE));
}

On voit ici l'utilisation de la classe My qui est un outil d'aide à l'écriture des modules simplifiant l'utilisation de certains mécanismes.

Seconde partie

Elle utilise la méthode Process::process() qui est consacrée à la préparation et au traitement des données, telles que celles des formulaires par exemple.

public static function process(): bool
{
    // On vérifie le droit d'effectuer cette partie
    if (!self::status()) {
        return false;
    }

    if (!empty($_POST['id'])) {
        // traitement de mon formulaire

        // On a réussi, on ajoute un message
        Notices::addSuccessNotice(__('Victory'));
        // On redirige vers la page du plugin
        dcCore::->admin->url->redirect('admin.plugin.' . My::id());
    }

    // Cette méthode doit retourner true si on veut exécuter la troisième partie
    return true;
}

La troisième partie

Elle utilise la méthode Process::render() qui est consacré au rendu. C'est à dire à l'affichage dans le navigateur.

public static function render(): void
{
    // On vérifie le droit d'effectuer cette partie
    if (!self::status()) {
        return;
    }

    // On prépare l'affichage du haut de page
    Page::openModule(My::name());

    // On ajoute le menu façon Dotclear
    echo
    Page::breadcrumb(
        [
            __('Plugin')  => '',
            My::name() => '',
        ]
    ) .
    // On affiche d'éventuelle messages
    Notices::getNotices();

    // On ajoute le contenu de la page
    echo __('yeah!');

    // On ajoute l'aide de la page
    Page::helpBlock(My::id());

    // On ferme la page
    Page::closeModule();
}

Ici on voit l'utilisation des classes d'outils My et Page qui vont grandement faciliter l'écriture des plugins et thèmes.

A noter que seule la première méthode init() est obligatoire. Si elle renvoie true, c'est que la classe ne contient pas de méthode process(), la méthode render() sera exécuté.

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