Questions fréquentes (FAQ)

Que faire si Galette ne fonctionne pas ?

Parfois, une mise à jour, une modification sur l’hébergement, ou un simple bogue - même mineurs - peuvent causer une erreur dans Galette. Vous pourriez observer :

  • un simple message d’erreur est affiché,
  • une page blanche,
  • une page avec une trace (généralement pas en mode production),
  • …

Dans tous les cas, vous devez consulter les logs. La plupart des erreurs sont stockées dans ces fichiers, c’est un très bon point de départ pour comprendre le problème, et éventuellement le résoudre.

Il existe deux types de fichiers de logs : ceux de Galette, et les logs système. Les logs de Galette sont stockés dans le dossier galette/data/log par défaut.

Les logs système sont un autre problème. Sur des hébergements mutualisés, ils ne vous sont généralement pas accessibles :( Sur un serveur dédié, leur emplacement change en fonction de la configuration du serveur, et c’est lié aux système d’exploitation, version de PHP, configuration du serveur web, …

  • avec le service php-fpm les logs sont dans /var/log/php-fpm/www-error.log (pour les distributions GNU/Linux Red Hat like),
  • avec le (déprécié) mod_php, vous les trouverez dans /var/log/httpd/error_log (sur d’autres distributions GNU/Linux, httpd peut être nommé apache),
  • sur des solutions Windows/MacOS avec des solutions de type XAMPP, il existe généralement un dossier log où ils ont été installés, vous devriez trouver votre bonheur à cet endroit.

Comment rapporter un bogue ou demander une fonctionnalité ?

Les rapports de bogues et RFE (Request For Enhancement) doivent être effectués sur le tracker de Galette, pour Galette elle même, tous les plugins officiels et aussi pour la documentation.

Note

À moins d’être certain de ce que vous faites, merci de ne pas attribuer le ticket et de ne pas définir la version cible. Cela sera fait lorsque le ticket sera pris en compte.

Si vous avez des doutes, n’hésitez pas à poser vos questions sur les listes de diffusion ;)

Rapporter un bogue

S’il vous plaît, n’oubliez pas de :

  • nous dire quelle version de Galette vous utilisez,
  • être clair et concis,
  • fournir toutes les informations pour reproduire le problème
  • de fournir les entrées de logs adéquates.

Demande de fonctionnalités

Assurez vous d’être précis pour les demandes d’évolution également. Les développeurs peuvent ne pas deviner ce que vous avez à l’esprit, vous devez leur expliquer, même si ça vous semble évident ;) Les demandes dévolution sont marquées comme « Souhaits », et déplacées par les développeurs lorsque le travail commence.

Une fois votre souhait exprimé, vous pouvez le soumettre au vote, les demandes les plus plébiscitées pourraient retenir l’attention des développeurs.

Comment chercher dans les archives des listes ?

Les listes de diffusion sont le canal principal de communication pour Galette, depuis ses débuts.

Pour rappel, depuis 2017, deux listes sont disponibles :

Si vous cherchez les archives avant 2017, voyez :

Malheureusement, il n’y a pas de mécanisme de recherche dans ces archives. L’alternative est d’utiliser le mot clé site: depuis votre moteur de recherche (la plupart supporte ce mot clé) :

site:https://listengine.tuxfamily.org/lists.galette.eu/users plugin

La recherche ci-dessus cherchera « plugin » dans les archives de la liste de diffusion des utilisateurs. Adaptez juste l’URL aux liste et période que vous souhaitez ;)

Pour affiner la recherche, référez-vous à la documentation de votre moteur de recherche.

Comment utiliser une même adresse de courriel pour plusieurs adhérents ?

C’est une question très fréquente, beaucoup souhaiteraient pouvoir faire ça…

Ce n’est pas possible.

En effet, les adresses de courriel doivent être uniques dans la base de données. C’est un choix du projet sur lequel plusieurs fonctionnalités reposent :

  • récupération du mot de passe (depuis… toujours ou presque),
  • la connexion (depuis Galette 0.9),
  • …

Les rendre non uniques n’est pas une solution que nous souhaitons mettre en œuvre. Ce serait compliqué, et source de nombreux bogues.

Néanmoins, il est possible dans Galette de lier plusieurs adhérents. De cette manière, les informations telles que les adresse de courriel ou postale seront récupérées depuis la fiche parent si elles manquent.

Cela permet au final d’utiliser une même adresse de courriel pour plusieurs adhérents en base ; mais sans que ce soit dupliqué dans la base de données.