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.

Afficher les erreurs

Si vous ne pouvez pas accéder aux logs système (fréquent sur les hébergements mutualisés), vous pouvez afficher les erreurs directement sur la page.

Avertissement

Afficher les erreurs sur une page web peut fournir des informations qui ne devraient pas être publiques. En mode production, il est fortement recommandé de ne pas les afficher. la solution décrite ici n’est qu’un outil de déboguage.

Notez également qu’avec le système de routes, certaines informations pourraient être « cachées » par une redirection inadaptée… Les logs sont bien plus fiables sur ce point.

Pour afficher temporairement les erreurs sur la page, créez un fichier galette/config/behavior.inc.php avec le contenu suivant :

<?php
define('GALETTE_DISPLAY_ERRORS', 1);

La prochaine fois que vous rencontrerez le problème, les erreurs seront affichées sur la page en question.

Globalement, vous pouvez utiliser la configuration du comportement de Galette pour vous aider à obtenir davantage d’informations.

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.

Toutefois, il est possible dans Galette de lier plusieurs adhérents. De cette manière, certaines informations comme l’adresse courriel ou l’adresse postale seront récupérées depuis le parent si elles sont manquantes.

Ceci permet finalement d’utiliser une même adresse de courriel pour plusieurs membres en base ; mais il n’y a pas de doublons dans la base.