Fichier de dépôt tiers

Jean-Christian Denis — Fri, 14 Jul 2023 20:25:00 +0100

Depuis quelques versions le gestionnaire de modules de Dotclear supporte les dépôts tiers. Le fichier dcstore.xml se trouvant à la racine du module permet de définir ce dépôt.

En réalité l'emplacement de ce fichier n'est pas dans le module mais là où est hébergé le dépôt tiers ! Par commodité et comme souvent le dépôt tiers est un dépôt github en le plaçant dans le module, le développeur garantit qu'il sera présent sur son dépôt.
L'emplacement final de ce fichier est renseigné dans le fichier de définition du module dans le paramètre 'repository'.
Son contenu est écrit en xml et est calqué sur le dépôt officiel Dotaddict.org. Voici l'exemple du plugin tweakStore :

<?xml version="1.0"?>
<modules xmlns:da="http://dotaddict.org/da/">
  <module id="tweakStores">
    <name>Tweak stores</name>
    <version>0.8</version>
    <author>Jean-Christian Denis and Contributors</author>
    <desc>Helper to manage external repositories</desc>
    <file>https://github.com/JcDenis/tweakStores/releases/download/v0.8/plugin-tweakStores.zip</file>
    <da:dcmin>2.26</da:dcmin>
    <da:details>https://plugins.dotaddict.org/dc2/details/tweakStores</da:details>
    <da:support>https://github.com/JcDenis/tweakStores</da:support>
  </module>
</modules>

Pas besoin d'explication sur son contenu, il reprend en grande partie les informations présentes dans define.php du module en ajoutant le lien vers le fichier Zip du module.
N.D.L.R : En théorie un fichier de dépôt tiers pourrait contenir les informations de plusieurs modules, en pratique, je n'ai pas testé.

Il existe des plugins qui permettent de créer automatiquement ce fichier et également des scripts. (Liens non exhaustifs à titre d'exemple.)

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

DotclearWatch / Blog - Mot-clé - plug

Fichier de dépôt tiers