Creare un tema custom (skin) per RoundCube
Personalizzare l'aspetto di RoundCube con un tema custom permette di allineare la webmail al brand aziendale del cliente. RoundCube usa un sistema di skin estensibili: il tema Elastic e' una base SASS che puoi clonare e modificare. G Tech Group costruisce regolarmente skin custom per i clienti business che vogliono una webmail con i loro colori.
Architettura skin RoundCube
Ogni skin vive in skins/NOME/. Contiene: meta.json (manifest), styles.less o sass/ (sorgenti), templates/ (HTML override), images/. Le skin possono ereditare da una skin padre (es. elastic) e sovrascrivere solo i file necessari.
Strumenti necessari
Per buildare i CSS da SASS serve Node.js, lessc o sassc. Per le modifiche minimali puoi solo aggiungere un styles.css custom dopo il caricamento elastic. Per modifiche profonde occorre fork del repository elastic e build via gulp.
Strategia consigliata: override CSS leggero
Per cambi minimali (logo, colore primario) basta creare skins/azienda/ con meta.json che eredita da elastic e un styles.less con poche regole. G Tech Group consegna questo schema in 1-2 giornate.
Procedura passo-passo
- Copia skins/elastic in skins/azienda
- Modifica meta.json impostando name e parent: elastic
- Apri skins/azienda/styles/_variables.less e cambia @color-main
- Aggiungi il tuo logo in skins/azienda/images/logo.png
- Esegui npm run build dentro skins/azienda (o lessc)
- Imposta in config.inc.php $config skin = azienda
- Pulisci la cache browser e ricarica
- Verifica che logo e colori siano applicati
Errori comuni e come risolverli
- Skin non caricato: verifica permessi cartella (755) e che il manifest sia valido JSON.
- Logo non visibile: controlla path relativo e che l'immagine sia letta dal webserver.
- Modifiche CSS non viste: svuota cache RoundCube cancellando temp/.
- Errori SASS: verifica versione sassc compatibile con elastic.
Approfondimenti tecnici e scenari d'uso
L'argomento Creare un tema custom (skin) per RoundCube richiede una buona comprensione dell'infrastruttura di posta sottostante. RoundCube e' uno strato applicativo che si poggia su un server IMAP (di norma Dovecot su Plesk) per la lettura dei messaggi, su un server SMTP (Postfix) per l'invio, e su un database MySQL o MariaDB per i metadati. Ogni operazione che vediamo dall'interfaccia attiva una o più' chiamate verso questi servizi. Comprendere il flusso aiuta a diagnosticare velocemente i malfunzionamenti e a prendere decisioni informate quando bisogna pianificare interventi su ambienti di produzione con utenti business.
G Tech Group, in qualità' di agenzia digitale italiana con più' di un decennio di esperienza su Plesk e oltre cinquecento clienti attivi, ha consolidato una serie di accorgimenti operativi: pulizia periodica delle cache, monitoraggio dei log applicativi, verifica dei certificati SSL, audit dei plugin installati, e schedulazione di backup giornalieri con retention multipla. Tutte queste pratiche sono integrate nei piani di assistenza tecnica h24 erogati dalla sede di Giustino, in Trentino. L'assistenza in italiano e i tempi di risposta sotto le due ore sui ticket critici sono parte del valore offerto ai clienti professionali.
Per chi gestisce diversi domini sullo stesso server e' utile ricordare che molte impostazioni RoundCube hanno scope globale: una modifica al file config.inc.php si applica a tutti gli utenti. Per personalizzazioni per dominio o per gruppo serve un plugin dedicato o l'estensione del config tramite hook. In ambienti multi-tenant come quelli di un'agenzia digitale e' bene mantenere un repository git con le modifiche di configurazione, separato dal codice upstream di RoundCube, per poter eseguire upgrade in sicurezza senza perdere customizzazioni. G Tech Group segue questa policy per tutti i server gestiti, garantendo così' aggiornamenti regolari della webmail senza regressioni sulle personalizzazioni (skin, plugin custom, integrazioni CRM e altri moduli aziendali).
Sul fronte sicurezza, l'argomento merita sempre attenzione specifica. Le credenziali email transitano su HTTPS, ma una sola compromissione può aprire la porta a campagne di phishing dal dominio aziendale, con danni di reputazione e di deliverability difficili da recuperare in tempi brevi. Per questo G Tech Group consiglia abilitazione di SPF, DKIM e DMARC obbligatori, policy di password forte, fail2ban configurato sui tentativi falliti, monitor di accessi anomali e training periodico per gli utenti finali. Per i clienti enterprise sono inoltre disponibili moduli di autenticazione multi-fattore tramite reverse proxy Authelia o Keycloak posti davanti a RoundCube.
Dal punto di vista delle prestazioni, la maggior parte dei rallentamenti percepiti dagli utenti deriva da tre cause: cache messaggi cresciuta a dismisura (la tabella cache_messages può superare svariati gigabyte in pochi mesi), connessioni IMAP non chiuse correttamente che esauriscono le risorse Dovecot, e tempi di risposta del DNS lenti per le ricerche DNSBL durante la consegna SMTP. La cron di bin/cleandb.sh che G Tech Group abilita in fase di onboarding riduce notevolmente il primo problema, mentre tuning di Dovecot e cache DNS locale risolvono gli altri due, garantendo una webmail sempre fluida anche su domini con centinaia di caselle attive in contemporanea.
Domande frequenti
D: Posso aggiornare RoundCube senza perdere lo skin?
R: Sì, la cartella skins/azienda resta intatta.
D: Posso pubblicare lo skin su GitHub?
R: Sì, e' open source come RoundCube.
D: Quanto costa uno skin custom?
R: Da 300 a 1500 euro in base alla complessità; G Tech Group fornisce preventivo.
Hai bisogno di aiuto?
Se hai bisogno di configurare RoundCube per la tua azienda, il team di G Tech Group può aiutarti. Contattaci tramite il modulo di contatto.