Galette » Documentation

* Utilisation de `Slim <http://slimframework.com/>`_ pour la génération des URL

* Problème avec l'URL du formulaire adhérent en enregistrant les préférences (`#1027 <http://bugs.galette.eu/issues/1027>`_)

* Envoi d'images avec un nom composé d'un seul caractère (`#1028 <http://bugs.galette.eu/issues/1028>`_)

* Correction de la sauvegarde des emailings (`#998 <http://bugs.galette.eu/issues/998>`_)

* Correction du bug d'enregistrement (`#996 <http://bugs.galette.eu/issues/996>`_)

* Améliorations sur la gestion des groupes (merci à `Remi <http://blog.remirepo.net>`_),

* Validation des données sur les champs cachés (`#958 <http://bugs.galette.eu/issues/958>`_)

* Désactivation du champ mot de passe (`#957 <http://bugs.galette.eu/issues/957>`_)

* Pas d'ajout de contribution sur la création d'un adhérent exempt (`#966 <http://bugs.galette.eu/issues/966>`_)

* Correction d'un problème MySQL survenant parfois sous Windows (`#954 <http://bugs.galette.eu/issues/954>`_)

* Affichage des adhérents exempts actifs uniquement sur le spages publiques (`#971 <http://bugs.galette.eu/issues/971>`_)

* Certains champs n'étaient pas marqués comme étant requis (`#974 <http://bugs.galette.eu/issues/974>`_)

* Support RSS pour les news (`#956 <http://bugs.galette.eu/issues/956>`_)

* Compatibilité PHP 7 (`#953 <http://bugs.galette.eu/issues/953>`_)

* Correction d'un problème de recherche avancée avec des champs dynamiques (`#948 <http://bugs.galette.eu/issues/948>`_)

* Le module `mbstring` est requis (`#943 <http://bugs.galette.eu/issues/943>`_)

* Empêcher les utilisateurs inactifs de se connecter (`#941 <http://bugs.galette.eu/issues/941>`_)

* Envoi de courriels à un membre attaché (`#931 <http://bugs.galette.eu/issues/931>`_)

* La case à cocher « personne morale » était toujours décochée, provoquant l'effacement de la raison sociale (`#929 <http://bugs.galette.eu/issues/929>`_)

* Problème avec les listes déroulantes sous Firefox (`#933 <http://bugs.galette.eu/issues/933>`_)

* Pages publiques pour les plugins (`#635 <http://bugs.galette.eu/issues/635>`_)

* Ajout de la date de sortie des plugins (`#544 <http://bugs.galette.eu/issues/544>`_)

* La ventilation de transactions en dons ne fonctionnait pas (`#755 <http://bugs.galette.eu/issues/755>`_)

Merci à l'association `Club 404 <http://www.leclub404.com/>`_ qui a subventionné cette version ainsi que la première version officielle du :doc:`plugin Auto </plugins/auto>` :-)

* Ajouts de pièces jointes aux mailings (`#187 <http://bugs.galette.eu/issues/187>`_)

* Amélioration du système de génération de mots de passe et login aléatoires, pour éviter les doublons (`#731 <http://bugs.galette.eu/issues/731>`_)

* Affichage d'un message explicatif lorsque l'on tente un import CSV avec un statut inexistant (`#739 <http://bugs.galette.eu/issues/739>`_)

* Les données des graphiques n'avaient pas toujours le bon type (`#742 <http://bugs.galette.eu/issues/742>`_)

* Correction des champs dynamiques des transactions (`#745 <http://bugs.galette.eu/issues/745>`_)

* Date de création d'un adhérent incorrecte (`#741 <http://bugs.galette.eu/issues/741>`_)

* L'export CSV de la liste des adhérents résultait en un fichier vide (`#732 <http://bugs.galette.eu/issues/732>`_)

* Le modèle d'import ne pouvait être modifé (`#728 <http://bugs.galette.eu/issues/728>`_)

Un très grand merci à Loïs Taulelle, qui a `subventionné cette Galette 0.7.6 <http://galette.eu/dc/index.php/post/2013/10/19/Galette-0.7.6-:-subventionn%C3%A9e-par-Loïs>`_ :-)

* Imports CSV (`#176 <http://bugs.galette.eu/issues/176>`_)

* Filtrage des non membres (`#677 <http://bugs.galette.eu/issues/677>`_)

* PostgreSQL est désormais requis en version 9.1 au minimum (`#693 <http://bugs.galette.eu/issues/693>`_)

* Suppression de la méthode de stockage des mots de passe pour les *vieilles* versions de PHP (`#694 <http://bugs.galette.eu/issues/694>`_)

* Le décompte des jours n'est plus affiché pour les comptes désactivés (`#716 <http://bugs.galette.eu/issues/716>`_)

* Correction d'une incohérence lors de la vérification de l'unicité des champs dynamiques (`#642 <http://bugs.galette.eu/issues/642>`_)

* Un échec (voulu ou non) lors de la tentative de suppression d'un membre ne donnait pas lieu à un message dans l'interface (`#680 <http://bugs.galette.eu/issues/680>`_)

