Vérificateur de version - Coppermine Photo Gallery - Documentation & manuel

# Coppermine Photo Gallery v1.5.x: Documentation et manuel

# Vérificateur de version

Uniquement pour les questions faites par des développeurs liés à la vérification de version.

## Fonctionnalité cachée

Dans les versions antérieures à la version cpg1.5.x il était relativement difficile de mettre à jour les informations de version quand un nouveau pack allait être publié, puisque celà devait passer par un changement manuel. Dans cpg1.5.x (révision 3977 et plus tard), l'opération est simplifiée puisqu’il suffit d’ajouter le paramètre `?output=create` à l'URL pour forcer le script à faire une boucle sur les entrées existantes et mettre à jour la version / révision / hachage MD5. Vous n'avez qu'à copier la sortie de l'écran et la coller dans include/cpg15x.files.xml

Une autre fonctionnalité "caché" est la possibilité d'intégrer le résultat dans une autre page de Coppermine afin de permettre une vérification initiale devant être réalisée durant la première installation.

Cependant, quelque chose doit être fait manuellement: si les dossiers/fichiers sont ajoutés au svn ou renommé, le changement doit se refléter dans le fichier XML également.

## Structure XML

Le fichier XML est mis à jour lorsque vous utilisez le paramètre `?output=create` mais chaque développeur qui fait l'ajout d'un nouveau fichier dans le dépôt SVN est responsable de faire une entrée correspondante dans le fichier XML. La structure XML devrait être explicite d’elle même. Voici une liste des entrées possibles:

- `<fullpath> ... <fullpath>`
  Le chemin d'accès complet relatif au fichier en question, vu dans le dossier racine de Coppermine. Les dossiers doivent avoir une barre oblique. Un espaces réservés possibles: `**fullpath**` sera remplacé par le dossier albums - pour une installation par défaut, ce serait`albums`; `**userpics**` sera remplacé par le dossier userpics dans la configuration.
- `<version> ... </version>`
  Le numéro de version dans l'en-tête. S'applique uniquement pour les fichiers texte - les noms de dossiers et les fichiers binaires ne peuvent pas avoir de numéro de version.
- `<revision> ... </revision>`
  Le numéro de révision SVN dans l'en-tête. S'applique uniquement pour les fichiers texte - les noms de dossiers et les fichiers binaires ne peuvent pas avoir un numéro de version.
- `<status> ... </status>`
  Actuellement, il ya trois valeurs possibles: mandatory, optional, remove. Si un fichier est marqué comme "remove", l'utilisateur exécutant le vérificateur de version sera notifiée que le fichier doit être supprimé pour des raisons de sécurité. Cette initiative vise à faire en sorte que nous n'ayons pas à avoir de fichiers obsolètes d’anciennes versions avec nous.
- `<permission> ... </permission>`
  Les valeurs possibles: lire, écrire. Ne doivent être réglées spécifiquement que pour les dossiers qui doivent être accessibles en écriture.
- `<hash> ... </hash>`
  Le MD5-hash du fichier est destiné à nous assurer que les fichiers n’ont pas été corrompus ou altéré. Cela Ne fonctionne pas sur toutes les plateformes. La valeur est créée lors de l’étape output=create.

## Liste des choses à faire

- Ajouter des icônes d’aides avec les explications correspondantes.