[reledit] do NOT propose to edit composite-related entities (unlinking would destroy the other side)
.. -*- coding: utf-8 -*-
Configuration d'une instance
============================
À la création d'une instance, un fichier de configuration est généré dans ::
$(CW_REGISTRY)/<instance>/<nom configuration>.conf
par exemple ::
/etc/cubicweb.d/jpl/all-in-one.conf
C'est un simple fichier texte au format INI. Dans la description suivante,
chaque nom d'option est préfixé de sa section et suivi de sa valeur par défaut
le cas échéant, e.g. "`<section>.<option>` [valeur]".
Configuration du serveur web
----------------------------
:`web.auth-mode` [cookie]:
mode d'authentification, cookie ou http
:`web.realm`:
realm de l'application en mode d'authentification http
:`web.http-session-time` [0]:
délai d'inactivité d'une session HTTP avant sa fermeture automatique. Durée
en secondes, 0 signifiant pas d'expiration (ou plus exactement lors de la
fermeture du navigateur du client)
:`main.anonymous-user`, `main.anonymous-password`:
login et mot de passe à utiliser pour se connecter au serveur RQL lors des
connexions HTTP anonymes. Il faut que le compte CWUser associé existe.
:`main.base-url`:
url de base du site, à utiliser pour générer les urls des pages web
Configuration https
```````````````````
Il est possible de rendre un site accessible en http pour les connections
anonymes et en https pour les utilisateurs authentifié. Il faut pour cela
utiliser apache (par ex.) pour la redirection et la variable `main.https-url` du
fichier de configuration.
:Exemple:
pour une redirection apache d'un site accessible via `http://localhost/demo`
et `https://localhost/demo` et qui tourne en réalité sur le port 8080, il
faut avoir pour la version http : ::
RewriteCond %{REQUEST_URI} ^/demo
RewriteRule ^/demo$ /demo/
RewriteRule ^/demo/(.*) http://127.0.0.1:8080/$1 [L,P]
et pour la version https : ::
RewriteCond %{REQUEST_URI} ^/demo
RewriteRule ^/demo$ /demo/
RewriteRule ^/demo/(.*) http://127.0.0.1:8080/https/$1 [L,P]
et on aura dans le fichier all-in-one.conf de l'instance : ::
base-url = http://localhost/demo
https-url = `https://localhost/demo`
Configuration de l'interface web
--------------------------------
:`web.embed-allowed`:
expression régulière correspondant aux sites pouvant être "incorporé" dans
le site (controleur 'embed')
:`web.submit-url`:
url à laquelle les bugs rencontrés dans l'application peuvent être posté
Configuration du serveur RQL
----------------------------
:`main.host`:
nom de l'hôte s'il ne peut être détecter correctement
:`main.pid-file`:
fichier où sera écrit le pid du serveur
:`main.uid`:
compte utilisateur à utiliser pour le lancement du serveur quand il est
lancé en root par init
:`main.session-time [30*60]`:
temps d'expiration d'une session RQL
:`main.query-log-file`:
fichier dans lequel écrire toutes les requêtes RQL éxécutées par le serveur
Configuration Pyro pour l'instance
-----------------------------------
Coté serveur web :
:`pyro-client.pyro-application-id`:
identifiant pyro du serveur RQL (e.g. le nom de l'instance)
Coté serveur RQL :
:`pyro-server.pyro-port`:
numéro de port pyro. Si aucune valeur n'est spécifiée, un port est attribué
automatiquement.
Coté serveur RQL et serveur web :
:`pyro-name-server.pyro-ns-host`:
nom de l'hôte hébergeant le serveur de nom pyro. Si aucune valeur n'est
spécifié, il est localisé par une requête de broadcast
:`pyro-name-server.pyro-ns-group` [cubicweb]:
groupe pyro sous lequel enregistrer l'application
Configuration courriel
----------------------
Coté serveur RQL et serveur web :
:`email.mangle-emails [no]`:
indique si les adresses email doivent être affichées telle quelle ou
transformée
Coté serveur RQL :
:`email.smtp-host [mail]`:
nom de l'hôte hébergeant le serveur SMTP à utiliser pour le courriel sortant
:`email.smtp-port [25]`:
port du serveur SMTP à utiliser pour le courriel sortant
:`email.sender-name`:
nom à utiliser pour les courriels sortant de l'application
:`email.sender-addr`:
adresse à utiliser pour les courriels sortant de l'application
:`email.default-dest-addrs`:
adresses de destination par défaut, si utilisé par la configuration de la
diffusion du modèle (séparées par des virgules)
:`email.supervising-addrs`:
addresses de destination des courriels de supervision (séparées par des
virgules)
Configuration journalisation
----------------------------
:`main.log-threshold`:
niveau de filtrage des messages (DEBUG, INFO, WARNING, ERROR)
:`main.log-file`:
fichier dans lequel écrire les messages
Configuration Eproperties
-------------------------
D'autres paramètres de configuration sont sous la forme d'entités `CWProperty`
dans la base de données. Il faut donc les éditer via l'interface web ou par des
requêtes rql.
:`ui.encoding`:
encodage de caractères à utiliser pour l'interface web
:`navigation.short-line-size`: # XXX should be in ui
nombre de caractères maximum pour les affichages "courts"
:`navigation.page-size`:
nombre d'entités maximum à afficher par page de résultat
:`navigation.related-limit`:
nombre d'entités liées maximum à afficher sur la vue primaire d'une entité
:`navigation.combobox-limit`:
nombre d'entités non liées maximum à afficher sur les listes déroulantes de
la vue d'édition d'une entité