# Modalità scura

> Il tema della community (Chiaro, Scuro o Automatico, che segue il dispositivo), il logo per sfondo scuro, la scelta di ogni persona in Il mio account › Aspetto e cosa resta chiaro.

La community può apparire con sfondo chiaro, con sfondo scuro o seguire il tema del dispositivo di ogni persona. La scelta vale per tutta l'app, **Amministrazione** inclusa.

## A cosa serve

Per chi passa ore nella community di sera, per un marchio che è già scuro (uno studio musicale, una community di videogiochi) o semplicemente per rispettare ciò che ogni persona ha scelto su telefono e computer.

## Come funziona

### La modalità della community

In **Impostazioni › Marchio e aspetto**, la scheda **Tema** (*"Come appare la community a chi non ha scelto un altro tema. Vale per tutta l'app, Amministrazione inclusa."*) ha il campo **Modalità**:

| Modalità | Cosa fa |
|---|---|
| **Chiaro** (predefinita) | *"Sfondo chiaro, come sempre."* |
| **Scuro** | *"Sfondo scuro in tutte le schermate."* |
| **Automatico** | *"Segue il tema del dispositivo di ogni persona."* Se la persona cambia il tema del dispositivo, la community cambia insieme, senza ricaricare |

Non c'è un pulsante per salvare: la modalità vale appena ci clicchi. I [colori](/configuracoes/cores) della community restano validi, con le tonalità adattate allo sfondo scuro.

### Attivato da Memberfy

Il tema scuro viene attivato da Memberfy, community per community. Senza attivazione, il campo **Modalità** mostra solo **Chiaro**, con l'avviso *"Il tema scuro non è ancora attivo per questa community. Per usarlo, contatta il supporto Memberfy."*

Se l'attivazione viene tolta, la community torna chiara per tutti; la modalità che avevi scelto resta salvata e torna quando il tema viene riattivato.

### Logo per sfondo scuro

Con il tema attivo, la scheda **Tema** mostra il **Logo per sfondo scuro**, usato al posto del logo quando lo schermo è nel tema scuro. Senza, il logo normale appare su una placca chiara per restare leggibile. L'ideale è un **PNG con sfondo trasparente** (accetta anche JPG e WebP). **Carica logo** lo carica, **Sostituisci logo** lo cambia e il cestino (**Rimuovi il logo per sfondo scuro**) torna al logo normale sulla placca. Caricare il logo per sfondo scuro non cambia il logo normale (vedi [Immagini e SEO](/configuracoes/imagens-e-seo)).

### Cosa resta chiaro

Le **e-mail**, i **certificati** e la **grafica del riconoscimento** restano chiari in ogni modalità: sono fatti per essere stampati, scaricati o aperti altrove, dove lo sfondo della community non vale.

### La scelta di ogni persona

Con il tema attivo, ogni persona ha la sezione **Il mio account › Aspetto** (*"Il tema che vedi in questa community."*), con il campo **Tema**:

| Opzione | Cosa fa |
|---|---|
| **Segui la community** (predefinita) | La modalità scelta dalla community (*"Ora: chiaro."*, *"Ora: automatico, dal dispositivo."*) |
| **Chiaro** | *"Sempre con sfondo chiaro."* |
| **Scuro** | *"Sempre con sfondo scuro."* |
| **Dispositivo** | *"Chiaro o scuro, come il tuo dispositivo."* |

La scelta *"Vale solo in questo browser e in questa community."*: non viene inviata al server, quindi in un altro browser, su un altro dispositivo o in un'altra community la persona torna a vedere la modalità della community. Senza attivazione, la sezione **Aspetto** non appare.

### Chi può

La modalità della community e il logo per sfondo scuro: **proprietario** e **amministratore**. La scelta in **Il mio account › Aspetto**: chiunque, per sé.

## Passo dopo passo

*Ruolo: proprietario o amministratore.*

