Artifact 6f7fe4d5ea1aac37834543c48ec23492fbcb462e:

Wiki page [Garradin] by bohwaz on 2016-02-20 12:52:14.
D 2016-02-20T11:52:14.995
L Garradin
P 4dcc7c834ffc9c1a1c950d46fdaa219a8a43c4a8
U bohwaz
W 3541
Garradin est un gestionnaire d'association libre, développé à l'aide de PHP5 et SQLite3, permettant de gérer les adhérents, archiver les documents, prendre en note les réunions, gérer la comptabilité, générer reçus de dons et d'adhésion, donner à l'association un site web, et bien plus.

Garradin signifie « argent » en Wagiman, dialecte aborigène de l'Australie.

Une description complète du projet est disponible sur [http://dev.kd2.org/garradin/] (copie de la page [about] de ce wiki). Vous y trouverez aussi l'archive à télécharger pour installer Garradin, des captures d'écran, la documentation, etc.

<h3>Utilisation de Garradin</h3>

Garradin a été développé pour les besoins de deux associations au départ mais de nombreuses autres associations l'utilisent aujourd'hui.

Vous pouvez tester et utiliser Garradin sans rien installer sur [http://garradin.eu/]

<h3>Développement du projet :</h3>

  *  On utilise Fossil qui sert de DVCS, wiki, gestionnaire de tickets, etc.
  *  La [Roadmap] pour se faire une idée de ce qui est prévu dans les prochaines versions
  *  Le [Changelog] pour voir ce qui a été fait
  *  Le code est en PHP 5.4, nous changeons de version de PHP avec la version stable de Debian
  *  On utilise SQLite3 comme base de données qui stocke tout : compta, membres, configuration, fichiers, wiki... Ainsi un seul fichier à sauvegarder et à gérer.
  *  On essaye de suivre [https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md|PSR-0] (enfin à peu près) pour le nommage des classes etc.
  *  Convention de code : principalement [https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-1-basic-coding-standard.md|PSR-1] et [https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-2-coding-style-guide.md|PSR-2], enfin pas à la lettre mais globalement (certaines règles ne sont pas des plus pratiques).

<h3>Comment développer avec Garradin ?</h3>

  *  Installer [http://fossil-scm.org/|Fossil], le gestionnaire de version utilisé par Garradin (équivalent de Git mais en mieux)
  *  Cloner le repository dans un nouveau répertoire : fossil clone https://fossil.kd2.org/garradin/ ../garradin.fossil
  *  Ouvrir le repository (va créer les fichiers du trunk) : fossil open ../garradin.fossil
  *  Y'a plus qu'à coder !

<h3>Comment proposer un patch ?</h3>

  *  Créer sa propre branche de développement : fossil branch new --private perso
  *  Se positionner sur cette branche : fossil checkout perso
  *  Faire ses modifs sur le code...
  *  Exporter un patch : fossil -N --branch perso > mon-patch.txt
  *  Envoyer le patch à la liste de discussion des patchs : patch@garradin.eu (en pièce jointe, ne pas oublier d'inclure une description de ce que le patch fait)

<h3>Comment participer à Garradin sans développer ?</h3>

  *  En aidant les autres utilisateurs sur le channel IRC ou la liste de discussions (voir plus bas).
  *  On peut [Rapporter un bug]
  *  Pour participer à la documentation il suffit de se connecter et de modifier le wiki.
  *  Pour développer une extension / un plugin : voir la page [Plugins]
  *  Pour développer sur Garradin : consulter la [Documentation développeur]

<h3>Contact développeurs :</h3>

  *  IRC : Salon #garradin sur le serveur irc.freenode.net
  *  Mailing-liste : fermée

Autres solutions de gestion d'association : voir la page [Inspiration]

Source logo : [http://www.flickr.com/photos/pikous/4462304300/in/photostream/]
Z 711281d1ff8b73b0fca8e91e9b55f876