Dotclear

Still gardening and happy tooyou Kozlika!

Comme annoncé à l'occasion de la sortie de la 2.19, nous publions plus souvent — ou tout au moins nous nous efforçons de — les nouvelles versions.

Dans cette nouvelle version 2.20, les éléments marquants sont les suivants :

• Un nouveau système de dépôt alternatif a été mis en place pour les plugins et les thèmes tiers, ce qui peut rendre service si le serveur DotAddict a des vapeurs, comme ça lui est arrivé récemment (merci Noé pour la remise en route rapide d'icelui), ou si l'auteur ne souhaite pas déposer son œuvre ailleurs que sur son propre dépôt public. Nous détaillons la procédure à suivre ci-dessous.
• Un nouveau filtre antispam, spécifique à IPv6 (qui commence à être pas mal déployé), est inclus en parallèle avec le filtre propre à IPv4.
• Les utilisatrices et utilisateurs peuvent désormais indiquer plusieurs adresses email et sites web supplémentaires dans leur profil. En effet, certains thèmes permettent de différencier l'auteur d'un billet des autres commentatrices et commentateurs de celui-ci en fonction de cette adresse email, qui peut évoluer dans le temps. Ce système permet donc d'indiquer de nouvelles adresses sans devoir modifier les métadonnées de ses anciens commentaires.
• La syntaxe wiki de Dotclear a été étendue pour permettre l'insertion aisée de bloc HTML details. Une barre verticale en début de ligne, suivie du texte du sommaire est nécessaire pour débuter ce bloc, suivi du contenu libre du bloc, suivi d'une ligne comportant une barre verticale en premier caractère uniquement terminant l'ensemble, soit :

|sommaire du bloc détail (caché par défaut)
    …
contenu de mon bloc
    …
|

À noter : cette version est la dernière à supporter PHP 7.3 ; la prochaine 2.21 nécessitera la version 7.4 minimum de PHP (ou PHP 8). Un message vous avertira sur votre tableau de bord si votre version de PHP est concernée.

Dépôts alternatifs :

Pour mettre en œuvre un dépôt alternatif pour un module, plugin ou thème, il faut deux choses :

1. Une entrée repository dans les propriétés fournies dans le fichier _define.php du module, comme par exemple : 'repository' => 'https://raw.githubusercontent.com/franck-paul/sysInfo/main/dcstore.xml'
2. Un fichier dcstore.xml structuré de la façon suivante, et stocké en concordance avec l'URL fournie ci-dessus :

<modules xmlns:da="http://dotaddict.org/da/">
  <module id="[MODULE_ID]">
    <name>[MODULE NAME]</name>
    <version>[MODULE.VERSION]</version>
    <author>[MODULE AUTHOR]</author>
    <desc>[MODULE DESCRIPTION]</desc>
    <file>[MODULE_ARCHIVE.ZIP]</file>
    <da:dcmin>[MODULE_DOTCLEAR_VERSION_MIN]</da:dcmin>
    <da:details>[MODULE_DETAIL_URL]</da:details>
    <da:support>[MODULE_SUPPORT_URL]</da:support>
  </module>
</modules>

Exemple pour le plugin sysInfo :

<modules xmlns:da="http://dotaddict.org/da/">
  <module id="sysInfo">
    <name>System Information</name>
    <version>1.16.3</version>
    <author>System Information</author>
    <desc>System Information</desc>
    <file>https://github.com/franck-paul/sysInfo/releases/download/1.16.3/plugin-sysInfo-1.16.3.zip</file>
    <da:dcmin>2.19</da:dcmin>
    <da:details>https://open-time.net/docs/plugins/sysInfo</da:details>
    <da:support>https://github.com/franck-paul/sysInfo</da:support>
  </module>
</modules>

Notez que le fichier dcstore.xml n'a pas besoin d'être inclus dans l'archive d'installation du module.

Dès lors qu'un module, indiquant dans son fichier _define.php un dépôt alternatif, sera installé avec la version 2.20 de Dotclear, alors ce dernier consultera aussi ce dépôt pour vérifier l'éventuelle présence d'une nouvelle version.

One more thing!

Il est possible d'enregistrer les paramètres d'insertion par défaut d'un fichier média (image, son, …) utilisés ensuite lors de l'édition des billets et pages. Voir les Paramètres du blog, section « Médias et images ». Il est aussi possible d'enregistrer les paramètres d'insertion courants, au moment de l'insertion d'un média dans un billet.

Ce système est pratique mais il peut être contre-productif dans certains cas.

La version 2.20 de Dotclear prend désormais en compte la présence d'un fichier .mediadef (ou .mediadef.json) structuré de la façon suivante, pour que les réglages précisés dans celui-ci deviennent automatiquement pré-sélectionnés au lieu de ceux enregistrés par défaut pour le blog :

{
"size": "o",
"legend": "none",
"alignment": "center",
"link": false
}

Voilà les valeurs possibles pour les différents réglages :

• size : "sq" pour vignette, "s" pour petite, "m" pour moyenne, "o" pour original
• legend : "none" pour aucune, "title" pour le titre seul, "legend" pour le titre et légende
• alignment : "none" pour aucun, "left" pour aligner à gauche, "right" pour aligner à droite, "center" pour centrer
• link : true avec le lien, false sans le lien vers l'image originale

Vous n'êtes pas obligés de préciser tous les réglages et en cas d'absence d'un ou de plusieurs d'entre eux c'est celui ou ceux enregistrés pour le blog qui seront utilisés.

Par ailleurs ce fichier de pré-réglage n'est valable que pour le dossier dans lequel il est enregistré et donc uniquement les médias qu'il contient.

Conclusion

Pour le reste les curieux pourront aller consulter le détail des modifications dans le fichier CHANGELOG de cette version.

Enjoy!