Ceci est un guide de #référence pour décrire tous les paramètres de site cachés disponibles.
Niveau d’utilisateur requis : Administrateur
Les paramètres de site cachés dans Discourse sont des options de configuration avancées qui ne sont pas disponibles via l’interface d’administration standard. Ils offrent une flexibilité supplémentaire pour personnaliser le fonctionnement de votre instance Discourse.
Pour plus d’informations sur la modification des paramètres de site cachés, consultez : Activer les paramètres de site cachés.
Ci-dessous se trouve un tableau de référence de tous les paramètres de site cachés disponibles dans Discourse.
Base
Paramètres permettant d’ajuster les aspects fondamentaux de votre instance Discourse :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| max_category_nesting | entier | Définit le nombre maximal de niveaux de hiérarchie de catégories autorisés. | 2 |
| enable_mobile_theme | booléen | Active un thème spécifique aux mobiles. Désactivez pour utiliser une feuille de style réactive sur tous les appareils. | VRAI |
| enable_upload_debug_mode | booléen | Active la journalisation détaillée pour les téléversements, utile pour déboguer les problèmes de téléversement. | FAUX |
| default_theme_id | entier | L’ID de thème par défaut utilisé pour les nouveaux utilisateurs et les utilisateurs anonymes. | -1 |
| enable_badge_sql | booléen | Autorise l’utilisation de SQL pour définir directement les requêtes de badges dans l’interface d’administration. | FAUX |
| vapid_public_key_bytes | chaîne | Stocke la clé publique utilisée dans l’authentification VAPID, nécessaire pour l’envoi de notifications Web Push. | “” |
| vapid_public_key | chaîne | Clé publique utilisée pour l’authentification VAPID pour les notifications Web Push. | “” |
| vapid_private_key | chaîne | Clé privée utilisée pour l’authentification VAPID pour les notifications Web Push. | “” |
| vapid_base_url | chaîne | L’URL de base configurée pour VAPID afin d’affirmer l’identité du serveur dans les notifications Web Push. | “” |
| enable_passkeys | booléen | Active l’utilisation des passkeys basées sur WebAuthn pour une authentification utilisateur sécurisée sans mot de passe. | VRAI |
| verbose_upload_logging | booléen | Active des journaux détaillés pour les activités du processus de téléversement, ce qui aide à identifier et diagnostiquer les problèmes de téléversement de fichiers. | FAUX |
| verbose_auth_token_logging | booléen | Active la journalisation détaillée pour les processus de jetons d’authentification. | FAUX |
| max_suspicious_distance_km | entier | Définit la distance maximale en kilomètres entre les adresses IP successives pour qu’une connexion soit considérée comme suspecte. | 100 |
| discourse_connect_csrf_protection | booléen | Active la protection CSRF pour l’authentification DiscourseConnect. | VRAI |
| invites_per_page | entier | Nombre d’invitations affichées par page sur la page d’invitation. | 40 |
| max_notifications_per_user | entier | Nombre maximal de notifications qu’un utilisateur peut avoir avant que les anciennes ne soient automatiquement supprimées. | 10000 |
| max_bookmarks_per_user | entier | Nombre maximal de favoris qu’un utilisateur peut créer. | 2000 |
Publication
Personnalisez le fonctionnement de la publication au sein de votre instance Discourse :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| show_copy_button_on_codeblocks | booléen | Ajoute un bouton aux blocs de code pour copier le contenu du bloc dans le presse-papiers de l’utilisateur. | VRAI |
| disable_watched_word_checking_in_user_fields | booléen | Désactive la vérification des mots surveillés dans les champs utilisateur. | FAUX |
| max_draft_length | entier | Définit la longueur maximale autorisée pour les brouillons. | 150000 |
| max_drafts_per_user | entier | Nombre maximal de brouillons qu’un utilisateur peut avoir. | 10000 |
| group_pm_user_limit | entier | Nombre maximal d’utilisateurs pouvant être inclus dans un MP de groupe. | 1000 |
Gérez l’envoi et la réception des e-mails depuis votre plateforme Discourse :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| bounce_score_erode_on_send | flottant | Réduit le score de rebond à chaque envoi d’e-mail, permettant une récupération plus rapide après des rebonds. | 0.1 |
| email_custom_template | chaîne | Modèle HTML personnalisé pour les e-mails. Utilisé si le modèle par défaut doit être remplacé. | “” (vide) |
| email_custom_css | chaîne | CSS personnalisé pour le style des e-mails. Utilisé si le modèle par défaut doit être remplacé. | “” (vide) |
| email_custom_css_compiled | chaîne | Version compilée du CSS personnalisé pour les e-mails. | “” (vide) |
| enable_secondary_emails | booléen | Permet aux utilisateurs d’ajouter des adresses e-mail secondaires à leur profil. | VRAI |
| max_participant_names | entier | Nombre maximal de noms de participants affichés dans les notifications e-mail pour les messages de groupe. | 10 |
Fichiers
Définissez comment les fichiers et les téléversements sont gérés :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| max_export_file_size_kb | entier | Spécifie la taille maximale des fichiers d’exportation en kilo-octets. | 50000 |
| export_authorized_extensions | chaîne | Spécifie les extensions de fichiers autorisées pour les exportations. | “zip” |
| secure_uploads_pm_only | booléen | Si vrai, les téléversements sécurisés sont activés uniquement pour les messages privés. | FAUX |
| enable_s3_transfer_acceleration | booléen | Si vrai, active l’accélération de transfert Amazon S3. | FAUX |
| s3_http_continue_timeout | entier | Temps en secondes d’attente d’une réponse 100 Continue de S3 avant d’envoyer la charge utile de la requête. | 1 |
| s3_install_cors_rule | booléen | Si vrai, installe des règles CORS sur S3 pour autoriser les requêtes de n’importe quel domaine. | VRAI |
| s3_presigned_get_url_expires_after_seconds | entier | Durée en secondes après laquelle une URL signée pour les objets S3 expirera. | 300 |
| decompressed_theme_max_file_size_mb | entier | Taille maximale en mégaoctets d’un fichier de thème après décompression. | 1000 |
| decompressed_backup_max_file_size_mb | entier | Taille maximale en mégaoctets des fichiers de sauvegarde après décompression. | 100000 |
| composer_media_optimization_image_resize_pre_multiply | booléen | Optimise la gestion des images en pré-multipliant l’alpha dans les manipulations de canevas pour améliorer la qualité du redimensionnement. | FAUX |
| composer_media_optimization_image_encode_quality | entier | Qualité d’encodage JPG utilisée dans le processus de réencodage pour l’optimisation des images. | 0 |
| composer_media_optimization_image_resize_linear_rgb | booléen | Lors du redimensionnement, utilisez le RVB linéaire pour améliorer la qualité de l’image redimensionnée. | FAUX |
| composer_ios_media_optimisation_image_enabled | booléen | Active des stratégies d’optimisation d’image spécifiques sur les appareils iOS pour améliorer les performances. | VRAI |
| video_thumbnails_enabled | booléen | Active la génération de miniatures pour les fichiers vidéo téléversés sur le forum. | VRAI |
Sécurité
Ajustez les fonctionnalités de sécurité pour répondre aux besoins de votre forum :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| allow_indexing_non_canonical_urls | booléen | Autorise l’indexation des URL non canoniques. | VRAI |
| non_crawler_user_agents | liste | Liste des agents utilisateur considérés comme non-crawlers. | "trident |
| crawler_user_agents | liste | Liste des agents utilisateur considérés comme crawlers. | "rss |
| browser_update_user_agents | liste | Agents utilisateur pour les navigateurs obsolètes afin d’afficher des messages de mise à jour. | "MSIE 6 |
| crawler_check_bypass_agents | chaîne | Agents utilisateur pouvant contourner les vérifications des crawlers. | “cubot” |
| keep_old_ip_address_count | entier | Nombre d’anciennes adresses IP à conserver pour chaque utilisateur. | 0 |
| content_security_policy_collect_reports | booléen | Active la collecte des rapports de violation CSP. | FAUX |
| allow_embedding_site_in_an_iframe | booléen | Autorise l’intégration du site dans un iframe sur d’autres sites. | FAUX |
| send_old_credential_reminder_days | entier | Nombre de jours pour rappeler les anciennes identifiants. Si défini à 0, les rappels sont désactivés. | 0 |
| disable_onebox_media_download_controls | booléen | Désactive les contrôles de téléchargement multimédia dans les intégrations audio/vidéo onebox. | FAUX |
| cross_origin_opener_policy_header | chaîne | Définit l’en-tête Cross-Origin-Opener-Policy. Choix disponibles : unsafe-none, same-origin, same-origin-allow-popups. | “same-origin-allow-popups” |
Onebox
Contrôlez la gestion des oneboxes :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| force_get_hosts | liste | Domaines où la requête GET est forcée en raison de problèmes avec les requêtes HEAD | us.battle.net news.yahoo.com *.medium.com |
| onebox_user_agent | chaîne | Définit la chaîne d’agent utilisateur utilisée par le système Onebox lors des requêtes HTTP. Si le paramètre est vide, il revient à un agent utilisateur par défaut défini dans Onebox.options.user_agent |
“” |
| inline_onebox_user_agent | chaîne | Agent utilisateur personnalisé utilisé lors de la récupération des réponses onebox en ligne, si spécifié | “” |
Limites de débit
Gérez les ressources et la sécurité via des limites de débit :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| rate_limit_search_anon_global_per_minute | entier | Limite de débit globale pour les requêtes de recherche anonymes par minute | 150 |
| rate_limit_search_anon_user_per_minute | entier | Limite de débit par utilisateur pour les requêtes de recherche anonymes par minute | 15 |
| rate_limit_search_anon_global_per_second | entier | Limite de débit globale pour les requêtes de recherche anonymes par seconde | 8 |
| rate_limit_search_anon_user_per_second | entier | Limite de débit par utilisateur pour les requêtes de recherche anonymes par seconde | 2 |
| rate_limit_search_user | entier | Limite de débit par utilisateur pour les requêtes de recherche par les utilisateurs connectés par minute | 30 |
| max_allowed_secondary_emails | entier | Nombre maximal d’e-mails secondaires qu’un utilisateur est autorisé à avoir | 10 |
| max_batch_presign_multipart_per_minute | entier | Nombre maximal d’opérations multipart de pré-signature par lots qu’un utilisateur peut initier par minute | 20 |
| max_presigned_put_per_minute | entier | Nombre maximal d’opérations PUT pré-signées qu’un utilisateur peut initier par minute | 10 |
| max_create_multipart_per_minute | entier | Nombre maximal de créations multipart qu’un utilisateur peut initier par minute | 10 |
| max_complete_multipart_per_minute | entier | Nombre maximal de complétions multipart qu’un utilisateur peut initier par minute | 10 |
| max_uploads_per_minute | entier | Nombre maximal d’opérations de téléversement qu’un utilisateur peut initier par minute | 10 |
Développeur
Adaptez l’environnement de développement :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| force_hostname | chaîne | Force un nom d’hôte spécifique pour le site. | “” |
| port | entier | Configure le numéro de port sur lequel le serveur écoute. | “” |
| enable_chunked_encoding | booléen | Active les réponses en codage chunké par le serveur, pouvant aider avec les proxies qui mettent en mémoire tampon les réponses. | VRAI |
| long_polling_base_url | chaîne | URL de base à utiliser pour le polling long, utile pour séparer le trafic CDN de l’interaction directe avec le site. | “/” |
| background_polling_interval | entier | Fréquence en millisecondes pour le polling en arrière-plan par les clients. | 60000 |
| polling_interval | entier | Fréquence en millisecondes pour le polling actif par les clients connectés. | 3000 |
| anon_polling_interval | entier | Fréquence en millisecondes pour le polling des clients anonymes vers le serveur. | 25000 |
| rebake_old_posts_count | entier | Nombre de posts régénérés par les tâches automatisées s’exécutant en arrière-plan. | 80 |
| migrate_to_new_scheme | booléen | Bascule si les anciens téléversements doivent être migrés vers un nouveau schéma de stockage, principalement utilisé lors des mises à jour. | FAUX |
| max_new_topics | entier | Nombre maximal de nouveaux sujets qu’un utilisateur peut créer, utilisé pour éviter le spam ou la surcharge du système. | 500 |
| wizard_enabled | booléen | Active ou désactive l’assistant de configuration affiché après l’installation. | VRAI |
| bypass_wizard_check | booléen | Permet de contourner la vérification de complétion de l’assistant de configuration, utile pour les développeurs ou les configurations automatisées. | FAUX |
| logging_provider | énumération | Détermine le framework de journalisation de l’application. Peut être ‘default’ ou un framework alternatif pris en charge. | “default” |
| bootstrap_error_pages | booléen | Active ou désactive les pages d’erreur amorcées et stylisées. Utile pour maintenir la cohérence du style sur les pages d’erreur. | FAUX |
| include_associated_account_ids | booléen | Inclut les identifiants des comptes associés dans certaines sorties—utile pour une gestion plus connectée des données de compte. | FAUX |
| max_sidebar_section_links | entier | Nombre maximal de liens par section de la barre latérale, contrôlant l’encombrement de l’interface et les performances. | 50 |
| instrument_gc_stat_per_request | booléen | Si collecter et journaliser les statistiques de collecte des déchets pour chaque requête HTTP—utile pour le réglage des performances. | FAUX |
| warn_critical_js_deprecations | booléen | Active les avertissements pour les dépréciations JavaScript critiques pour les administrateurs—aide à préparer les mises à niveau ou les corrections. | VRAI |
| warn_critical_js_deprecations_message | chaîne | Message personnalisé ajouté aux avertissements de dépréciation JS critiques, rendant les notifications plus informatives. | “” |
Intégration
Autoriser ou restreindre l’intégration de contenu :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| embed_by_username | chaîne | Nom d’utilisateur à utiliser pour le contenu intégré. | “” |
| embed_post_limit | entier | Nombre maximal de posts à intégrer depuis une source externe. | 100 |
| embed_topic_limit_per_page | entier | Nombre maximal de sujets affichés par page pour les sujets intégrés. | 200 |
| embed_title_scrubber | chaîne | Expression régulière utilisée pour nettoyer ou modifier les titres dans le contenu intégré. | “” |
| blocked_embed_selectors | chaîne | Sélecteurs CSS spécifiant les éléments à exclure du contenu intégré. | “” |
| allowed_embed_classnames | chaîne | Noms de classes autorisés dans le contenu intégré, aide à filtrer le style du contenu. | “emoji” |
Sauvegardes
Personnalisez les configurations de sauvegarde :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| include_s3_uploads_in_backups | booléen | Détermine si les téléversements stockés dans S3 doivent être inclus dans les sauvegardes du site. | FAUX |
Recherche
Optimisez la fonctionnalité de recherche au sein de votre site Discourse :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| prioritize_exact_search_title_match | booléen | Donne la priorité aux résultats de recherche qui correspondent exactement aux termes de recherche dans les titres. | VRAI |
| max_duplicate_search_index_terms | entier | Définit le nombre maximal de termes dupliqués indexés pour la recherche. | 6 |
| use_pg_headlines_for_excerpt | booléen | Active le support des titres Postgres pour générer des extraits de recherche. | FAUX |
| search_max_indexed_word_length | entier | Longueur maximale des mots indexés pour la recherche. | 100 |
| search_ranking_normalization | chaîne | Contrôle la normalisation des classements de recherche pour améliorer la pertinence des résultats. | “0” |
| search_ranking_weights | chaîne | Définit les facteurs de pondération utilisés dans les calculs de classement de recherche. | “” |
| search_recent_regular_posts_offset_post_id | entier | Décalage d’ID de post pour récupérer les posts récents dans les résultats de recherche. | 0 |
| search_enable_recent_regular_posts_offset_size | entier | Détermine le nombre de posts récents réguliers à considérer dans la recherche. | 200000 |
| category_search_priority_low_weight | flottant | Définit la pondération inférieure pour la priorisation des catégories dans les résultats de recherche. | 0.8 |
| category_search_priority_high_weight | flottant | Définit la pondération supérieure pour la priorisation des catégories dans les résultats de recherche. | 1.2 |
| search_page_size | entier | Nombre de résultats par page dans les requêtes de recherche. | 50 |
Divers
Divers paramètres qui ne correspondent pas aux autres catégories :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| has_login_hint | booléen | Détermine si des indices de connexion doivent apparaître | FAUX |
| min_new_topics_time | entier | Temps minimum entre les nouveaux sujets | 0 |
| general_category_id | entier | ID pour la catégorie générale | -1 |
| meta_category_id | entier | ID pour la catégorie méta | -1 |
| staff_category_id | entier | ID pour la catégorie du personnel | -1 |
| uncategorized_category_id | entier | ID pour la catégorie non catégorisée | -1 |
| backup_drafts_to_pm_length | entier | Longueur des brouillons dans les MP avant qu’une sauvegarde ne soit nécessaire | 0 |
| view_user_route | chaîne | Section par défaut de la page de profil utilisateur | “summary” |
| tos_topic_id | entier | ID pour le sujet des Conditions d’utilisation | -1 |
| guidelines_topic_id | entier | ID pour le sujet des directives | -1 |
| privacy_topic_id | entier | ID pour le sujet de la politique de confidentialité | -1 |
| welcome_topic_id | entier | ID pour le sujet de bienvenue | -1 |
| admin_quick_start_topic_id | entier | ID pour le sujet du guide de démarrage rapide pour administrateurs | -1 |
| ios_app_id | chaîne | ID App Store pour l’application iOS | “1173672076” |
| android_app_id | chaîne | ID Play Store pour l’application Android | “com.discourse” |
| pwa_display_browser_regex | chaîne | Regex pour déterminer si l’affichage PWA est défini sur ‘browser’ | “a^” |
| always_include_topic_excerpts | booléen | Inclure les extraits de sujet à chaque fois | FAUX |
| max_bulk_invites | entier | Nombre maximal d’invitations en masse possibles | 50000 |
| skip_email_bulk_invites | booléen | Ignorer l’envoi d’e-mails dans les invitations en masse | FAUX |
| max_api_invites | entier | Nombre maximal d’invitations par requête API | 200 |
| overridden_robots_txt | chaîne | Règles personnalisées pour robots.txt | “” |
| show_category_definitions_in_topic_lists | booléen | Afficher les posts de définition de catégorie dans les listes de sujets | FAUX |
| max_automatic_membership_email_domains | entier | Nombre maximal de domaines e-mail d’appartenance automatique possibles | 50 |
API
Gérez le fonctionnement de l’API au sein de votre instance Discourse :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| api_key_last_used_epoch | entier | Suit le temps epoch de la dernière utilisation des clés API. Non directement accessible ou modifiable. | # La valeur est ajoutée dans une migration |
| revoke_api_keys_maxlife_days | entier | Nombre de jours avant qu’une clé API ne soit automatiquement révoquée, défini à 0 pour jamais. | 0 |
Tableau de bord
Ajustez les rapports affichés dans le tableau de bord administrateur et la définition des sujets populaires :
| Paramètre de site | Type | Description | Valeur par défaut |
|---|---|---|---|
| verbose_user_stat_count_logging | booléen | Active la journalisation détaillée pour les mises à jour des comptes de statistiques utilisateurs. | FAUX |
| hot_topics_gravity | flottant | Contrôle le paramètre de gravité utilisé dans le calcul des sujets populaires. | 1.2 |
| hot_topics_recent_days | entier | Définit le nombre de jours récents à considérer pour le calcul des scores des sujets populaires. | 7 |