* L'activation du bouton de création de la carte de membre se basait sur l'état des cotisations de l'adhérent connecté, et non celui consulté (`#725 <http://bugs.galette.eu/issues/725>`_)

* Le super administrateur ne pouvait plus modifier certains champs (`#721 <http://bugs.galette.eu/issues/721>`_)

* Une contrainte en base Postgres qui n'éxistait pas était supprimée (`#681 <http://bugs.galette.eu/issues/681>`_)

* Correction d'une anomalie sur le filtrage par groupe des responsables de groupes (`#712 <http://bugs.galette.eu/issues/712>`_)

* Restriction des boutons de gestion des membres et responsables de groupes, ainsi que le bouton de création de nouveaux groupes aux administrateurs et membres du bureau (`#709 <http://bugs.galette.eu/issues/709>`_)

* Correction de divers problèmes relatifs aux droits des responsables de groupes (`#686 <http://bugs.galette.eu/issues/686>`_, `#499 <http://bugs.galette.eu/issues/499>`_)

* La résolution de `l'anomalie #687 <http://bugs.galette.eu/issues/687>`_ bloquait la liste des membres sous PostgreSQL et a été supprimée

* Le bouton d'ajout de membres ou de responsables à un groupe avait disparu (`#707 <http://bugs.galette.eu/issues/707>`_)

* Un membre appartenant à plusieurs sous groupes d'un même parent était affiché plusieurs fois si l'on cherchait le groupe parent (`#687 <http://bugs.galette.eu/issues/687>`_)

* Les responsables de groupes ne pouvaient éditer la fiche d'un membre (`#686 <http://bugs.galette.eu/issues/686>`_)

* Correction d'una page blanche à l'export PDF des groupes (`#676 <http://bugs.galette.eu/issues/676>`_)

* Correction du script de mise à jour MySQL (`#678 <http://bugs.galette.eu/issues/678>`_)

* Amélioration des données JSON du script post contribution (`#682 <http://bugs.galette.eu/issues/682>`_)

Un très grand merci à `Debian France <http://france.debian.net>`_, qui a `subventionné cette version 0.7.5 <http://galette.eu/dc/index.php/post/2013/08/17/Galette-0.7.5-:-subventionn%C3%A9e-par-Debian-France>`_ :-)

* Les tables vides étaient exportées, mais ne pouvaient pas être récupérées ou supprimées (`#628 <http://bugs.galette.eu/issues/628>`_)

* Traduction manquante dans l'historique lors de la suppression de contributions (`#644 <http://bugs.galette.eu/issues/644>`_)

* Modèles de courriels de rappel d'échéance (`#376 <http://bugs.galette.eu/issues/376>`_)

* Envoi automatique de courriels de rappel d'échéance de cotisation (`#368 <http://bugs.galette.eu/issues/368>`_)

* Automatisation (via cron) des rappels d'échéance (`#377 <http://bugs.galette.eu/issues/377>`_)

* Édition de factures et de reçus, avec possibilité de personnaliser les modèles (`#394 <http://bugs.galette.eu/issues/394>`_)

* Appel d'un script après l'enregistrement d'une nouvelle contribution (pour un enregistrement en comptabilité par exemple - `#490 <http://bugs.galette.eu/issues/490>`_)

* L'envoi de courriels comporte toujours un destinataire (pour éviter d'être bloqué par certains système de listes de diffusion par exemple - `#595 <http://bugs.galette.eu/issues/595>`_)

* Ajout des montants et types de contribution sur les courriels automatiques (`#620 <http://bugs.galette.eu/issues/620>`_)

* Ajout de champs dynamiques de type date (`#191 <http://bugs.galette.eu/issues/191>`_) - Merci à Guillaume R. !

* Ajout de champs dynamiques de type booléen (`#624 <http://bugs.galette.eu/issues/624>`_) - Merci à Guillaume R. !

* Possibilité de surcharger la feuille CSS d'impression (`#634 <http://bugs.galette.eu/issues/634>`_)

* La suppression d'un adhérent se faisait sans confirmation (`#638 <http://bugs.galette.eu/issues/638>`_)

* Attribution de groupes impossible depuis la fiche adhérent (`#625 <http://bugs.galette.eu/issues/625>`_)

* Amélioration de la feuille CSS pour l'impression (`#631 <http://bugs.galette.eu/issues/631>`_)

* De multiples messages étaient affichés lorsque l'on cliquait sur le bouton supprimer sans avoir sélectionné d'adhérents (`#627 <http://bugs.galette.eu/issues/627>`_)

* Désactivation de la carte adhérents pour les membres qui ne sont pas à jour de cotisation (`#546 <http://bugs.galette.eu/issues/546>`_)

* Utilisation de la chaîne non traduite lors de l'édition des types de contributions (`#630 <http://bugs.galette.eu/issues/630>`_)

* Le type de contribution n'était pas correctement sélectionné dans la seconde étape (`#618 <http://bugs.galette.eu/issues/618>`_)

