Overview

Artifact ID: b20cfc407a1f3c0f664cba402bb9d24ab33c80173e6b734461f71ced68f868ce
Page Name:Documentation_configuration
Date: 2021-05-06 18:29:02
Original User: isabelle
Mimetype:text/x-markdown
Parent: 894efe9c553a748511d5e54804974c8e784c41df78abdc6ca872c41a9c5c8dbb (diff)
Next 20564797114b802a1e0ea7061aeda33f3e44b48e1c8c47dde78846fe40b144da
Content

Configuration de votre Garradin

A. Général

Ce menu par défaut permet de vérifier la version installée (et de comparer depuis le site si une nouvelle version est disponible) ainsi que les paramètres techniques du serveur qui héberge Garradin (version de PHP, SQLlite…).

Il permet aussi de modifier le nom de l’association ainsi que ses coordonnées, sa monnaie…

Elle permet aussi de définir des options par défaut sur le nom de la page d’accueil du wiki ou la page d’accueil à la connexion d’un membre.

Concernant les membres, vous pouvez définir :

  • la Catégorie par défaut des nouveaux membres ;
  • le champ utilisé pour définir l’identité des membres, ce champ des fiches membres sera utilisé comme identité du membre dans les emails, les fiches, les pages, etc. ;
  • le champ utilisé comme identifiant de connexion, ce champ des fiches membres sera utilisé en guise d’identifiant pour se connecter à Garradin. Pour cela le champ doit être unique (pas de doublons) ;
  • enfin la couleur de l’interface de Garradin est aussi personnalisable immédiatement, grâce à un outil très facile d’usage.

B. Catégories de membres

Vous pouvez y créer de nouvelles catégories de membres et définir des options de droits pour chacune, souvent représentée par une lettre ou un symbole :

  • cachée : visible uniquement par les administrateurs si cachée ;
  • cotisation obligatoire : y associer un type de cotisation prédéfinie dans le menu « Membres / Cotisations »

Droits d’accès et de modification

Gestion des membres :

  • pas d’accès ;
  • lecture uniquement (peut voir les informations personnelles de tous les membres, y compris leurs cotisations) ;
  • lecture & écriture (peut ajouter et modifier des membres, mais pas les supprimer ni les changer de catégorie, peut affecter des cotisations aux membres) ;
  • administration (peut tout faire).

Comptabilité :

  • pas d’accès ;
  • lecture uniquement (peut lire toutes les informations de tous les exercices) ;
  • lecture & écriture (peut ajouter des écritures, mais pas les modifier ni les supprimer) ;
  • Administration (peut modifier et supprimer des écritures, gérer les comptes, les exercices, etc.).

Wiki, pages :

  • pas d’accès ;
  • lecture uniquement (peut lire les pages auquel il a le droit d’accéder) ;
  • lecture & écriture (peut modifier ou ajouter des pages, mais pas les supprimer) ;
  • administration (peut tout faire).

À noter : un administrateur ne peut pas supprimer son compte membre ou changer sa propre catégorie, ceci afin d’éviter de se retrouver dans une situation où l’association n’aurait plus aucun membre administrateur. Si un administrateur souhaite changer sa catégorie, il faut qu’un autre administrateur le fasse pour lui.

C. Fiche de membres

Cette page vous permet de personnaliser les fiches d’information des membres de l’association.

Attention : les champs supprimés de la fiche seront effacés de toutes les fiches de tous les membres, et les données qu’ils contiennent seront définitivement perdues.

Ajouter un champ prédéfini ou personnalisé qui sera complémentaire à ceux existants…

Il faut définir un nom unique (minuscules et tiret bas), un Titre plus explicite, et un type (email, nombre, URL, case à cocher, texte…).

Mots de passe :

Plusieurs options pour les mots de passe :

  • Caché pour les membres : si coché, ce champ ne sera pas visible par les membres dans leur espace personnel ;
  • Modifiable par les membres : si coché, les membres pourront changer cette information depuis leur espace personnel ;
  • Champ obligatoire : si coché, ce champ ne pourra rester vide.

D. Site public

Cette option définit le comportement par défaut lorsqu’un visiteur arrive sur la page d’accueil de votre site Garradin.

Activé : permet d’afficher les pages publiées du site wiki selon l’organisation créée par vos soins. Cette option est utile si vous n’avez pas de site web et souhaitez utiliser la fonctionnalité site web de Garradin.

Désactivé : les visiteurs sont redirigés automatiquement vers la page de connexion.

Squelettes du site

Le site Internet public propose des squelettes par défaut qu’il est possible de modifier. Les modifications peuvent être réinitialisées.

Il est conseillé de sauvegarder les modifications aux squelettes, en plus de la base de données.

