Module DoliGenweb IT
Sommario
Informazioni
| Module name | DoliGenweb |
| Editor / Editeur | 
|
| Download or buy page / Page achat ou téléchargement | External module - www.dolistore.com |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | PHP 7.2 minimo - estensione PHP calendar consigliata
Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2026-10-21 |
| Note / Nota | ⬆ Torna al sommario |
Funzionalità
DoliGenweb aggiunge la genealogia a Dolibarr: persone, famiglie, filiazioni, luoghi, fonti ed eventi della vita, con alberi, numerazione Sosa, calcolo della parentela, statistiche, mappe delle migrazioni, cronologia, contesto storico e importazione/esportazione GEDCOM. Tutti i dati restano nel vostro Dolibarr e ne seguono l'ergonomia abituale (elenchi filtrabili, schede con sottoschede, note, documenti, attributi complementari, permessi per utente).
Le schermate seguenti sono state realizzate con una genealogia dimostrativa della casa di Borbone (Luigi XVI, Maria Antonietta e i loro antenati).
Sei oggetti genealogici
- Persone: nomi, particella, cognome, suffisso, titolo, soprannome, cognome da sposata, sesso, professione (dizionario), foto, collegamento a un contatto Dolibarr.
- Famiglie: unione tra due persone, di tipo Matrimonio, Unione, Unione civile o Unione libera, con data, luogo, data di scioglimento e testimoni.
- Relazioni: legame genitore / figlio (padre o madre) e posizione del figlio tra i fratelli.
- Luoghi: comune, codice postale, dipartimento, paese, tipo e coordinate GPS, con una scheda Mappa.
- Fonti: atti e documenti (tipo, autore, archivio, segnatura, URL, testo, file allegati), citati sulle persone, sugli eventi e sulle famiglie con pagina, qualità e trascrizione.
- Alberi Sosa: genealogia di lavoro radicata su una persona (il de cujus), che attiva la numerazione Sosa-Stradonitz.
Scheda persona
La scheda di una persona riunisce la sua identità (con gli elementi del nome: particella, suffisso, titolo, soprannome), i genitori, i coniugi, i figli, le partecipazioni come testimone o padrino e i suoi eventi della vita: nascita, battesimo, morte, sepoltura, matrimonio, professione, residenza, censimento, servizio militare, testamento, emigrazione, naturalizzazione… Ogni evento ha una data, un luogo, citazioni di fonti e una precisione della data (Esatta, Circa, Prima, Dopo, Tra, Sconosciuta). Ogni campo dispone di un aiuto.
Alcuni pulsanti creano direttamente il padre, la madre, un figlio o un coniuge dalla scheda, registrando il legame in un solo passaggio.
Schede della persona: Persona, Alberi, Parentela, Statistiche, Ricerche, Migrazioni, Cronologia, Coerenza, Duplicati, Galleria, Fonti, Eventi storici, oltre a Contatti, Note, Documenti e Agenda secondo la configurazione.
Alberi genealogici
- Modalità ascendenza, discendenza e clessidra (antenati sopra, discendenti sotto).
- Vista a caselle, ruota degli antenati o ventaglio della discendenza.
- Colore e visualizzazione del luogo di nascita, di matrimonio o di morte, filtro su un luogo o luoghi nascosti.
- Generazione dell'albero in PDF, dal formato A4 all'A0 per le grandi stampe.
- Report PDF della persona: ascendenza Sosa, discendenza d'Aboville, scheda familiare e libro di famiglia.
Parentela
La scheda Parentela indica il legame tra due persone nelle 5 lingue (fratellastri, cugini di secondo grado, sfasamenti di generazione, affini), fornisce il grado secondo il diritto civile, gli antenati comuni più vicini e i percorsi di parentela.
Statistiche e indici
- Statistiche dell'intera genealogia: numeri e tassi di compilazione, età alla morte, alla prima unione e dei genitori alla nascita, nascite per secolo, figli per coppia, cognomi, nomi, luoghi e professioni più frequenti.
- Scheda Statistiche della persona: completezza dell'ascendenza e implesso per generazione.
- Indice dei cognomi e indice dei luoghi con barra delle lettere e filtro rapido; ogni voce apre la ricerca genealogica.
- Ricerca genealogica per cognome, nomi, coniuge, genitori, luogo ed eventi, con caratteri jolly e varianti fonetiche, anche dalla ricerca globale di Dolibarr.
Ricerche da svolgere e coerenza
- Scheda Ricerche: antenati Sosa mancanti e atti mancanti (nascita, matrimonio, morte) per generazione, con la pista da seguire; ogni ricerca può diventare un'attività dell'agenda collegata alla persona.
- Controlli di coerenza: date impossibili o improbabili, età dei genitori e dei coniugi, filiazioni doppie o circolari, con soglie regolabili.
- Duplicati: rilevamento dei probabili duplicati (cognome fonetico, nome simile, date compatibili, genitori o coniuge in comune), confronto affiancato e fusione.
Migrazioni e luoghi geolocalizzati
- Scheda Migrazioni: luoghi di nascita degli antenati Sosa su una mappa, animata generazione per generazione, con filtro del ramo paterno o materno, spostamenti tra generazioni e distanze per generazione.
- Scheda Mappa del luogo e scelta della mappa di base: OpenStreetMap, mappa IGN, carta di Cassini o carta dello stato maggiore.
- Geocodifica di un luogo, o di tutti i luoghi in una volta dalla configurazione, con OpenStreetMap Nominatim.
Cronologia e contesto storico
- La scheda Eventi storici importa da Wikidata e Wikipedia gli eventi avvenuti durante la vita della persona e i capi di Stato del periodo, per Francia, Svizzera, Germania, Regno Unito, Belgio, Italia e Spagna.
- La scheda Cronologia unisce su una barra della vita e in una tabella cronologica gli eventi della persona, quelli della sua famiglia stretta e questo contesto storico, con l'età a ogni evento.
Fonti e citazioni
La scheda Fonti della persona elenca le citazioni dei suoi eventi e delle sue unioni. La scheda di una fonte mostra il blocco Citata da e una scheda Trascrizione in cui l'immagine dell'atto è affiancata al testo, con una proposta di trascrizione facoltativa da parte di un modello di visione Ollama locale.
Condivisione con la famiglia, anniversari e contatti
- Protezione delle persone viventi (GDPR): le persone viventi, o nate da meno di N anni, sono nascoste agli utenti senza il permesso Leggere le persone viventi; un pulsante crea il gruppo «Genealogia - Famiglia (sola lettura)».
- Anniversari e commemorazioni del giorno e dei 7 giorni successivi nella home page e nell'agenda.
- Collegamento con i contatti Dolibarr e selettore di e-mailing dei membri della famiglia.
- Galleria della persona con annotazione delle foto e identificazione delle persone.
Importazione ed esportazione GEDCOM
- Importazione: trascinamento del file
.ged, invio in blocchi da 512 KB, barra di avanzamento, ripresa di un'importazione interrotta e cronologia delle importazioni. Vengono letti gli elementi del nome (GIVN,SPFX,SURN,NSFX,NPFX,NICK) e il titolo (TITL); un'opzione separa la particella scritta nel cognome quando il file non ha il tagSPFX(caso di Heredis). - Esportazione: file GEDCOM 5.5.1 in UTF-8, filtrabile per inizio del cognome e per sesso, con occultamento facoltativo delle persone viventi.
- Vengono scambiati anche fonti, archivi e citazioni (
SOUR,REPO,PAGE,QUAY), testimoni (ASSO,_WITN) e precisione delle date (ABT,BEF,AFT,BET,FROM/TO).
Convertitore di calendari
La configurazione offre un convertitore di date tra i calendari gregoriano, giuliano, repubblicano francese, ebraico e islamico, con giorno giuliano ed età della Luna, per trascrivere gli atti antichi.
Guida d'uso integrata
Una guida completa in francese, inglese, tedesco, spagnolo e italiano è consultabile direttamente dalla configurazione del modulo, scheda Guida utente, nella lingua dell'interfaccia.
Prerequisiti
Dolibarr: versioni supportate:
- 24.x
PHP: versione 7.2 minimo, testato fino a PHP 8.5.
Estensione PHP: calendar consigliata (calendari repubblicano, ebraico e islamico del convertitore).
Accesso a Internet del server: necessario per il contesto storico (Wikidata, Wikipedia) e la geocodifica dei luoghi (OpenStreetMap Nominatim). Il resto del modulo funziona offline.
⚙️ Procedura di installazione
⚙️ Metodo 1: installazione dall'interfaccia di Dolibarr
- Andate su Home > Impostazioni > Moduli/Applicazioni.
- Aprite la scheda Distribuisci/installa un modulo esterno.
- Fate clic su Scegli file e selezionate il file .zip del modulo.
- Fate clic su Invia file per avviare l'installazione.
- Attivate il modulo al termine dell'installazione.
Se Dolibarr rifiuta il file («Il file è troppo grande»), aumentate il limite MAIN_UPLOAD_DOC in Home > Impostazioni > Sicurezza, scheda File, oppure i parametri PHP upload_max_filesize e post_max_size, oppure usate il metodo 2.
⚙️ Metodo 2: installazione manuale sul server
Lo zip contiene una cartella htdocs/doligenweb/; la cartella doligenweb deve trovarsi nella directory custom di Dolibarr.
- Decomprimere:
unzip module_doligenweb-X.Y.Z.zip -d /tmp/doligenweb_zip - Copiare:
cp -r /tmp/doligenweb_zip/htdocs/doligenweb /percorso/di/dolibarr/htdocs/custom/ - Assegnare i permessi al server web se necessario:
chown -R www-data:www-data /percorso/di/dolibarr/htdocs/custom/doligenweb - Verificare che la posizione sia
htdocs/custom/doligenweb(e nonhtdocs/custom/htdocs/doligenweb). - Attivare il modulo da Dolibarr.
Configurazione
Accesso: Home > Impostazioni > Moduli/Applicazioni, icona delle impostazioni di DoliGenweb.
| Scheda | Contenuto |
|---|---|
| Parametri | Schede Contatti, Note, Documenti e Agenda, anniversari, mappa di base predefinita, separazione della particella, soglie di coerenza, generazioni dei report PDF, protezione delle persone viventi, modello Ollama; convertitore di calendari |
| Attributi complementari | Campi personalizzati di famiglie, persone e luoghi |
| Geocodifica dei luoghi | Ricerca in blocco delle coordinate GPS dei luoghi che ne sono privi |
| Importazione GEDCOM | Invio di un file .ged e cronologia delle importazioni
|
| Esportazione GEDCOM | Generazione di un file .ged filtrato
|
| Guida utente | Guida completa nella lingua dell'interfaccia |
| Informazioni | Informazioni sul modulo |
| Parametro | Effetto |
|---|---|
| Mappa di base predefinita | OpenStreetMap, mappa IGN, carta di Cassini o carta dello stato maggiore, per le mappe dei luoghi e delle migrazioni |
| Importazione GEDCOM: separare la particella dal cognome | Senza tag SPFX nel file, «LE CORVEC» o «CORVEC (LE)» danno il cognome CORVEC e la particella LE; l'elenco delle particelle riconosciute è modificabile
|
| Soglie di coerenza | Età minima e massima dei genitori, età minima al matrimonio, durata massima della vita |
| Report PDF: numero di generazioni | Profondità dei report Sosa, d'Aboville e libro di famiglia (da 1 a 30, 10 per impostazione predefinita) |
| Protezione delle persone viventi | Nasconde i viventi, e le persone nate da meno del numero di anni scelto, agli utenti senza il permesso Leggere le persone viventi |
| Trascrizione tramite IA | Indirizzo del server Ollama, modello di visione e tempo di attesa; lasciare vuoto per non usarla |
Permessi: Persona, Famiglia, Relazione, Albero Sosa, Luogo e Fonte hanno ciascuno un permesso Leggere, Creare/Modificare ed Eliminare, più Leggere le persone viventi e Leggere / Modificare i dizionari (menu Utenti e gruppi, scheda Permessi).
Dizionari: menu DoliGenweb > Dizionari: Tipi di eventi individuali, Professioni e Archivi dipartimentali (indirizzi e siti dei servizi archivistici francesi, proposti come depositi delle fonti).
Utilizzo
- Importate un file GEDCOM esistente (scheda Importazione GEDCOM della configurazione) oppure create le persone una per una da DoliGenweb > Persone > Nuova persona.
- Completate le schede: genitori, coniugi e figli con i pulsanti della scheda, eventi della vita con date, luoghi e citazioni di fonti.
- Geocodificate i luoghi (scheda Geocodifica dei luoghi della configurazione) per alimentare le mappe e le migrazioni.
- Create un albero Sosa in DoliGenweb > Alberi Sosa con la vostra persona radice per visualizzare i numeri Sosa.
- Visualizzate l'albero dalla scheda Alberi di una persona, poi stampatelo in PDF o generate un report.
- Verificate la genealogia con le schede Coerenza, Duplicati e Ricerche.
- Collocate la vita di un antenato nella Storia con le schede Eventi storici e Cronologia.
- Esportate la genealogia in GEDCOM per scambiarla con un altro software.
Le schermate di importazione ed esportazione GEDCOM sono per ora visualizzate solo in francese.
Risoluzione dei problemi
| Sintomo | Causa probabile / soluzione |
|---|---|
| Il menu DoliGenweb non compare | Permesso di lettura non assegnato all'utente |
| Mancano le schede Contatti, Note o Documenti | Opzione disattivata nella scheda Parametri |
| Mancano i calendari repubblicano, ebraico o islamico | Estensione PHP calendar assente sul server
|
| Messaggio «Nessuna data di nascita» | Aggiungere alla persona un evento di nascita datato |
| Nessun evento storico trovato | Server senza accesso a Internet o nessun paese selezionato |
| Mappa vuota o luogo assente dalle migrazioni | Luogo senza coordinate GPS: geocodificarlo dalla sua scheda o in blocco |
| Mappa di base IGN, Cassini o stato maggiore bianca | Server cartografico dell'IGN irraggiungibile, o politica di sicurezza (CSP) del server che blocca le tessere esterne |
| Importazione GEDCOM bloccata | Pulsante Sblocca l'importazione, poi ricominciare |
| Accenti errati dopo l'importazione | File GEDCOM non codificato in UTF-8: riesportarlo in UTF-8 |
| Particella rimasta nel cognome dopo l'importazione | Opzione Importazione GEDCOM: separare la particella dal cognome disattivata, o particella assente dall'elenco |
| I numeri Sosa non compaiono | Nessun albero Sosa attivo: selezionarne uno in DoliGenweb > Alberi Sosa |
| Mancano persone negli elenchi | Persone viventi nascoste: assegnare il permesso Leggere le persone viventi |
Il registro di Dolibarr (Home - Impostazioni - Altro - Registri) traccia le importazioni e le chiamate ai servizi esterni.