Vous êtes ici : [WikiStart Accueil] » [DocumentationLuxbum Documentation] » Comment contribuer ?

[[PageOutline]]
= Liste des contributions possibles =

Cette page liste l'ensemble des contributions possibles '''dès maintenant''' pour le projet luxbum. Vous devez cependant disposer du code source de la version de développement qui n'est pas encore accessible. Si vous êtes intéressé pour aider le projet, prenez contact avec moi et je vous donnerais tout ce qu'il faut pour contribuer correctement.

== Page d'installation : `install.php` ==
Etapes de l'installation :
 1. Vérification des droits sur les dossiers :
  * `conf/`
  * `photos/`
  * `tmp`
 2. Création de la configuration initiale avec un formulaire possédant les champs suivants :
  * Champ: Nom de la galerie
  * Champ pré-rempli: Url d'installation de la galerie
  * Checkbox: Utiliser le `mod_rewrite`
  * Checkbox: Autoriser l'affichage des informations méta
  * Checkbox: Autoriser les commentaires sur les photos/vidéos
  * Checkbox: Autoriser les diaporamas
  * Checkbox: Activer le fondu entre deux photos d'un diaporama
  * Champ: Temps en secondes entre deux photos d'un diaporama
  * Checkbox: Autoriser les sélections
  * Checkbox: Autoriser le téléchargement des sélections
  * Liste déroulante: Template + thème à utiliser 
  * Liste déroulante: Choix du driver de génération d'image en fonction des drivers disponibles sur le système cible
 3. Quand le formulaire est correctement rempli écrire le fichier `conf/config.php`
 4. Supprimer `install.php` et `upgrade.php`

== Page de mise à jour : `upgrade.php` ==
 1. Vérification des droits sur les dossiers :
  * `conf/`
  * `photos/` (récursivement)
  * `tmp`
 2. Importation des commentaires de la base
 3. Suppression du cache des photos : tous les dossiers `apercu` et `vignette`
 4. Importation de la configuration
 5. Suppression des anciens fichiers inutiles du dossier `conf/`
  * à lister
  * à lister
 6. Supprimer `install.php` et `upgrade.php`

== Création de drivers pour la génération des images ==
Luxbum permet d'utiliser différents drivers pour la génération des images. Pour l'instant j'ai écrit les drivers suivants :
 * [http://www.boutell.com/gd/ GD] 1 & 2
 * [http://www.imagemagick.org/ ImageMagick] : appel à system() pour exécuter la commande convert
Bien d'autres façons existent :
 * [http://pecl.php.net/package/imagick/ Imagick] : extension php pour ImageMagick
 * [http://netpbm.sourceforge.net/ NetPBM]
 * [http://mmcc.cx/php_imlib/index.php imlib]
 * d'autres encore ?

La création d'un driver est simple :
 1. Étendre la classe `ImageToolkit`
 2. Implémenter les méthodes suivantes :
{{{
#!php
<?php
function setSrcInfos () {}
function getImageDimensions($path) {}
function createThumb ($img_dest) {}
?>
}}}

Je me suis très largement inspiré de cette page : http://pear.php.net/package/Image_Transform ;)

== Miniature des vidéos ==
Je recherche un composant flash permettant d'extraire la première image d'une vidéo FLV. Ce composant permettrais d'afficher une miniature pour les vidéos plutôt qu'une image prédéfinie. Seulement, je suis incapable d'écrire un tel composant. Déjà, je n'ai pas de windows installé chez moi, encore moins de quoi écrire du flash, et aussi, je n'ai aucune connaissance en flash ! [[BR]]

'''Note de Chloé''' : 
{{{
il faut pas extraire la première image qui souvent sera noire (fade in)     
il faut prendre une image du milieu de la vidéo 
}}}

== Rédaction de documentation sur le wiki ==
 * Documentation utilisateur
 * Documentation technique

== Favicon Luxbum ==
Luxbum n'a pas encore de favicon pour le site et pour la galerie.

== Traductions ==
Dans la version de développement, il est maintenant possible de traduire complètement Luxbum. La traduction se fait exclusivement dans des fichiers de langues. Je serais bien entendu ravi de voir fleurir des traductions :)

= Futures contributions possibles =
Les contributions suivantes seront possibles quand l'état d'avancement de luxbum le permettera :
 * Écriture d'une nouvelle feuille de style pour le manager
 * Écriture de nouveaux templates et de thème de couleurs pour les différents templates