Compatibilità con Flarum 1.x - 2.x
Descrizione
Estensione per Flarum basata sull'intelligenza artificiale per la moderazione dei contenuti, che analizza automaticamente i post per verificarne la civiltà utilizzando Anthropic Claude, OpenAI GPT o OpenRouter.
Funzionalità
Analisi AI
- Analizza i post in tempo reale prima della pubblicazione
- Supporta Anthropic Claude (Haiku, Sonetto, Opus), OpenAI GPT (4o-mini, 4o, 4.1) e OpenRouter (oltre 200 modelli)
- Prompt AI personalizzabile per regole di moderazione su misura
- Design fail-open: i post vengono pubblicati anche se l'API non è disponibile
Sistema di azioni a 4 livelli
Azione Soglia predefinita Comportamento
Consentito 0–59 Post pubblicato normalmente
Avvisato 60–79 Post pubblicato, registrato, utente notificato
Moderato 80–94 Post in coda di moderazione per la revisione
Bloccato 95–100 Post rifiutato, l'utente visualizza un messaggio di errore
Tutte le soglie sono configurabili con incrementi di 5 punti.
Filtro dei contenuti
Lista di parole bloccate: blocco istantaneo delle parole chiave corrispondenti senza dover chiamare l'IA (risparmiando sui costi dell'API)
Monitoraggio basato su tag: analizza solo i post con tag specifici o monitorali tutti
Esclusione dei contenuti citati: rimuove il testo citato prima dell'analisi, in modo che gli utenti non vengano penalizzati per aver citato altri
Strumenti di moderazione
Registro delle violazioni: registro impaginato e filtrabile di tutti i risultati dell'analisi
Dashboard delle statistiche: riepilogo delle azioni, categorie principali, utenti che violano più regole e grafici delle tendenze giornaliere
Analizzatore di test: testa i messaggi con l'IA prima di implementare le impostazioni
Esportazione CSV: scarica il registro completo delle violazioni per una revisione offline
Azioni rapide: approva, elimina o sospendi direttamente dalla tabella del registro
Applicazione automatica delle regole
Sospensione automatica: sospendi automaticamente gli utenti dopo X violazioni entro un intervallo di tempo configurabile
Limitazione della frequenza delle API: limita le chiamate API dell'IA all'ora per controllare i costi durante i picchi di traffico
Notifiche
Avvisi in-app: gli utenti vengono avvisati quando i loro post vengono segnalati o moderati
Avvisi Discord/Webhook: invia notifiche dettagliate Incorpora i contenuti in Discord o invia payload JSON a qualsiasi URL webhook quando i post vengono segnalati
Integrazione con il forum
Badge dei post: avvisi visivi sui post segnalati/moderati (visibili solo ad autore e staff)
Cronologia del profilo utente: statistiche di comportamento per utente e violazioni recenti (solo per amministratori)
Autorizzazione di bypass: esenta utenti/gruppi fidati dai controlli di comportamento
Installazione
composer require ralkage/flarum-ext-civility-filter
php flarum migrate
php flarum cache:clear
Attiva l'estensione nel pannello di amministrazione, nella sezione Estensioni > Filtro Civility.
Configurazione
Accedi alla pagina delle impostazioni dell'estensione nel pannello di amministrazione. Le impostazioni sono organizzate in sezioni:
Generale
Attiva Filtro di civiltà — Interruttore principale di attivazione/disattivazione
Provider AI
Provider AI — Scegli tra Anthropic (Claude), OpenAI (GPT) o OpenRouter
Chiave API Anthropic — La tua chiave API Anthropic
Chiave API OpenAI — La tua chiave API OpenAI
Chiave API OpenRouter — La tua chiave API OpenRouter (accesso a oltre 200 modelli da un'unica API)
Modello AI — Seleziona il modello per il provider scelto
Soglie
Soglia di avviso — Punteggio per attivare un avviso (predefinito: 60)
Soglia di blocco/moderazione — Punteggio per bloccare il post in attesa di moderazione (predefinito: 80)
Soglia di blocco — Punteggio per bloccare il post (predefinito: 95)
Filtri
Tag monitorati — Selettore di tag a selezione multipla per limitare i tag monitorati
Lista di blocco parole — Una parola/frase per riga, blocca istantaneamente senza AI
Prompt personalizzato
Prompt AI personalizzato — Sovrascrivi il prompt di analisi predefinito con il tuo Istruzioni
Sospensione automatica
Soglia: numero di violazioni prima della sospensione automatica (0 = disabilitata)
Durata: durata della sospensione in giorni
Periodo: conteggio delle violazioni entro questo numero di giorni
Webhook
URL del webhook: webhook di Discord o endpoint generico
Azione minima: avviso solo per questo livello di gravità o superiore
Registrazione e limiti
Registra tutti i controlli: includi i post che superano il controllo nel registro
Limite di frequenza: numero massimo di chiamate API all'ora (0 = illimitato)
Autorizzazioni
Descrizione dell'autorizzazione
Ignora il filtro di civiltà. Gli utenti con questa autorizzazione saltano tutte le analisi di civiltà.
Configura nella sezione Autorizzazioni della pagina delle impostazioni dell'estensione.
Endpoint API
Tutti gli endpoint richiedono l'autenticazione dell'amministratore, salvo diversa indicazione.
Descrizione dell'endpoint del metodo
GET /api/civility-logs Elenca i log (paginati, filtrabili)
DELETE /api/civility-logs Cancella tutti i log
GET /api/civility-logs/export Scarica l'esportazione in formato CSV
GET /api/civility-logs/stats Statistiche e tendenze
POST /api/civility-logs/test Analizzatore di test
POST /api/civility-logs/moderate Azioni rapide (approva/elimina/sospendi)
GET /api/civility-logs/user?userId=X Cronologia del comportamento di ciascun utente
Guida al punteggio
L'IA valuta i post su una scala da 0 a 100:
Intervallo di punteggio Significato
0–20 Civile, costruttivo o neutrale
21–40 Leggermente scortese o sarcastico, ma non dannoso
41–60 Tono ostile, sprezzante o antagonistico
61–80 Attacchi personali, linguaggio provocatorio, malafede Discussione
81–95 Incitamento all'odio, molestie gravi, minacce
96–100 Abuso estremo o contenuti pericolosi
Il disaccordo politico da solo non è considerato incivile. L'IA si concentra su come viene detto qualcosa, non sulla posizione assunta.
Categorie
L'IA categorizza i problemi riscontrati nei post come segue:
attacco personale · provocazione · incitamento all'odio · malafede · trolling · molestie · minacce · volgarità · discriminazione
Requisiti
Link
Potrebbero essere presenti altri aggiornamenti futuri non indicati in questa pagina, seguire i link sopra per tenersi aggiornati.
Scopri di più su come monitorare gli aggiornamenti di Flarum e delle estensioni.
