Open Time

On reviendra plus tard sur les disparitions des variables globales, spécifiques à la prochaine 2.24 — jusqu’à présent toutes celles mentionnées précédemment l’étaient déjà (obsolètes) dans la 2.23 —, pour utiliser les nouvelles constantes qui définissent les états des entrées (billets et pages) :

1. dcBlog::POST_PUBLISHED indique un état publié et qui vaut 1
2. dcBlog::POST_UNPUBLISHED indique un état non publié et qui vaut 0
3. dcBlog::POST_SCHEDULED indique un état programmé et qui vaut -1
4. dcBlog::POST_PENDING indique un état en attente et qui vaut -2

Exemple pris dans le code de la page de gestion d’un média :

Avant :

switch ($rs->post_status) {
    case 1:
        $img_status = sprintf($img, __('published'), 'check-on.png');

        break;
    case 0:
        $img_status = sprintf($img, __('unpublished'), 'check-off.png');

        break;
    case -1:
        $img_status = sprintf($img, __('scheduled'), 'scheduled.png');

        break;
    case -2:
        $img_status = sprintf($img, __('pending'), 'check-wrn.png');

        break;
}

Après :

switch ($rs->post_status) {
    case dcBlog::POST_PUBLISHED:
        $img_status = sprintf($img, __('published'), 'check-on.png');

        break;
    case dcBlog::POST_UNPUBLISHED:
        $img_status = sprintf($img, __('unpublished'), 'check-off.png');

        break;
    case dcBlog::POST_SCHEDULED:
        $img_status = sprintf($img, __('scheduled'), 'scheduled.png');

        break;
    case dcBlog::POST_PENDING:
        $img_status = sprintf($img, __('pending'), 'check-wrn.png');

        break;
}

Techniquement pas de différence au niveau de l’exécution du code puisque les constantes conservent les mêmes valeurs qu’auparavant pour les états, mais, d’une part, c’est plus explicite dans le code, par ailleurs ça permet, si besoin, de modifier ces valeurs sans casser le code qui s’en sert.

Notez que ces constantes existent déjà dans la 2.23 (et 2.23.1) et vous pouvez d’ores et déjà les utiliser.

Attention, à partir de ce billet ça ne concerne plus que la version 2.24 de Dotclear, donc prévoyez de modifier ou de rajouter la dépendance dans vos plugins et thèmes si besoin, 'requires' => [['core', '2.24']], !

Suite des nouvelles constantes qui définissent les états des blogs :

1. dcBlog::BLOG_ONLINE indique un état publié et qui vaut 1
2. dcBlog::BLOG_OFFLINE indique un état hors ligne et qui vaut 0
3. dcBlog::BLOG_REMOVED indique un état retiré et qui vaut -1

Exemple :

Avant :

if (dcCore::app()->blog->status == 0) {
    echo '<p class="static-msg">' . __('This blog is offline') . '.</p>';
} elseif (dcCore::app()->blog->status == -1) {
    echo '<p class="static-msg">' . __('This blog is removed') . '.</p>';
}

Après :

if (dcCore::app()->blog->status == dcBlog::BLOG_OFFLINE) {
    echo '<p class="static-msg">' . __('This blog is offline') . '.</p>';
} elseif (dcCore::app()->blog->status == dcBlog::BLOG_REMOVED) {
    echo '<p class="static-msg">' . __('This blog is removed') . '.</p>';
}

Techniquement pas de différence au niveau de l’exécution du code puisque les constantes conservent les mêmes valeurs qu’auparavant pour les états, mais, d’une part, c’est plus explicite dans le code, par ailleurs ça permet, si besoin, de modifier ces valeurs sans casser le code qui s’en sert.