====== edit_list.conf ======
Ce fichier décrit quelle partie de la configuration peut-être modifiée ou visualisé par le listmaster, les propriétaires privilégiés, les propriétaires, les éditeurs.
Il n'y a pas de relation hiérarchique entre les populations dans ce fichier de configuration. Il faut explicitement lister les populations.
Attention dans la version 6.2 dans le fichier edit_list.conf, les paramètres suivants n'apparaissent pas dans le menu **Admin**:
* include_admin
* export
* account
* forced_reply_to
* default
Dans notre fichier edit_list.conf nous n'avons pas explicités les paramètres suivants (gardent les valeurs par défaut de sympa):
* lang
* delivery_time
* default_user_options
* reply_to_header
* custom_subject
* info
* subscribe
* unsubscribe
===== Les actions =====
Paramètres à configurer dans **edit_list.conf** et dans le fichier **config** de chaque liste
==== account ====
**Compte** ???
==== add ====
**Qui peut ajouter des abonnés** (menu Droits d'accès)\\
(commande ADD) dans la liste
==== anonymous_sender ====
**Auteur anonyme** (menu Diffusion/réception) \\
Pour dissimuler l'adresse email de l'expéditeur avant de diffuser un message. L'adresse est remplacée par la valeur spécifiée.
==== archive ====
**Les archives** (menu Les archives) \\
Droit de consultation des archives mail et définition de la fréquence d'archivage
==== archive_crypted_msg ====
**Archivage des messages cryptés** (menu Les archives)
==== available_user_options ====
**Options d'abonné disponibles** (menu Diffusion/réception) \\
Le paramètre "available_user_options" définit le options disponibles pour les abonnés de la liste.
=== mode de réception (reception) modelist ===
Valeur par défaut : reception mail,notice,digest,digestplain,summary,nomail
modelist est une liste de modes de réception (mail, notice, digest, digestplain, summary, nomail), séparés par des virgules.\\
Seuls ces modes de réception seront accessibles aux abonnés de la liste. Si un abonné a positionné un mode de réception non autorisé, sympa utilisera le mode de réception par défaut pour la liste.
==== bounce ====
**Gestion des erreurs** (menu Gestion des erreurs)\\
Ce paragraphe définit les paramètres de gestion des abonnés en erreur
warn_rate (Valeur par défaut paramètre global bounce_warn_rate)
Le propriétaire de la liste est alerté lorsqu'un message est diffusé si taux d'adresses en erreur dans la liste excède ce seuil.
halt_rate (Valeur par défaut paramètre global bounce_halt_rate)
NON IMPLEMENTE Si le taux d'adresses en erreur atteint le seuil halp_rate, les messages à destination de la liste seront retenus ; ils pourront être ultérieurement diffusés par le modérateur.
expire_bounce_task (Valeur par défaut daily)
Nom du modèle de tache utilisé pour réinitialiser le compteur d'erreurs pour les abonnés n'ayant pas généré de rapports d'erreur suite aux dernières diffusions de message dans la liste. Actif si le processus task_manager s'exécute.
==== bouncers_level1 ====
**Gestion des abonnés en erreur, 1er niveau** (menu Gestion des erreurs)\\
Le paragraphe "bouncers_level1" définit le comportement pour la gestion automatique des adresses en erreur.
Le 1er niveau est le niveau le plus bas pour les abonnés générant des erreurs.
rate (Valeur par défaut 45)
Chaque abonné en erreur a un score (de 0 à 100). Chaque abonné en erreur se voit affecter un score (de 0 à 100). Ce paramètre définit la limite basse pour chaque catégories. Par exemple, par défaut le niveau 1 concerne les abonnés en erreur dont le score est compris entre 45 et le seuil de niveau 2.
action (Valeur par défaut notify_bouncers)
Ce paramètre définit quelle opération est effectué sur les abonnés en erreur de niveau 1.
notification (Valeur par défaut owner)
Lorsque la tache est exécutée sur les abonnés en erreur de niveau 1, le propriétaire ou le listmaster peuvent être notifiés par email.
==== bouncers_level2 ====
**Gestion des abonnés en erreur, 2nd niveau** (menu Gestion des erreurs)\\
Le paragraphe "bouncers_level2" définit le comportement pour la gestion automatique des adresses en erreur.
Le 2nd niveau est le niveau le plus haut pour les abonnés générant des erreurs.
rate (Valeur par défaut 80)
Chaque abonné en erreur a un score (de 0 à 100). Chaque abonné en erreur se voit affecter un score (de 0 à 100). Ce paramètre détermine les seuils entre chaque catégories d'abonnés en erreur. Par exemple, par défaut le niveau 2 concerne les abonnés en erreur dont le score est compris entre 80 et 100
action (Valeur par défaut notify_bouncers)
Ce paramètre définit quelle opération est effectué sur les abonnés en erreur de niveau 2.
notification (Valeur par défaut owner)
Lorsque la tache est exécutée sur les abonnés en erreur de niveau 2, le propriétaire ou le listmaster peuvent être notifiés par email.
==== clean_delay_queuemod ====
**Expiration des messages non modérés** (menu Divers)
==== cookie ====
**Secret pour la génération de clefs** (menu Divers)\\
Ce paramètre est à manipuler avec précaution. Il est utiliser pour générer les clefs d'authentification, les clefs de modération, encrypter les mots de passe.
==== creation ====
**Création de la liste** (menu Divers)
==== custom_attribute ====
**Attributs d'utilisateur personnalisés** (menu Divers)
==== custom_header ====
**Champs d'entête personnalisés** (menu Diffusion/réception)\\
Ce paramètre est optionnel. Les champs d'entête spécifiés seront ajoutés aux messages diffusés dans la liste. Il est possible dajouter plusieurs champs d'entête.
==== custom_subject ====
**Marquage du sujet des messages** (menu Diffusion/réception)\\
Ce paramètre est optionnel. La chaîne de caractère spécifiée sera ajoutée au sujet des messages distribués dans la liste (destiné à aider les abonnés ne disposant pas d'outils de tri des messages entrants). Cette chaîne sera encadrée par les caractères [].
==== custom_vars ====
**Paramètres personnalisés** (menu Divers)
==== default_user_options ====
**Profil d'abonnement** (menu Diffusion/réception) (menu Diffusion/réception) \\
Le paragraphe "default_user_options" défini le profile pour les nouveaux abonnés.
=== mode de réception des messages (reception) ===
notice | digest | summary | nomail | mail
=== Visibilité (visibility) ===
conceal | noconceal\\ Visibilité de l'abonné dans la liste des abonnés (commande REVIEW).
==== del ====
**Qui peut supprimer des abonnés** (menu Droits d'accès)\\
Ce paramètre définit qui est autorisé à supprimer des abonnés (commande DEL).
==== delivery_time ====
**Heure d'expédition (hhmm)** (menu Diffusion/réception)
==== digest ====
**Périodicité des compilations** (menu Diffusion/réception)\\
Définition du mode compilation. Si ce paramètre est défini, les abonnés pourront sélectionner cette option pour recevoir la compilation (soit au format multipart/digest soit au format texte) plutôt que les messages individuels. Les messages sont regroupés et envoyés aux abonnés à la fréquence définie par ce paramètre.
==== digest_max_size ====
**Nombre maximum de messages par compilation** (menu Diffusion/réception)
==== distribution_ttl ====
**Délais maximum depuis la dernière synchronisation avant que celle-ci ne soit déclenchée par l'envoi d'un message** (menu Définition des sources de données)
==== dkim_feature ====
**Insérer une signature aux messages postés par la liste. ** (menu DKIM)
==== dkim_parameters ====
**Configuration de DKIM ** (menu DKIM)
==== dkim_signature_apply_on ====
**Les catégories de messages de liste qui seront signés avec DKIM.** (menu DKIM)
==== dmarc_protection ====
**Protection DMARC** (menu DKIM)
==== editor ====
**Modérateurs** (menu Définition de la liste)\\
Les modérateurs sont responsables de la modération des messages. Si la liste est modérée, les messages postés sur la liste seront d'abord adressés aux modérateurs qui pourront autoriser ou non la diffusion. Cette interface vous permet de désigner plusieurs modérateurs, en écrivant leur adresse dans un des champs\\
Remarque La définition de modérateurs n'est pas suffisante pour rendre la liste modérée ; vous devrez également éditer le paramètre "send"\\
Remarque Si la liste est modérée, n'importe quel modérateur peut valider ou rejeter un message sans l'approbation des autres modérateurs. Les messages qui ne sont ni diffusés, ni rejetés restent dans la file d'attente jusqu'à leur expiration.
==== editor_include ====
**Modérateurs définis via une source de données externe** (menu Définition de la liste)
==== expire_task ====
**Tache périodique d'expiration des abonnements** (menu Divers)\\
Ce paramètre détermine quel modèle de tache est utilisé par le processus d'expiration des abonnements. Un processus d'expiration est exécuté régulièrement ; il explite la date d'abonnement des abonnés et requiert un renouvellement de leur abonnement. S'ils ne se réabonnent pas ils sont désabonnés.
==== family_name ====
**Nom de la famille** (menu Définition de la liste)
==== footer_type ====
**Type d'attachement** (menu Diffusion/réception)\\
Les propriétaires de la liste peuvent décider d'ajouter un entête ou un pied de page aux messages diffusés. Ce paramètre détermine la façon dont l'entête ou le pied de page est ajouté aux messages.
* mime : La valeur par défaut. Sympa ajoutera l'entête (ou le pied de message) en tant qu'attachement MIME.
* append : Sympa ne va pas créer de nouvelle partie MIME, mais juste essayer d'ajouter l'entête/pied au corps du message. Les entêtes/pieds ne peuvent être ajoutés qu'à des message au format text/plain.
==== forced_reply_to ====
**Adresse de réponse forcée**
==== host ====
**Domaine internet** (menu Définition de la liste)\\
Le nom de domaine de la liste, le défaut étant le domaine du robot défini dans les fichiers de configuration du serveur.
==== include_admin ====
==== include_file ====
**Inclusion d'un fichier** (menu Définition des sources de données)\\
Inclut des abonnés depuis un fichier. Le fichier spécifié doit contenir une adresse email par ligne (les lignes préfixées par le caractère # sont ignorées).
==== include_ldap_2level_ca ====
**Extraction d'attributs utilisateurs par requête LDAP (2 passes)** (menu Définition des sources de données)
==== include_ldap_2level_query ====
**Inclusion d'une requête LDAP (2 passes)** (menu Définition des sources de données)\\
Ce paragraphe définit des paramètres pour une requête à deux passes renvoyant une liste d'adresses à abonner. En général, la première passe renvoie une liste de DN et la seconde convertit ces DN en adresses email; Cette fonctionnalité nécessite l’emploi du module Perl NetLDAP (perlldap).
==== include_ldap_ca ====
**Extraction d'attributs utilisateurs par requête LDAP** (menu Définition des sources de données)
==== include_ldap_query ====
**Inclusion d'une requête LDAP** (menu Définition des sources de données)\\
Ce paragraphe définit les paramètres d'une requête retournant une liste d'abonnés. Le module Perl NetLDAP doit avoir été préalablement installé sur le serveur.
==== include_list ====
**Inclusion d'une liste** (menu Définition des sources de données)\\
Les abonnés de la liste spécifiée seront abonnés à la liste courante. Vous pouvez inclure autant de listes que nécessaire. N'importe quelle liste peut être incluse, peut importe la définition de user_data_source pour cette liste. Vous pouvez donc inclure une liste qui elle-même inclue une autre liste. Attention cependant à ne pas inclure une liste A dans une liste B et la liste B dans la liste A, ce qui conduirait à une boucle de messagerie infinie.
==== include_remote_file ====
**Inclusion d'un fichier distant** (menu Définition des sources de données)
==== include_remote_sympa_list ====
**inclusion de liste distante** (menu Définition des sources de données)\\
Sympa peut contacter un autre serveur Sympa (en HTTPS) pour inclure les membres d'une liste distante. Il est possible d'inclure plusieurs listes, à raison d'un paragraph "remote_sympa_list" par liste. Attention à ne pas générer une boucle en incluant mutuellement des listes.
Dans ce mode, le présent site Sympa agit comme client, l'autre spécifié comme serveur. Le serveur doit autoriser le Sympa distant à accéder à la liste des membres de la liste, ce via le paramètre \"review\" (défini par un scénario).
==== include_sql_ca ====
**Extraction d'attributs utilisateurs par requête SQL** (menu Définition des sources de données)
==== include_sql_query ====
**Inclusion d'une requête SQL** (menu Définition des sources de données)\\
Ce paramètre définit une requête SQL retournant une liste d'adresses email.
==== include_voot_group ====
**Inclusion d'un groupe VOOT** (menu Définition des sources de données)
==== inclusion_notification_feature ====
**Notifier les abonnés quand ils sont inclus depuis une source de données ?** (menu Définition des sources de données)
==== info ====
**Qui a accès aux informations sur la liste** (menu Droits d'accès)
==== invite ====
**Qui peut inviter à s'abonner** (menu Droits d'accès)
==== lang ====
**Langue de la liste** (menu Définition de la liste)\\
Ce paramètre détermine la langue officielle de la liste. Il est utilisé pour déterminer la langue par défaut des abonnés ; les traductions des interfaces sont extraites du catalogue de messages correspondant.
==== latest_instantiation ====
**Dernière instanciation de la famille** (menu Divers)
==== loop_prevention_regex ====
**Expression régulière appliquée pour prévenir les boucles avec le robot de listes** (menu Divers)
==== max_list_members ====
**Nombre maximum d'abonnés** (menu Définition de la liste)
==== max_size ====
**Taille maximum des messages** (menu Diffusion/réception)\\
Taille maximale des messages autorisée (exprimée en octets) \\
5 Mo : 5242880 o --- 10 Mo : 10485760 o --- 15 Mo : 15728640 o --- 20 Mo : 20971520 o
==== member_include ====
**Utilisateurs inclus depuis des sources de données paramétrables** (menu Définition des sources de données)
==== merge_feature ====
**Autoriser la personnalisation des messages** (menu Diffusion/réception)
==== message_hook ====
**Modules de plugins pour le traitement des messages** (menu Diffusion/réception)
==== msg_topic ====
**Thèmes pour la catégorisation des messageCatégorie de la liste** (menu Diffusion/réception)\\
Ce paramètre définit un thème utilisable pour marquer les messages de la liste. Le nom du thème est msg_topic.name ("other" est un mot réservé), le titre est msg_topic.title. L'entrée msg_topic.keyword est optionnelle et permet le marquage automatique des message. Il s'agit d'une liste de mots clef, séparés par des ','.
==== msg_topic_keywords_apply_on ====
**Sur quelle partie du message les mots clef sont recherchés** (menu Diffusion/réception)\\
Ce paramètre indique quelle partie des messages permet le marquage automatique.
==== msg_topic_tagging ====
**Marquage des messages (thèmes)** (menu Diffusion/réception)\\
Ce paramètre indique si le marquage des messages est optionnel ou requis pour la liste.
==== owner ====
**Propriétaire** (menu Définition de la liste)\\
Les propriétaires gèrent les membres de la liste. Ils ont accès à la liste des abonnés, peuvent ajouter ou supprimer des adresses email de la liste. Si vous êtes propriétaire privilégié, vous pouvez nommer d'autres propriétaires pour la liste. Les propriétaires privilégiés peuvent éditer certains paramètres non éditables par les autres propriétaires.
==== owner_include ====
**Propriétaires définis via une source de données externe** (menu Définition de la liste)
==== pictures_feature ====
**Activer les avatars ?** (nécessite d'être activé au niveau du site) (menu Divers)
==== priority ====
**Priorité de la liste ** (menu Définition de la liste)\\
Le niveau de priorité pour traiter les messages de la liste. Cette priorité est appliquée aux messages dans la file d'attente. Le niveau "z" permet d'immobiliser les messages dans la file d'attente.
==== process_archive ====
**Conserver les messages distribués dans les archives** (menu Les archives)
==== reject_mail_from_automates_feature ====
**Rejeter les mails générés automatiquement (crontab, etc.) ?** (menu Diffusion/réception)
==== remind ====
**Qui peut déclencher un processus de rappel des abonnements** (menu Droits d'accès)\\
Ce paramètre définit qui peut démarrer un processus de rappel des abonnements (commande REMIND)
==== remind_return_path ====
**Adresse de retour pour la commande REMIND** (menu Gestion des erreurs)\\
Idem "welcome_return_path" mais appliqué au message de rappel
==== remind_task ====
**Tâche périodique de rappel des abonnements** (menu Divers)\\
Ce paramètre détermine quel modèle de tache est utilisé par le processus de rappel des abonnements. Un processus d'expiration est exécuté régulièrement ; il envoie à chaque abonné un message de rappel de son abonnement.
==== remove_headers ====
**En-têtes SMTP à supprimer dans les messages entrants** (menu Diffusion/réception)
==== remove_outgoing_headers ====
**En-têtes SMTP à supprimer dans les messages sortants** (menu Diffusion/réception)
==== reply_to ====
**Adresse de réponse**
==== reply_to_header ====
**Adresse de réponse** (menu Diffusion/réception)\\
Le paramètre "reply_to_header" définit à quelle valeur Sympa positionne le champ d'entête SMTP Reply-to.
=== value ===
sender | list | all | other_email (Valeur par défaut sender)
Ce paramètre indique si le champ d'entête Reply-to des messages doit être positionné à l'expéditeur du message (sender), à l'adresse de la liste (list), les deux (all) ou à une adresse arbitraire (définie par le paramètre other_email).
Remarque Ne positionnez ce paramètre à "list" qu'en connaissance de cause. Il arrive souvent qu'un abonné réponde à un message, croyant par erreur, faire une réponse en privé a l'auteur du message. Ce paramétrage peut conduire à des situations embarrassantes.
=== other_email ===
adresse_email
si value est positionné à "other_email", ce paramètre définit l'adresse email utilisée.
=== apply ===
respect | forced (Valeur par défaut respect)
Par défaut le champ d'entête SMTP Reply-to est préservé. Si ce paramètre est positionné à "forced" le champ d'entête est remplacé.
==== review ====
**Qui a accès à la liste des abonnés** (menu Droits d'accès)\\
Ce paramètre définit qui a accès à la liste des abonnés. A cause des problèmes de spam, nous vous recommandons de n'autoriser que les propriétaires de la liste ou les abonnés.
==== rfc2369_header_fields ====
**Champs d'entête compatibles RFC 2369** (menu Diffusion/réception)
==== send ====
**Qui peut diffuser des messages** (menu Diffusion/réception)\\
Ce paramètre définit qui peut poster des messages dans la liste.
==== serial ====
**Numéro de série de la config** (menu Divers)
==== shared_doc ====
**Documents partagés** (menu Droits d'accès)\\
Ce paragraphe définit les droits d'accès en lecture et en écriture sur l'espace des documents partagés.
==== spam_protection ====
**méthode de protection des adresses (contre le spam)** (menu Divers)\\
Il est nécessaire de protéger le serveur de listes contre les robots de collectages d'adresses email destinés au spam. Plusieurs méthodes sont proposées par Sympa. Les valeurs possibles sont
javascript l'adresse email est dissimulée en utilisant javascript. L'utilisateur ayant activé javascript dans son navigateur voit les adresses email affichées normalement.
at le caractère @ est remplacé par la chaîne "AT".
none pas de protection contre le spam
==== sql_fetch_timeout ====
**Délai d'attente pour la récolte des données par include_sql_query** (menu Définition des sources de données)
==== status ====
**Etat de la liste** (menu Divers)
==== subject ====
**Objet de la liste** (menu Définition de la liste)\\
Ce paramètre indique l'objet de la liste, qui aparait comme descriptif dans la liste des listes. Le format est libre, mais limité à une ligne.
==== subscribe ====
**Qui peut s'abonner** (menu Droits d'accès)\\
Le paramètre "subsribe" définit les règles de la procédure d'abonnement.
==== topics ====
**Catégorie de la liste** (menu Définition de la liste)\\
Ce paramètre permet de classer les listes. Vous pouvez choisir plusieurs catégories, éventuellement hiérarchiques. Le classement des listes publiques est construit en exploitant ce paramètre.
==== tracking ====
**Fonctionnalité de suivi des messages** (menu Gestion des erreurs)
==== ttl ====
**Expiration des inclusions** (menu Définition des sources de données)\\
Sympa gère un cache des membres issues d'une source de données externe. La durée de vie de ce cache est controllée par le paramètre "ttl". La valeur par défaut est 3600 (exprimé en secondes).
==== unsubscribe ====
**Qui peut se désabonner** (menu Droits d'accès)\\
Ce paramètre définit la méthode de désabonnement pour la liste. Optez pour 'open_notify' ou 'auth_notify' pour être alerté à chaque désabonnement.
==== update ====
**Dernière mise à jour de la config** (menu Divers)
==== user_data_source ====
**Source de données**
==== verp_rate ====
**pourcentage des abonnés en mode VERP** (menu Gestion des erreurs)
==== visibility ====
**Visibilité de la liste** (menu Définition de la liste)\\
Ce paramètre indique si la liste doit apparaître dans la liste des listes publiques.
Valeurs possibles : **conceal** ; **noconceal** ; **intranet** ; **secret**
==== web_archive ====
**Archives web**\\
Définit qui peut accéder aux archives web de la liste.
==== web_archive_spam_protection ====
**methode de protection des adresses (contre le spam)** (menu Les archives)\\
Identique au paramètre "spam_protection" mais pour les archives web. Un choix supplémentaire est proposé "cookie" qui ajoute un formulaire (positionnant un cookie) à l'entrèe des archives. Ce système bloque tous les robots, y compris Google.
==== welcome_return_path ====
**Return-path d'abonnement** (menu Gestion des erreurs)\\
S'il est positionné à "unique", le message de bienvenue comprend une adresse de retour unique, permettant de supprimer immédiatement un nouvel abonné en erreur.