* La recherche avancée dans plusieurs champs dynamiques de type choix provoquait une erreur (`#619 <http://bugs.galette.eu/issues/619>`_)

* Vérification de l'existance de la langue lors du chargement de textes (`#621 <http://bugs.galette.eu/issues/621>`_)

* Le contributions qui se chevauchent ne doivent pas être enregistrées (`#622 <http://bugs.galette.eu/issues/622>`_)

* Les titres, status, dates et genres apparaissent désormais en texte plutôt que par leurs identifiants (`#611 <http://bugs.galette.eu/issues/611>`_)

* La pagination de la liste publique des membres était cassée (`#603 <http://bugs.galette.eu/issues/603>`_)

* Correction d'un problème de recherche avancée sur les dates de fin de contribution (`#601 <http://bugs.galette.eu/issues/601>`_)

* Taille incorrecte du mot de passe temporaire (`#587 <http://bugs.galette.eu/issues/587>`_)

* Correction d'une erreur HTML sur le sélecteur de date de fin de contribution dans l'interface de recherche avancée (`#600 <http://bugs.galette.eu/issues/600>`_)

* La liste des adhérents pour les rappels n'était plus filtrée (`#599 <http://bugs.galette.eu/issues/599>`_)

* Implémentation d'une méthode moins sécurisée de stockage des mots de passe pour les *vielles* versions de PHP (`#597 <http://bugs.galette.eu/issues/597>`_)

* Les modules PHP requis et manquants n'étaient pas affichés (`#598 <http://bugs.galette.eu/issues/598>`_)

* Vérification de la présence du module PHP mcrypt à l'installation (`#596 <http://bugs.galette.eu/issues/596>`_)

* Lors de la mise à jour d'une base existante, les adhérents ayant pour titre mademoiselle se retrouvaient du troisième sexe (`#572 <http://bugs.galette.eu/issues/572>`_)

* Les mailings en cours n'étaient plus détectés (`#591 <http://bugs.galette.eu/issues/591>`_)

* L'export CSV de la liste filtrée ne prenait pas compte du filtre (`#584 <http://bugs.galette.eu/issues/584>`_)

* Le chemin de téléchargement suite à un export était incorrect (`#589 <http://bugs.galette.eu/issues/589>`_)

* Ré-écriture des procédures de vérification et de réinitialisation de la configuration des champs (`#577 <http://bugs.galette.eu/issues/577>`_)

* Suppression du bouton pour enlever les titres fixes (`#570 <http://bugs.galette.eu/issues/570>`_)

* Type de colonne incorrect pour la visiblité des champs sous PostgreSQL (`#577 <http://bugs.galette.eu/issues/577>`_)

* Certains champs étaient requis, mais désactivés (`#571 <http://bugs.galette.eu/issues/571>`_)

* Problèmes SQL lors de l'installation sous MySQL (`#575 <http://bugs.galette.eu/issues/575>`_)

* Les versions longues des titres étaient incorrectes sous MySQL (`#569 <http://bugs.galette.eu/issues/569>`_)

Un très grand merci de nouveau à `Exsequenda, qui a de nouveau subventionné cette version <http://galette.eu/dc/index.php/post/2013/02/23/Galette-0.7.4-%3A-Exsequenda-re-subventionne-!>`_ :-)

* Suppression du statut non membre (`#455 <http://bugs.galette.eu/issues/455>`_)

* Calcul de la date de fin d'adhésion erroné après suppression de toutes les contributions d'un membre (`#515 <http://bugs.galette.eu/issues/515>`_)

* Suppression d'un adhérent impossible (`#520 <http://bugs.galette.eu/issues/520>`_)

* Amélioration de l'interface de saisie des contributions si aucun adhérent n'existe (`#534 <http://bugs.galette.eu/issues/534>`_)

* Les informations de l'utilisateur authentifié n'étaient pas accessibles pour les plugins (`#449 <http://bugs.galette.eu/issues/449>`_)

* Les champs dynamiques n'étaient pas enregistrés lorsque l'adhérent d'inscrivait lui même (`#539 <http://bugs.galette.eu/issues/539>`_)

* Le lien dans la courriel de perte de mot de passe utilisait invariablement le protocole HTTP (`#557 <http://bugs.galette.eu/issues/557>`_)

* Récupération des champs requis lors de la mise à jour en 0.7.3 (`#523 <http://bugs.galette.eu/issues/523>`_)

* Gestion des civilités (subventionné - `#174 <http://bugs.galette.eu/issues/174>`_)

* Recherche des adhérents via leurs contributions (subventionné - `#498 <http://bugs.galette.eu/issues/498>`_)

* Export CSV de la liste des membres filtrée (subventionné - `#501 <http://bugs.galette.eu/issues/501>`_)

* Support SQLite (`#482 <http://bugs.galette.eu/issues/482>`_)

* Sécurité du stockage des mot de passe accrue (`#487 <http://bugs.galette.eu/issues/487>`_)

* Suppression des exports générés (`#271 <http://bugs.galette.eu/issues/271>`_)

