Guida di riferimento alle impostazioni del sito nascoste

[Discourse]

Questa è una #guida di riferimento per descrivere tutte le Impostazioni del sito nascoste disponibili.

Livello utente richiesto: Amministratore

Le impostazioni del sito nascoste in Discourse sono opzioni di configurazione avanzate non disponibili tramite l’interfaccia di amministrazione standard. Offrono ulteriore flessibilità per personalizzare le funzionalità della tua istanza di Discourse.

Per ulteriori informazioni sulla modifica delle impostazioni del sito nascoste, consulta: Abilita le impostazioni del sito nascoste.

Di seguito è riportata una tabella di riferimento di tutte le impostazioni del sito nascoste disponibili in Discourse.

Fondamentali

Impostazioni che ti aiutano a regolare gli aspetti fondamentali della tua istanza di Discourse:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
max_category_nesting	integer	Imposta il numero massimo di livelli di nidificazione delle categorie consentiti.	2
enable_mobile_theme	boolean	Abilita un tema specifico per dispositivi mobili. Disabilita per utilizzare uno stile responsivo su tutti i dispositivi.	TRUE
enable_upload_debug_mode	boolean	Abilita la registrazione dettagliata per i caricamenti, utile per il debug dei problemi di caricamento.	FALSE
default_theme_id	integer	L’ID del tema predefinito utilizzato per i nuovi utenti e gli utenti anonimi.	-1
enable_badge_sql	boolean	Consente l’uso di SQL per definire le query dei badge direttamente nell’interfaccia di amministrazione.	FALSE
vapid_public_key_bytes	string	Archivia la chiave pubblica utilizzata nell’autenticazione VAPID, necessaria per l’invio di notifiche push web.	“”
vapid_public_key	string	Chiave pubblica utilizzata per l’autenticazione VAPID per le notifiche push web.	“”
vapid_private_key	string	Chiave privata utilizzata per l’autenticazione VAPID per le notifiche push web.	“”
vapid_base_url	string	L’URL di base configurato per VAPID per affermare l’identità del server nelle notifiche push web.	“”
enable_passkeys	boolean	Abilita l’uso delle passkey basate su WebAuthn per un’autenticazione utente sicura senza password.	TRUE
verbose_upload_logging	boolean	Abilita registri dettagliati per le attività del processo di caricamento, utili per identificare e diagnosticare problemi con i caricamenti di file.	FALSE
verbose_auth_token_logging	boolean	Abilita la registrazione dettagliata per i processi dei token di autenticazione.	FALSE
max_suspicious_distance_km	integer	Definisce la distanza massima in chilometri tra indirizzi IP successivi affinché l’accesso sia considerato sospetto.	100
discourse_connect_csrf_protection	boolean	Abilita la protezione CSRF per l’autenticazione DiscourseConnect.	TRUE
invites_per_page	integer	Numero di inviti visualizzati per pagina nella pagina degli inviti.	40
max_notifications_per_user	integer	Numero massimo di notifiche che un utente può avere prima che quelle più vecchie vengano eliminate automaticamente.	10000
max_bookmarks_per_user	integer	Numero massimo di segnalibri che un utente può creare.	2000

Pubblicazione

Personalizza il funzionamento della pubblicazione nella tua istanza di Discourse:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
show_copy_button_on_codeblocks	boolean	Aggiungi un pulsante ai blocchi di codice per copiare il contenuto del blocco negli appunti dell’utente	TRUE
disable_watched_word_checking_in_user_fields	boolean	Disabilita il controllo delle parole monitorate nei campi utente	FALSE
max_draft_length	integer	Imposta la lunghezza massima consentita per le bozze	150000
max_drafts_per_user	integer	Numero massimo di bozze che un utente può avere	10000
group_pm_user_limit	integer	Numero massimo di utenti che possono essere inclusi in un PM di gruppo	1000

Email

Gestisci come le email vengono inviate e ricevute dalla tua piattaforma Discourse:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
bounce_score_erode_on_send	float	Riduce il punteggio di rimbalzo ogni volta che un’email viene inviata, consentendo un recupero più rapido dai rimbalzi.	0.1
email_custom_template	string	Modello HTML personalizzato per le email. Utilizzato se è necessario sovrascrivere quello predefinito.	“” (vuoto)
email_custom_css	string	CSS personalizzato per lo stile delle email. Utilizzato se è necessario sovrascrivere quello predefinito.	“” (vuoto)
email_custom_css_compiled	string	Versione compilata del CSS personalizzato per le email.	“” (vuoto)
enable_secondary_emails	boolean	Consente agli utenti di aggiungere indirizzi email secondari al proprio profilo.	TRUE
max_participant_names	integer	Numero massimo di nomi partecipanti visualizzati nelle notifiche email per i messaggi di gruppo.	10

