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.
La discussion continue ailleurs
URL de rétrolien : https://dotclear.watch/trackback/20