Attention La mise à jour depuis la version 2.34 provoquera une erreur pendant le processus. Il suffit de recharger la page actuelle dans votre navigateur pour terminer la mise à jour. Cela n'endommagera rien.

Message d'erreur affiché pendant la mise à jour

Ah aussi, si vos widgets ont soudain disparu, installez le plugin suivant (installation manuelle) : blogrollLinkStatus, puis une fois l'installation effectuée retournez sur la page d'accueil du tableau de bord. Vous devriez alors avoir une notification de la mise à jour du plugin blogroll. Vous pouvez alors désinstaller le plugin blogrollLinkStatus.

Pensez à vider le cache des templates (plugin Entretien) une fois les mises à jour effectuées.

Pour rappel si vous avez besoin d'aide, un salon Matrix vous tend les bras : https://matrix.to/#/#dotclear:matrix.org

Une nouvelle version de votre logiciel de blog préféré avec au menu :

  • Une nouvelle façon de modifier les thèmes (voir ci-dessous les explications détaillées).
  • Une proposition de réinitialiser l'URL de l'entrée en cours d'édition si vous changez sa date de publication (seulement si l'entrée n'a pas déjà été publiée).
  • L'ajout d'une option pour publier immédiatement un commentaire reconnu comme non-spam même si les commentaires sont modérés a priori.
  • Quelques optimisations (mises à jour des plugins, affichage de la médiathèque, …).
  • L'ajout d'une entête pour empêcher l'indexation de vos contenus par les IA (aucune garantie cela dit qu'elles respectent ce réglage).
  • La gestion des thèmes sombres/clairs dans l'administration a été revue.
  • Ajout d'un champ dans le panneau de don sur le tableau de bord pour enregistrer la date de votre dernier don de soutien à Dotclear, d'ailleurs, … :-).
  • Ajout d'une page qui fournit la liste de tous les plugins installés (et actifs) avec leurs liens de réglage respectif.
  • Suppression d'une étape inutile à la fin de la mise à jour (vous verrez ça à la mise à jour suivante).

Le détail est décrit dans le fichier CHANGELOG fourni avec la version.

Adaptation des thèmes

Cette version apporte un changement significatif dans la gestion des thèmes.

En effet, à partir de cette version, les modifications apportées via l'éditeur de thème seront stockées dans un répertoire spécifique associé au blog courant et au thème sélectionné1.

Avantages :

  • Plus besoin de se poser la question de savoir si on peut mettre à jour un thème, qui je le rappelle, écrase entièrement le précédent, modifications comprises.
  • Retour de la « modification », qui devient une surcharge plutôt qu'une modification, des thèmes livrés nativement avec Dotclear.

Inconvénients :

  • Les anciens thèmes ne seront plus modifiables avec l'éditeur de thème, et resteront figés dans l'état où ils se trouvent.
  • Les thèmes qui pourront être dorénavant modifiables devront être adaptés de la manière décrite ci-dessous.

Pour résumer, plus de liberté avec les nouveaux thèmes fournis ou adaptés et les anciens thèmes continueront à fonctionner comme avant.

La suite concerne les développeuses et développeurs de thèmes ou les personnes averties qui voudraient s'en charger.

Pour les autres vous pouvez ignorer la suite.

Maintenant que faire pour adapter un thème pour Dotclear 2.35 ?

Premièrement, ajouter une ligne dans le fichier _define.php. Je prends l'exemple du thème Berlin, son fichier _define.php est maintenant le suivant (j'ai volontairement omis les commentaires) :

<?php
$this->registerModule(
    'Berlin',                      // Name
    'Dotclear 2.7+ default theme', // Description
    'Dotclear Team',               // Author
    '2.0',                         // Version
    [                              // Properties
        'type'     => 'theme',
        'tplset'   => 'dotty',
        'overload' => true,
    ]
);

La nouvelle ligne est celle qui contient 'overload' => true,. Avec cette ligne vous permettez la modification (surcharge) des fichiers de votre thème.

De plus, si dans votre ou vos feuilles de style vous utilisez la fonction url(...), en utilisant un chemin vers un fichier (image, police de caractère, autre feuille de style, …) il faudra alors modifier le paramètre en le faisant précéder de index.php?tf=.

Deux exemples :

.header {
  background-image: url(images/header.jpg);
}

Deviendra :

.header {
  background-image: url(index.php?tf=images/header.jpg);
}

Autre exemple (celui-ci utilise des quotes, qui sont optionnelles) :

@import url('layout.css');

Deviendra :

@import url('index.php?tf=layout.css');

Notez que la forme index.php?tf= se réfère au « dossier racine » du thème et que vous pouvez utiliser des chemins relatifs par rapport à cette « base », comme dans le 1er exemple.

Enfin du côté du rendu, la priorité est donnée, pour la fourniture des fichiers, à ce qui se trouve dans le dossier de surcharge, puis ensuite dans celui du thème, puis ensuite, s'il en est défini un, dans celui du parent du thème et finalement dans celui du jeu de template associé au thème.

Dit plus simplement : surcharge > thème > thème parent > jeu de template.

Si vous surchargez un des fichiers PHP du répertoire src du thème, veillez à surcharger aussi le fichier Frontend.php, même sans le modifier ; il sera nécessaire pour ça fonctionne correctement.

En ce qui concerne les fichiers template, les balises {{tpl:BlogThemeURL}} et {{tpl:BlogParentThemeURL}} utiliseront dorénavant la forme index.php?tf= dans le cas des thèmes adaptés au lieu d'une URL directe comme précédemment.

  1. Ces surcharges seront stockées dans le répertoire var sous l'arborescence themes/blog_id/theme_id, blog_id étant remplacé par l'identificateur du blog et theme_id par celui du thème sélectionné pour ce blog. ↩