File

Definisci come vengono gestiti i file e i caricamenti:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
max_export_file_size_kb	integer	Specifica la dimensione massima del file per le esportazioni in kilobyte.	50000
export_authorized_extensions	string	Specifica le estensioni dei file consentite per le esportazioni.	“zip”
secure_uploads_pm_only	boolean	Se vero, i caricamenti sicuri sono abilitati solo per i messaggi privati.	FALSE
enable_s3_transfer_acceleration	boolean	Se vero, abilita l’accelerazione del trasferimento Amazon S3.	FALSE
s3_http_continue_timeout	integer	Tempo in secondi di attesa per una risposta 100 Continue da S3 prima di inviare il payload della richiesta.	1
s3_install_cors_rule	boolean	Se vero, installa le regole CORS su S3 per consentire richieste da qualsiasi dominio.	TRUE
s3_presigned_get_url_expires_after_seconds	integer	Durata in secondi dopo la quale un URL firmato per gli oggetti S3 scadrà.	300
decompressed_theme_max_file_size_mb	integer	Dimensione massima del file in megabyte per un file di tema dopo la decompressione.	1000
decompressed_backup_max_file_size_mb	integer	Dimensione massima del file in megabyte per i file di backup dopo la decompressione.	100000
composer_media_optimization_image_resize_pre_multiply	boolean	Ottimizza la gestione delle immagini pre-moltiplicando l’alpha nelle manipolazioni del canvas per migliorare la qualità del ridimensionamento delle immagini.	FALSE
composer_media_optimization_image_encode_quality	integer	Qualità di codifica JPG utilizzata nel processo di ricodifica per l’ottimizzazione delle immagini.	0
composer_media_optimization_image_resize_linear_rgb	boolean	Durante il ridimensionamento, utilizza RGB lineare per migliorare la qualità dell’immagine ridimensionata.	FALSE
composer_ios_media_optimisation_image_enabled	boolean	Abilita strategie specifiche di ottimizzazione delle immagini sui dispositivi iOS per migliorare le prestazioni.	TRUE
video_thumbnails_enabled	boolean	Abilita la generazione di miniature per i file video caricati sul forum.	TRUE

Sicurezza

Regola le funzionalità di sicurezza in base alle esigenze del tuo forum:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
allow_indexing_non_canonical_urls	boolean	Consente l’indicizzazione di URL non canonici.	TRUE
non_crawler_user_agents	list	Elenco degli user agent considerati non crawler.	"trident
crawler_user_agents	list	Elenco degli user agent considerati crawler.	"rss
browser_update_user_agents	list	User agent per browser obsoleti per mostrare messaggi di aggiornamento.	"MSIE 6
crawler_check_bypass_agents	string	User agent che possono bypassare i controlli dei crawler.	“cubot”
keep_old_ip_address_count	integer	Numero di vecchi indirizzi IP da conservare per ogni utente.	0
content_security_policy_collect_reports	boolean	Abilita la raccolta dei rapporti di violazione CSP.	FALSE
allow_embedding_site_in_an_iframe	boolean	Consente l’incorporamento del sito all’interno di un iframe su altri siti.	FALSE
send_old_credential_reminder_days	integer	Numero di giorni per ricordare le credenziali vecchie. Se impostato a 0, i promemoria sono disabilitati.	0
disable_onebox_media_download_controls	boolean	Disabilita i controlli di download multimediali negli embed audio/video onebox.	FALSE
cross_origin_opener_policy_header	string	Imposta l’intestazione Cross-Origin-Opener-Policy. Scelte disponibili: unsafe-none, same-origin, same-origin-allow-popups.	“same-origin-allow-popups”

Onebox

Controlla come vengono gestiti gli onebox:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
force_get_hosts	list	Dominii in cui è forzata la richiesta GET a causa di problemi con le richieste HEAD	us.battle.net news.yahoo.com *.medium.com
onebox_user_agent	string	Definisce la stringa user agent utilizzata dal sistema Onebox durante le richieste HTTP. Se l’impostazione è vuota, ripiega su un user agent predefinito definito in Onebox.options.user_agent	“”
inline_onebox_user_agent	string	User agent personalizzato utilizzato durante il recupero delle risposte onebox inline, se specificato	“”

Limiti di velocità