* Possibilité d'utiliser séparément les nom et prénom de l'adhérent dans les textes des courriels (`#312 <http://bugs.galette.eu/issues/312>`_)

* Navigation entre les fiches en mode édition (`#456 <http://bugs.galette.eu/issues/456>`_)

* Tri des listes de contributions et de transactions par ordre chronologique inversé (`#465 <http://bugs.galette.eu/issues/465>`_)

* Génération de graphiques (`#157 <http://bugs.galette.eu/issues/157>`_)

* Liste PDF des adhérents par groupes (`#484 <http://bugs.galette.eu/issues/484>`_)

* Affichage des informations sur le status des cotisations de l'adhérent (`#545 <http://bugs.galette.eu/issues/545>`_)

* Affichage des groupes gérés mais dont l'adhérent n'est pas membre (`#480 <http://bugs.galette.eu/issues/480>`_)

* Le mot de passe était réinitialisé lors de la modification d'une fiche (`#488 <http://bugs.galette.eu/issues/488>`_)

* Ajout du type de paiement à l'initialisation d'une contribution (`#486 <http://bugs.galette.eu/issues/486>`_)

* L'installation se bloque (`#473 <http://bugs.galette.eu/issues/473>`_)

* L'image « captcha » ne s'affiche pas (`#474 <http://bugs.galette.eu/issues/474>`_)

* Amélioration de la validation de la configuration des champs (`#475 <http://bugs.galette.eu/issues/475>`_)

Un très grand merci à `Exsequenda, qui a subventionné cette version <http://galette.eu/dc/index.php/post/2013/01/01/Galette-0.7.3-%3A-Exsequenda-subventionne-!>`_ :-)

* Traduction des libellés des champs dynamiques (`#398 <http://bugs.galette.eu/issues/398>`_)

* Login et mot de passes peuvent être non requis (`#303 <http://bugs.galette.eu/issues/303>`_)

* Paramétrage de la visibilité des champs (`#369 <http://bugs.galette.eu/issues/369>`_)

* Recherche avancée (`#370 <http://bugs.galette.eu/issues/370>`_)

* Les traductions dynamiques inexistantes sont désormais créées (`#468 <http://bugs.galette.eu/issues/468>`_)

* Pagination des pages publiques (`#460 <http://bugs.galette.eu/issues/460>`_)

* Remplacement du logger (`#415 <http://bugs.galette.eu/issues/415>`_)

* Champs complémentaires des contributions non enregistrés et/ou non chargés (`#396 <http://bugs.galette.eu/issues/396>`_)

* L'upload de fichiers avec une extension en majuscules générati des fichiers vides (`#450 <http://bugs.galette.eu/issues/450>`_)

* Les photos des adhérents sont requises pour de la génération des cartes (`#461 <http://bugs.galette.eu/issues/461>`_)

* Régénération de l'image depuis la base donnait parfois un fichier vide (`#463 <http://bugs.galette.eu/issues/463>`_)

* Impossible d'enregistrer une fiche adhérent (entre autres), les définitions de champs étaient manquantes (`#466 <http://bugs.galette.eu/issues/466>`_)

* Les rappels ne doivent pas inclure les comptes inactifs (`#462 <http://bugs.galette.eu/issues/462>`_)

* Diverses améliorations des performances lors de la récupération de listes de membres (`#458 <http://bugs.galette.eu/issues/458>`_)

* L'interface de gestion des groupes n'était pas accessible aux responsables (`#404 <http://bugs.galette.eu/issues/404>`_)

* Différents problèmes se manifestaient avec la langue de l'adhérent (`#451 <http://bugs.galette.eu/issues/451>`_)

* Problème de sélection des membres dans un nouveau mailing (`#442 <http://bugs.galette.eu/issues/442>`_)

* Impossible d'annuler le filtrage des transactions (`#436 <http://bugs.galette.eu/issues/436>`_)

* Le code postal n'aparaissait pas sur les cartes de membres (`#441 <http://bugs.galette.eu/issues/441>`_)

* Compatibilité PostgreSQL 8.4 (`#439 <http://bugs.galette.eu/issues/439>`_)

* Erreur à l'intialisation des bases des plugins (`#432 <http://bugs.galette.eu/issues/432>`_)

* L'affichage de groupes vides causait des erreurs SQL (`#437 <http://bugs.galette.eu/issues/437>`_)

* Impossible de lister les groupes sous Postgres 8.4 (`#430 <http://bugs.galette.eu/issues/430>`_)

* Le filtrage des groupes est désormais effectifs sur les enfants directs du groupe (`#301 <http://bugs.galette.eu/issues/301>`_)

* Les champs dynamiques de type zone de texte étaient répétés indéfiniment (`#422 <http://bugs.galette.eu/issues/422>`_)

* Les champs dynamiques de type choix étaient répétés sous MySQL (`#419 <http://bugs.galette.eu/issues/419>`_, `#422 <http://bugs.galette.eu/issues/422>`_)