1. **Impostazioni › Marchio e aspetto**, scheda **Tema**.
2. In **Modalità**, clicca su **Scuro** o **Automatico**. Se appare solo **Chiaro**, contatta il supporto Memberfy per attivare il tema scuro.
3. In **Logo per sfondo scuro**, **Carica logo** e scegli un PNG con sfondo trasparente.
4. Apri la community sul telefono con il tema scuro attivo e controlla l'intestazione e i pulsanti.

*Per te:* **Il mio account › Aspetto** e scegli **Chiaro**, **Scuro**, **Dispositivo** o **Segui la community**.

## Esempi

**Community di videogiochi.** Modalità **Scuro**, con il logo bianco in PNG trasparente come **Logo per sfondo scuro**. Chi preferisce leggere su sfondo chiaro sceglie **Chiaro** in **Il mio account › Aspetto**.

**Scuola con pubblico vario.** Modalità **Automatico**: chi usa il telefono nel tema scuro vede la scuola scura; chi lo usa chiaro, la vede chiara. I certificati continuano a uscire chiari.

## Consigli

- Scegli **Automatico** se non sei sicuro: ognuno la vede come già usa il dispositivo.
- Il logo per sfondo scuro di solito è la versione bianca o chiara del marchio.
- Dopo l'attivazione, controlla i colori della community al buio: una tonalità primaria molto scura può perdere contrasto con lo sfondo.

## Errori comuni e come risolverli

| Situazione | Cosa fare |
|---|---|
| In **Modalità** appare solo **Chiaro** | Il tema scuro non è ancora attivo per la community: contatta il supporto Memberfy |
| Il logo appare su una placca chiara nel tema scuro | Carica il **Logo per sfondo scuro** |
| Ho scelto **Scuro** in **Il mio account › Aspetto** e sull'altro computer è chiaro | La scelta vale solo in quel browser: sceglila di nuovo nell'altro |
| Non trovo **Il mio account › Aspetto** | La sezione appare solo quando la community ha il tema scuro attivo |

## Domande frequenti

**Le e-mail che la community invia diventano scure?**
No. E-mail, certificati e la grafica del riconoscimento restano chiari.

**Anche l'Amministrazione diventa scura?**
Sì. La modalità vale per tutta l'app.

**La modalità scelta si perde se l'attivazione viene tolta?**
No. La community appare chiara finché non è attiva, e la modalità scelta torna quando viene riattivata.

**L'assistente (MCP) cambia il tema?**
No. Il tema si cambia dalla schermata o tramite l'API.

## Nell'API

- Le letture della community portano `appearance`: `mode` (`light`, `dark` o `auto`, ciò che la community ha scelto), `effectiveMode` (ciò che vale ora: `light` finché il tema non è attivo), `darkLogoUrl` e `darkModeAllowed`. Una community che non l'ha mai cambiato legge `light`, senza logo per sfondo scuro.
- [`PATCH /api/communities/appearance`](/api/referencia/communities/update-community-appearance) (proprietario e amministratore): `mode` e `darkLogoUrl` (`null` lo rimuove). `dark` o `auto` senza attivazione rispondono `422`; inviare di nuovo lo stesso stato risponde `changed: false`. La modifica finisce nei [Log](/membros/registros-de-atividades).
- [`POST /api/upload/community/logo`](/api/referencia/uploads/post-upload-community-logo) con `variant=dark` carica il file del logo per sfondo scuro e restituisce solo `data.url`, senza sostituire il logo normale; poi salva l'URL con il `PATCH` qui sopra.

## Con l'assistente (MCP)

Chiedi all'assistente di cambiare il tema o il logo per sfondo scuro (*"metti la community sul tema automatico"*), con [`update_community_appearance`](/mcp/ferramentas-comunidade#update-community-appearance), per il proprietario e l'amministratore; chiede sempre conferma. [`get_community_settings`](/mcp/ferramentas-comunidade#get-community-settings) mostra il tema attuale e se lo scuro è attivo.

## Correlati

- [Colori](/configuracoes/cores)
- [Immagini e SEO](/configuracoes/imagens-e-seo)
- [Account e profilo](/conceitos/conta-e-perfil)