Gestisci le risorse e la sicurezza attraverso i limiti di velocità:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
rate_limit_search_anon_global_per_minute	integer	Limite di velocità globale per le richieste di ricerca anonime al minuto	150
rate_limit_search_anon_user_per_minute	integer	Limite di velocità per utente per le richieste di ricerca anonime al minuto	15
rate_limit_search_anon_global_per_second	integer	Limite di velocità globale per le richieste di ricerca anonime al secondo	8
rate_limit_search_anon_user_per_second	integer	Limite di velocità per utente per le richieste di ricerca anonime al secondo	2
rate_limit_search_user	integer	Limite di velocità per utente per le richieste di ricerca da parte di utenti registrati al minuto	30
max_allowed_secondary_emails	integer	Numero massimo di email secondarie che un utente è autorizzato ad avere	10
max_batch_presign_multipart_per_minute	integer	Numero massimo di operazioni multipart con pre-firma in batch che un utente può avviare al minuto	20
max_presigned_put_per_minute	integer	Numero massimo di operazioni PUT con pre-firma che un utente può avviare al minuto	10
max_create_multipart_per_minute	integer	Numero massimo di creazioni multipart che un utente può avviare al minuto	10
max_complete_multipart_per_minute	integer	Numero massimo di completamenti multipart che un utente può avviare al minuto	10
max_uploads_per_minute	integer	Numero massimo di operazioni di caricamento che un utente può avviare al minuto	10

Sviluppatore

Adatta l’ambiente di sviluppo:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
force_hostname	string	Forza un hostname specifico per il sito.	“”
port	integer	Configura il numero di porta su cui il server ascolta.	“”
enable_chunked_encoding	boolean	Abilita le risposte con codifica chunked da parte del server, potenzialmente utile per i proxy che memorizzano nella buffer le risposte.	TRUE
long_polling_base_url	string	URL di base da utilizzare per il polling a lungo termine, utile per separare il traffico CDN dall’interazione diretta con il sito.	“/”
background_polling_interval	integer	Frequenza in millisecondi per il polling in background da parte dei client.	60000
polling_interval	integer	Frequenza in millisecondi per il polling attivo da parte dei client registrati.	3000
anon_polling_interval	integer	Frequenza in millisecondi per cui i client anonimi interrogano il server.	25000
rebake_old_posts_count	integer	Numero di post che vengono rielaborati dalle attività automatizzate in esecuzione in background.	80
migrate_to_new_scheme	boolean	Attiva o disattiva la migrazione dei vecchi caricamenti a un nuovo schema di archiviazione, utilizzato principalmente durante gli aggiornamenti.	FALSE
max_new_topics	integer	Numero massimo di nuovi argomenti che un utente può creare, utilizzato per prevenire spam o sovraccarico del sistema.	500
wizard_enabled	boolean	Abilita o disabilita la procedura guidata di configurazione mostrata dopo l’installazione.	TRUE
bypass_wizard_check	boolean	Consente di bypassare il controllo di completamento della procedura guidata di configurazione, utile per sviluppatori o configurazioni automatizzate.	FALSE
logging_provider	enum	Determina il framework di registrazione per l’applicazione. Può essere ‘default’ o un framework alternativo supportato.	“default”
bootstrap_error_pages	boolean	Abilita o disabilita le pagine di errore con stile bootstrap. Utile per mantenere la coerenza dello stile nelle pagine di errore.	FALSE
include_associated_account_ids	boolean	Includi gli ID degli account associati in certi output—utile per una gestione più connessa dei dati degli account.	FALSE
max_sidebar_section_links	integer	Numero massimo di link per sezione della barra laterale, controllando il disordine dell’interfaccia e le prestazioni.	50
instrument_gc_stat_per_request	boolean	Se raccogliere e registrare le statistiche di raccolta dei rifiuti per ogni richiesta HTTP—utile per l’ottimizzazione delle prestazioni.	FALSE
warn_critical_js_deprecations	boolean	Abilita gli avvisi per le deprecazioni critiche di JavaScript per gli amministratori—aiuta nella preparazione per aggiornamenti o correzioni.	TRUE
warn_critical_js_deprecations_message	string	Messaggio personalizzato aggiunto agli avvisi di deprecazione JS critici, rendendo le notifiche più informative.	“”

Incorporamento

Consenti o limita l’incorporamento dei contenuti:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
embed_by_username	string	Nome utente da utilizzare per i contenuti incorporati.	“”
embed_post_limit	integer	Numero massimo di post da incorporare da una fonte esterna.	100
embed_topic_limit_per_page	integer	Numero massimo di argomenti visualizzati per pagina per gli argomenti incorporati.	200
embed_title_scrubber	string	Espressione regolare utilizzata per pulire o modificare i titoli nei contenuti incorporati.	“”
blocked_embed_selectors	string	Selettori CSS che specificano gli elementi da escludere dai contenuti incorporati.	“”
allowed_embed_classnames	string	Nomi di classe consentiti nei contenuti incorporati, aiuta a filtrare lo stile dei contenuti.	“emoji”

Backup

Personalizza le configurazioni di backup:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
include_s3_uploads_in_backups	boolean	Determina se i caricamenti archiviati in S3 devono essere inclusi nei backup del sito.	FALSE