* Erreur d'objet incomplet lors d'une mise à jour (`#393 <http://bugs.galette.eu/issues/393>`_)

* Détection correcte du module PHP Curl à l'installation (`#395 <http://bugs.galette.eu/issues/395>`_)

* Amélioration de l'interface des champs complémentaires multiples (`#289 <http://bugs.galette.eu/issues/289>`_)

* Présentation des champs dynamiques contenant une URL ou une adresse courriel sous forme d'hyperlien (`#355 <http://bugs.galette.eu/issues/355>`_)

* Modification des tailles minimales des identifiants (désormais, respectivement 2 et 6 caractères pour le login et le mot de passe - `#374 <http://bugs.galette.eu/issues/374>`_)

* Ajout d'un bouton au tableau de bord pour effectuer des relances facilement vers les adhértents en retard (`#375 <http://bugs.galette.eu/issues/375>`_)

* Passage en objet de la gestion des champs dynamiques (`#194 <http://bugs.galette.eu/issues/194>`_)

* Problèmes lors de l'envoi de logo transparent ou de types non supportés (`#164 <http://bugs.galette.eu/issues/164>`_, `#165 <http://bugs.galette.eu/issues/165>`_),

* Chemin parfois incorect dans les entrées de menu des plugins (`#203 <http://bugs.galette.eu/issues/203>`_),

* Envoi de mailings via la fonction mail() de PHP (`#215 <http://bugs.galette.eu/issues/215>`_),

* Les informations dans l'interface d'administration des plugins n'étaient pas remises à jour après l'activation ou la désactivation d'un plugin (`#210 <http://bugs.galette.eu/issues/210>`_),

* Amélioration de la conversion texte automatique des mailings HTML (`#218 <http://bugs.galette.eu/issues/218>`_),

* Correction de différents problèmes liés à l'internationnalisation des dates, notamment avec l'interface en anglais (`#161 <http://bugs.galette.eu/issues/161>`_),

* Suppression d'une certaine ambiguité lors de la demande d'un nouveau mot de passe (`#252 <http://bugs.galette.eu/issues/252>`_),

* Modification de la taille de certains champs : les nom et prénom de l'adhérent peuvent désormais contenir 50 caractères, 200 pour la raison sociale, et 150 pour les descriptions de transactions (`#263 <http://bugs.galette.eu/issues/263>`_),

* Les prénoms composés prenaient une majuscule sur la toute première lettre uniquement (`#319 <http://bugs.galette.eu/issues/319>`_).

* Filtrage de la liste des adhérents par groupe (`#169 <http://bugs.galette.eu/issues/169>`_),

* Test de la présence des modules PHP requis et conseillés à l'installation (`#172 <http://bugs.galette.eu/issues/172>`_),

* Refonte de l'affichage des pages d'installation (`#235 <http://bugs.galette.eu/issues/235>`_),

* Vérification de la compatibilité des plugins (`#241 <http://bugs.galette.eu/issues/241>`_),

* Limitation des différents rôles du bureau à une seule instance. Il n'est plus possible d'avoir deux présidents :) (`#177 <http://bugs.galette.eu/issues/177>`_),

* Ajout de la description des transactions lors du rappel dans les contributions ; ainsi qu'un lien vers la transaction depuis la liste des contributions (`#255 <http://bugs.galette.eu/issues/255>`_, `#256 <http://bugs.galette.eu/issues/256>`_),

* Affichage d'un message lorsqu'un mailing est déjà en cours pour le reprendre ou de l'annuler (`#276 <http://bugs.galette.eu/issues/276>`_),

* Affichage de la raison sociale dans la liste des membres ; et recherche dans les raison sociales également lors d'une recherche sur le nom (`#286 <http://bugs.galette.eu/issues/286>`_),

* Enregistrement des erreurs PHP dans les logs de Galette, pour pallier le manque d'informations sur les hébergements dédiés (`#207 <http://bugs.galette.eu/issues/207>`_),

* Ajout d'une page d'informations système utiles lors de la déclaration de bogues (`#257 <http://bugs.galette.eu/issues/257>`_).

* Implémentation d'un mode démo qui bloque certaines fonctionnalités (l'envoi de mails, certaines directives de configuration, ...) (`#205 <http://bugs.galette.eu/issues/205>`_),

* Chargement dynamique des classes PHP à la demande (`#206 <http://bugs.galette.eu/issues/206>`_),

* Mise à jour de phpMailer en version 5.2.1 (`#216 <http://bugs.galette.eu/issues/216>`_),

* Passage à Smarty 3 (`#238 <http://bugs.galette.eu/issues/238>`_),