Pour modifier l’apparence du site, il est conseillé d’avoir un minimum de connaissances sur la mise en forme de pages web (HTML, CSS) et l’usage de balises spécifiques. Depuis la version 1.1, Garradin utilise la [syntaxe Brindille(https://fossil.kd2.org/garradin/wiki?name=Documentation/Brindille).

Les fichiers par défaut sont les suivants jusqu'à la version 1.1 exclue :

  • entete.html : partie commune en haut de page
  • pied.html : partie commune en bas de page
  • sommaire.html : page d’accueil par défaut du site, présentant la liste des 9 derniers articles
  • article.html : contenu de la page par défaut d’un article
  • rubrique.html : page listant les articles d’une rubrique
  • galerie.html : fichier utilisé pour présenter une galerie d’images
  • documents.html : mise en page de présentation de documents à télécharger
  • index.html : modèle pour page introuvable
  • default.css : contenu de la feuille de styles du site pour modifier son apparence
  • atom.xml : contenu du fichier générateur de flux RSS

Les fichiers par défaut depuis la version 1.1 sont les suivants :

  • 404.html : erreur 404
  • _breadcrumbs.html : fil d'Ariane
  • _foot.html : pied de page
  • _head.html : entête
  • article.html : article
  • atom.xml : flux atom (abonnement aux nouveautés du site)
  • category.html : rubriques
  • content.css et default.css : feuilles de styles pour la mise en forme
  • documents.html
  • favicon.png
  • gallery.html : galerie
  • index.html : page d’accueil
  • search.html : accès à la recherche

Plus de détails (usage avancé)

Pour la version 1.1 et suivantes.

Les fichiers qui contrôlent l’apparence du site public sont organisés comme suit jusqu'à la version 1.1 exclue :

  • dans le dossier www/squelettes-dist/ : les fichiers originaux des squelettes (il ne faut donc pas les modifier directement ici)
  • depuis Configuration > Site public : on y a accès pour les modifier depuis l’interface
  • dans le dossier www/squelettes/ : une fois qu’un fichier a été modifié, il apparaît ici (sa version originale est conservée dans squelettes-dist/). Si on souhaite rajouter un nouveau fichier, il faut l’ajouter ici.

À savoir, les fichiers qui sont appelés en fonction de l’uri (adresse tapée dans le navigateur, après le domaine du site) :

  • s’il n’y a rien/que l’uri vaut "/" : le fichier sommaire.html est appelé ;
  • si c’est "/feed/atom/" : le fichier atom.xml est appelé ;
  • s’il y a quelque chose puis un / à la fin (ex : site.net/actus/) : le fichier rubrique.html est appelé ;
  • sinon, si ça correspond au nom d’un fichier ajouté dans www/squelettes/ : ce fichier est appelé ;
  • sinon, c’est le fichier article.html.

(tel que défini dans le fichier include/lib/Garradin/Squelette.php, fonction dispatchURI())

En sachant que rubrique.html et article.html, par défaut, sont faits pour afficher le contenu public correspondant du wiki.

E. Sauvegarde et restauration

E.1. Sauvegarder et restaurer

La sauvegarde de la totalité du site est au format SQLite et comprend les données et les fichiers. Attention ce format ne permet pas aisément de récupérer le contenu. Mais il permet de restaurer le site en cas de dysfonctionnement. Une restauration à partir de ce fichier est aussi possible.

E.2. Import / Export

Membres

  • Pour exporter la liste des membres et leurs informations (format LibreOffice ou CSV)
  • L’import renvoie à la fonction existante dans le menu “Membres” depuis un fichier CSV

Comptabilité

  • Pour exporter la liste des opérations comptables (format ODS pour tableur LibreOffice, Excel, etc. ou CSV) ;
  • l’import renvoie à la fonction existante dans le menu « Comptabilité » depuis un fichier CSV.

E.3. Gestion des sauvegardes

  • Pour créer des sauvegardes distantes sur le site et pouvoir ensuite les restaurer ;
  • pour supprimer des sauvegardes existantes superflues.

E.4. Configuration de la sauvegarde automatique

  • Définir l’intervalle de sauvegarde automatique et sa fréquence : Aucun, Quotidien, Hebdomadaire, Bi-Mensuel, Mensuel, Trimestriel, Annuel.

Attention aux problèmes d’espace disque en cas de sauvegardes trop fréquentes.

E.5. Remise à zéro

  • Pour remettre le site à zéro et repartir d’une configuration vierge. Il est nécessaire de saisir une nouvelle fois le mot de passe de l’administration pour réinitialiser le site qui sera entièrement vidé.

F. Extensions

Possibilité d’ajouter des extensions à Garradin. (Expérimental)

G. Journaux

Affiche les journaux de connexion des utilisateurs et les erreurs système de Garradin.

H. En complément