Ricerca

Ottimizza la funzionalità di ricerca all’interno del tuo sito Discourse:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
prioritize_exact_search_title_match	boolean	Dà priorità ai risultati di ricerca che corrispondono esattamente ai termini di ricerca nei titoli.	TRUE
max_duplicate_search_index_terms	integer	Imposta il numero massimo di termini duplicati indicizzati per la ricerca.	6
use_pg_headlines_for_excerpt	boolean	Abilita il supporto headline di Postgres per la generazione di estratti di ricerca.	FALSE
search_max_indexed_word_length	integer	Lunghezza massima delle parole indicizzate per la ricerca.	100
search_ranking_normalization	string	Controlla la normalizzazione dei punteggi di ricerca per migliorare la pertinenza dei risultati.	“0”
search_ranking_weights	string	Imposta i fattori di ponderazione utilizzati nei calcoli del punteggio di ricerca.	“”
search_recent_regular_posts_offset_post_id	integer	Offset dell’ID post per il recupero dei post recenti nei risultati di ricerca.	0
search_enable_recent_regular_posts_offset_size	integer	Determina il numero di post recenti da considerare nella ricerca.	200000
category_search_priority_low_weight	float	Imposta la ponderazione inferiore per la prioritizzazione delle categorie nei risultati di ricerca.	0.8
category_search_priority_high_weight	float	Imposta la ponderazione superiore per la prioritizzazione delle categorie nei risultati di ricerca.	1.2
search_page_size	integer	Numero di risultati per pagina nelle query di ricerca.	50

Non classificati

Varie impostazioni che non rientrano in altre categorie:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
has_login_hint	boolean	Determina se devono apparire suggerimenti per l’accesso	FALSE
min_new_topics_time	integer	Tempo minimo tra i nuovi argomenti	0
general_category_id	integer	ID per la categoria generale	-1
meta_category_id	integer	ID per la categoria meta	-1
staff_category_id	integer	ID per la categoria dello staff	-1
uncategorized_category_id	integer	ID per la categoria non classificata	-1
backup_drafts_to_pm_length	integer	Lunghezza delle bozze nei PM prima che sia necessario il backup	0
view_user_route	string	Sezione predefinita della pagina del profilo utente	“summary”
tos_topic_id	integer	ID per l’argomento dei Termini di servizio	-1
guidelines_topic_id	integer	ID per l’argomento delle linee guida	-1
privacy_topic_id	integer	ID per l’argomento della politica sulla privacy	-1
welcome_topic_id	integer	ID per l’argomento di benvenuto	-1
admin_quick_start_topic_id	integer	ID per l’argomento della guida rapida per gli amministratori	-1
ios_app_id	string	ID App Store per l’app iOS	“1173672076”
android_app_id	string	ID Play Store per l’app Android	“com.discourse”
pwa_display_browser_regex	string	Regex per determinare se la visualizzazione PWA è impostata su ‘browser’	“a^”
always_include_topic_excerpts	boolean	Includi estratti degli argomenti ogni volta	FALSE
max_bulk_invites	integer	Numero massimo di inviti in massa possibili	50,000
skip_email_bulk_invites	boolean	Salta l’invio di email negli inviti in massa	FALSE
max_api_invites	integer	Numero massimo di inviti per richiesta API	200
overridden_robots_txt	string	Regole personalizzate per robots.txt	“”
show_category_definitions_in_topic_lists	boolean	Mostra i post di definizione della categoria nelle liste degli argomenti	FALSE
max_automatic_membership_email_domains	integer	Numero massimo di domini email per l’iscrizione automatica possibili	50

API

Gestisci il funzionamento dell’API all’interno della tua istanza di Discourse:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
api_key_last_used_epoch	integer	Traccia l’ultimo tempo epoch utilizzato per le chiavi API. Non direttamente accessibile o modificabile.	# Il valore viene aggiunto in una migrazione
revoke_api_keys_maxlife_days	integer	Numero di giorni prima che una chiave API venga revocata automaticamente, impostato a 0 per mai.	0

Dashboard

Regola quali report vengono visualizzati nella dashboard di amministrazione e come vengono definiti gli argomenti caldi:

Impostazione del sito	Tipo	Descrizione	Valore predefinito
verbose_user_stat_count_logging	boolean	Abilita la registrazione dettagliata per gli aggiornamenti del conteggio delle statistiche utente.	FALSE
hot_topics_gravity	float	Controlla l’impostazione di gravità utilizzata nel calcolo degli argomenti caldi.	1.2
hot_topics_recent_days	integer	Definisce il numero di giorni recenti da considerare per il calcolo dei punteggi degli argomenti caldi.	7