* Export au format CSV des tables de la base courante et/ou export de requêtes paramétrées (https://mail.gna.org/public/galette-devel/2009-02/msg00006.html),

Le code source de Galette se doit de suivre les `conventions d'écriture PSR2 <http://www.php-fig.org/psr/psr-2/>`_. Respecter une convention d'écriture permet d'obtenir un code plus lisible ; la syntaxe étant invariable d'un fichier à l'autre.

Vous pourrez utiliser `PHP Code Sniffer <http://pear.php.net/package/PHP_CodeSniffer>`_ sur le code produit pour vous assurer du respect des règles de codage. Certains avertissements peuvent être ignorés, mais les potentielles erreurs doivent toutes être corrigées. Pour lancer une vérification automatique, utilisez la commande ``phpcs`` :

* This file is part of Galette (http://galette.eu).

* along with Galette. If not, see <http://www.gnu.org/licenses/>.

* @license http://www.gnu.org/licenses/gpl-3.0.html GPL License 3.0 or later

* @link http://galette.eu

* @license http://www.gnu.org/licenses/gpl-3.0.html GPL License 3.0 or later

* @link http://galette.eu

Vous pouvez parfaitement vous baser sur la `version nightly de Galette <http://downloads.tuxfamily.org/galette/galette-dev.tar.bz2>`_, mise à niveau depuis la branche `develop` quotidiennement.

`Vincent Driessen <http://nvie.com>`_ a publié en 2010 un `modèle de gestion des branches Git que je trouve très pertinent <http://nvie.com/posts/a-successful-git-branching-model/>`_, et que j'ai décidié d'utiliser pour le développement de Galette. Couplé à l'outil git-flow du même auteur, le workflow est plus simple à suivre. Vous en doutez ? Alors, je vous laisse consulter cet `article qui vous explique pourquoi vous devriez utiliser git-flow <http://jeffkreeftmeijer.com/2010/why-arent-you-using-git-flow/>`_.

Il s'agit là du minimum syndical de configuration Git que vous avez à faire :) Bien entendu, Git dispose de bon nombre d'options, je vous recommande la lecture du `chapitre sur la configuration de Git de ProGit.org <http://progit.org/book/fr/ch7-1.html>`_ (la traduction de ce chapitre peut ne pas être à jour, consultez la `version originale <http://progit.org/book/ch7-1.html>`_ en cas de doute).

Vous pourrez ensuite déposer ces fichiers sur le `rapport de bogue ou sur la demande d'évolution <http://bugs.galette.eu/projects/galette/>`_ adéquat :)

Le projet Galette utilise `Git <http://fr.wikipedia.org/wiki/Git>`_ comme gestionnaire de sources, après avoir longtemps utilisé Subversion.

Il est possible de `parcourir le code source en utilisant l'interface web <http://git.tuxfamily.org/galette/galette>`_. Pour cloner le dépôt, utilisez :

Le dossier ``galette.git`` contiendra votre copie de travail de Galette, prête à être utilisée (même résultat qu'un `svn checkout`). Un bref mot sur les différents niveaux exitants dans Git : sous SVN, il y a la copie de travail, et le dépôt distant. Sous Git, c'est un peu plus compliqué, et de nombreux tutoriels/livres spécialisés traitent cet aspect des choses. Toutefois, voici une page qui `vous expliquera clairement les relations entre les différents niveaux d'un dépôt Git <http://ndpsoftware.com/git-cheatsheet.html>`_.

* http://schacon.github.com/git/gittutorial.html

* http://ndpsoftware.com/git-cheatsheet.html

* http://progit.org/book/

Désormais, pour installer les bibliothèques tierces dans Galette, il faut utiliser `composer <http://getcomposer.org>`_ :

* `TortoiseGIT <http://code.google.com/p/tortoisegit/>`_, très similaire à TortoiseSVN pour ceux qui connaissent,

* `Git Extensions <http://code.google.com/p/gitextensions/>`_

Le code de Galette est entièrement traduit à l'aide des possibilités offertes par `GNU Gettext <http://www.gnu.org/software/gettext/>`_. L'intégralité des chaînes contenues dans le code source doivent être en anglais.

Le projet Galette est hébergé chez `TuxFamily <http://tuxfamily.org>`_ :

* le `site web de Galette <http://galette.eu>`_,

* `un gestionnaire de bogues <http://bugs.galette.eu/projects/galette/>`_, pour nous signaler tout problème que vous auriez rencontré ainsi et aussi nous faire connaître les fonctionnalités ou autres améliorations que vous souhaiteriez voir intégrer au projet.

Le système de plugins est initialement basé sur celui utilisé par le `logiciel de publication web DotClear <http://fr.dotclear.org/>`_.

Côté plugin, la version de compatibilité est déclarée en `pénultième <http://fr.wikipedia.org/wiki/P%C3%A9nulti%C3%A8me>`_ position dans le fichier ``_define.php`` du plugin.

Certains plugins auront probablement besoin de leurs propres classes. Dans Galette, la hiérarchie, le nom et `l'espace de nom <http://php.net/manual/fr/language.namespaces.php>`_ (`namespace`) sont importants.

Pour le reste... Il suffit de vous armer du `manuel PHP <http://fr.php.net/manual/fr/>`_, du `manuel Smarty <http://www.smarty.net/manual/fr/>`_, d'un client de messagerie email pour `contacter les listes de diffusion <http://galette.eu/dc/index.php/pages/Contact#mailing_lists>`_, et éventuellement d'un `client IRC <http://xchat.org/>`_ pour rejoindre `le canal IRC de Galette <http://galette.eu/dc/index.php/pages/Contact#irc>`_ ;-)

Notez que les plugins (tout comme :ref:`le code principal de Galette <codage>`) doivent respecter les :ref:`conventions de codage PSR2 <conventions>` dans leur ensemble : http://www.php-fig.org/psr/psr-2/

L'ensemble des bibliothèques externes utilisées par Galette est gérée par `le système de gestion de départendences Composer <http://getcomposer.org>`_. Une fois composer installé sur votre système, il vous suffira de vous placer dans le dossier de Galette (où se trouvent les fichiers ``composer.json`` et ``composer.lock`` et de lancer simplement ``composer install``.

Les URL utilisées dans Galette sont générées et servies par le `micro framework Slim <http://www.slimframework.com/>`_ dans sa version `3`.

Là où nous avions auparavant un fichier ``.php`` par page à afficher, tout est désormais géré par un système de routes nommées et paramétrées ; ce qui rend les modifications et évolutions plus souples. La `documentation de Slim <http://www.slimframework.com/docs/>`_ est un bon point de départ pour comprendre comment le système fonctionne.

L'accès aux bases de données sera désormais assuré par `l'extension de gestion de bases de données de Zend <http://framework.zend.com/manual/2.2/en/modules/zend.db.adapter.html>`_.

* `MySQL <http://mysql.com/>`_ version 5.x (le support InnoDB est requis),

* `PostgreSQL <http://www.postgresql.org/>`_ 9.1 ou plus récente.

Les scripts d'installation et de mise à jour de Galette fournis ne le sont que pour les serveurs de bases de données pré-cités. Néanmoins, si vous avez testé Galette avec succès pour un autre moteur et/ou si vous avez le script SQL d'initialisation de la base, n'hésitez pas à contacter `la liste des développeurs <https://mail.gna.org/listinfo/galette-devel/>`_ pour leur en faire part :-)

Pour l'affichage des pages, c'est `le système de template Smarty <http://www.smarty.net/>`_ qui a été retenu. L'ensemble des pages est rendu au format HTML 5.

L'ancienne bibliothèque de génération de PDF est remplacée par `TCPDF <http://www.tcpdf.org/>`_.

Pour rendre plus dynamique l'interface utilisateur, et ainsi améliorer l'expérience de ce dernier, nous avons choisi de faire appel à un framework Javascript. `JQuery <http://jquery.com>`_ a été retenu, ainsi que certains de ses plugins, notamment :

* `JQuery UI <http://ui.jquery.com/>`_ pour l'ajout d'onglets, de formulaires de sélection de dates, de fenêtres modales, etc,

* `markItUp <http://markitup.jaysalvat.com>`_ en tant qu'éditeur HTML lors de l'envoi de mailings.

L'envoi de courriels depuis Galette est géré par `la biliothèque phpMailer <http://phpmailer.worxware.com/>`_.

* `ancienne liste de discussion utilisateurs <http://download.tuxfamily.org/galette/listes-galette/mail.gna.org/public/galette-discussion/index.html>`_

* `ancienne liste de discussion développement <http://download.tuxfamily.org/galette/listes-galette/mail.gna.org/public/galette-devel/index.html>`_

`Galette <http://galette.eu>`_ est un outil libre et gratuit de gestion d'adhérents et de cotisations en ligne à destination des associations. Le `site internet de Galette <http://galette.eu>`_ vous fournira quelques informations complémentaires sur le logiciel ; vous pouvez également consulter :doc:`le changelog de Galette </changelog>`.

Certains logiciels utilisés pour la décompression de l'archive, ou pour l'envoi des fichiers en FTP peuvent corrompre les fichiers... Il est fortement recommandé sous Windows d'avoir recours à `7zip <http://www.7-zip.org/fr/>`_ pour la décompression et à `FileZilla <http://filezilla-project.org/>`_ pour l'envoi des fichiers.

Une fois les sources récupérées en local, utilisez la commande :samp:`tar xjvf {galette.tar.bz2}` sous Linux/Unix/MacOS ou le `logiciel libre 7zip <http://www.7-zip.org/fr/>`_ sous Windows.

Envoyez ensuite à l'emplacement prévu chez votre hébergeur, le dossier décompressé (ainsi que l'ensemble des dossiers et fichiers extraits) via un client FTP, par exemple le `logiciel libre FileZilla <http://filezilla-project.org/>`_.

Cet hébergeur propose de `modifier la version de PHP utilisée depuis la configuration de votre compte client <http://docs.ovh.com/fr/fr/web/hosting/mutualise-configurer-la-version-de-php-depuis-votre-espace-client/>`_.

Le `serveur web Nginx <http://nginx.com>`_ adopte une configuration différente de celle d'Apache (consultez `la documentation de Nginx pour une explication plus complète <http://www.nginx.com/resources/wiki/start/topics/examples/likeapache-htaccess/>`_).

Les commandes décrites ci dessus peuvent varier, référez vous aux documentations de `MariaDB <https://mariadb.com/kb/en/library/documentation/>`_ ou de `PostgreSQL <http://docs.postgresqlfr.org>`_ selon votre cas ; ou utilisez un outil graphique :

* `phpMyAdmin <http://www.phpmyadmin.net>`_ pour MariaDB ;

* `phpPgAdmin <http://phppgadmin.sourceforge.net>`_ ou `PgAdmin3 <http://www.pgadmin.org/download/?lang=fr_FR>`_ pour PostgreSQL.

Dans un premier temps, vous allez `télécharger Galette <http://download.tuxfamily.org/galette/galette-0.9.2.tar.bz2>`_ et décompresser l'archive. Si vous êtes sous Linux, ça donnera quelque chose comme :

$ wget http://download.tuxfamily.org/galette/galette-0.9.2.tar.bz2

Si vous êtes sous windows, vous devrez préalablement installer un logiciel capable de gérer les archives tar, comme le `logiciel libre 7zip <http://www.7-zip.org/>`_.

La version 0.9.2 de Galette est l'actuelle version stable. Il existe une archive mise à jour quotidiennement (`nightly <http://download.tuxfamily.org/galette/galette-dev.tar.bz2>`_) de la version de développement, et vous pouvez également choisir de :doc:`récupérer la version de développement de Galette <../development/git>` comme expliqué dans la documentation de développement.

* un serveur `MariaDB <http://mariadb.org>`_ (ou MySQL) en version 5.5 minimum ou `PostgreSQL <http://postgresql.org>`_ en version 9.1 minimum.

Par exemple, sous `Fedora <http://fedora-fr.org>`_, vous lancerez (en root) :

Sous `Debian <http://debian.org/>`_, on remplacera ``apache:apache`` par ``www-data:www-data``.

Rien n'est actuellement prévu pour permettre d'effectuer réellement un tel saut dans le futur ;-) Si votre instance de Galette est antérieure à la 0.7.0, nous vous conseillons dans un premier temps de `migrer vers la version 0.7.8 <http://download.tuxfamily.org/galette/archives/galette-0.7.8.tar.bz2>`_ ; puis ensuite de recommencer avec la dernière version stable.

L'installation présentée ici repose sur `XAMPP <http://www.apachefriends.org/fr/xampp-windows.html>`_ ; il existe d'autres méthodes d'installation qui ne seront pas décrites ici.

Dans un premier temps, vous devez récupérer le plugin ; vous pouvez le télécharger à l'adresse :

http://download.tuxfamily.org/galette/plugins/galette-plugin-admintools-1.6.2.tar.bz2

Ce plugin a été développé en étroite collaboration avec Anatole du `Club 404 <http://www.leclub404.com/>`_, et François du `club Fiat 500 <http://www.leclub404.com/>`_. Un grand merci à eux pour les données qu'ils m'ont fournies durant la création du plugin :-)

http://download.tuxfamily.org/galette/plugins/galette-plugin-auto-1.4.0.tar.bz2

http://download.tuxfamily.org/galette/plugins/galette-plugin-events-1.1.1.tar.bz2

Ce plugin a été développé pour `l'association Borsalinux-fr (anciennement Fedora-Fr) <http://borsalinux-fr.org>`_. Il permet la génération d'une fiche adhérent PDF qui peut soit être vierge (pour une utilisation lors de salons, etc) ; soit pré-rempli avec les données de l'utilisateur (qui peut être joint à un paiement par chèque par exemple).

http://download.tuxfamily.org/galette/plugins/galette-plugin-fullcard-1.7.2.tar.bz2

http://download.tuxfamily.org/galette/plugins/galette-plugin-maps-1.4.0.tar.bz2

* si l'adhérent a renseigné sa ville sur sa fiche, une liste de possibilités d'emplacements lui sera soumise (via le `service en ligne de Nominatim <http://nominatim.openstreetmap.org>`_),

* une zone de recherche libre (dont les résultats sont basés sur `OpenStreetMap <http://nominatim.openstreetmap.org/>`_) est disponible en complément,

http://download.tuxfamily.org/galette/plugins/galette-plugin-objectslend-0.5beta.tar.bz2

http://download.tuxfamily.org/galette/plugins/galette-plugin-paypal-1.7.0.tar.bz2

Si votre navigateur supporte HTML5 (c'est le cas depuis un certain temps pour Firefox et Chromium par exemple) ; il vous avertira directement des champs requis et non renseignés. Si, pour une raison ou une autre, l'une des informations était erronée, la page serait rechargée avec les informations saisies (en dehors du mot de passe !), et un message en haut de page vous informera des erreurs rencontrées. Le même type de message s'affichera pour les champs requis si votre navigateur ne supporte pas HTML5 (dans ce cas, je vous invite fortement à `utiliser un navigateur web récent et respectueux des standards <http://www.mozilla-europe.org/>`_ ; votre expérience avec Galette et bien d'autres sites s'en retrouverait améliorée).