Dolibarr ERP CRM Wiki - User contributions [en]

Module DoliGenweb IT

2026-10-21T08:51:28Z

Grandoc:

=Sommario=
[[Category:Moduli aggiuntivi]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Informazioni=
{{TemplateModuleInfo
|modulename=DoliGenweb
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=doligenweb}}
|status=stable
|prerequisites=PHP 7.2 minimo - estensione PHP calendar consigliata
|minversion=24.0.x
|note=
''[[#Sommario|⬆ 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).

[[File:Doligenweb-v24-home-it.png|center|thumb|800px|Cruscotto del modulo: contatori e ultime schede modificate]]

===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'''.

[[File:Doligenweb-v24-sosa-tree-it.png|center|thumb|800px|Albero Sosa radicato su Luigi Carlo, figlio di Luigi XVI]]

===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.

[[File:Doligenweb-v24-individual-card-it.png|center|thumb|800px|Scheda di Luigi XVI: identità, elementi del nome, genitori, unioni e figli]]

===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.

[[File:Doligenweb-v24-tree-it.png|center|thumb|800px|Ascendenza di Luigi Carlo su 4 generazioni, colorata per luogo di nascita]]

[[File:Doligenweb-v24-tree-wheel-it.png|center|thumb|800px|Ruota degli antenati su 5 generazioni]]

[[File:Doligenweb-v24-tree-hourglass-it.png|center|thumb|800px|Albero a clessidra di Luigi XVI]]

===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.

[[File:Doligenweb-v24-kinship-it.png|center|thumb|800px|Maria Antonietta è cugina di secondo grado di Luigi XVI, sfasata di una generazione]]

===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.

[[File:Doligenweb-v24-statistics-it.png|center|thumb|800px|Statistiche della genealogia]]

[[File:Doligenweb-v24-surname-index-it.png|center|thumb|800px|Indice dei cognomi]]

[[File:Doligenweb-v24-place-index-it.png|center|thumb|800px|Indice dei luoghi]]

===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.

[[File:Doligenweb-v24-research-it.png|center|thumb|800px|Ricerche da svolgere nell'ascendenza di Luigi XVI]]

[[File:Doligenweb-v24-consistency-it.png|center|thumb|800px|Controlli di coerenza]]

===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'''.

[[File:Doligenweb-v24-migration-it.png|center|thumb|800px|Migrazioni degli antenati di Luigi Carlo su 6 generazioni]]

[[File:Doligenweb-v24-place-map-it.png|center|thumb|800px|Scheda Mappa del luogo Versailles]]

===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.

[[File:Doligenweb-v24-timeline-it.png|center|thumb|800px|Cronologia di Luigi XVI con il contesto storico]]

[[File:Doligenweb-v24-historical-events-it.png|center|thumb|800px|Eventi storici importati da Wikidata]]

===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.

[[File:Doligenweb-v24-sources-it.png|center|thumb|800px|Fonti citate sulla scheda di Luigi XVI]]

===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 <code>.ged</code>, invio in blocchi da 512 KB, barra di avanzamento, ripresa di un'importazione interrotta e cronologia delle importazioni. Vengono letti gli elementi del nome (<code>GIVN</code>, <code>SPFX</code>, <code>SURN</code>, <code>NSFX</code>, <code>NPFX</code>, <code>NICK</code>) e il titolo (<code>TITL</code>); un'opzione separa la particella scritta nel cognome quando il file non ha il tag <code>SPFX</code> (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 (<code>SOUR</code>, <code>REPO</code>, <code>PAGE</code>, <code>QUAY</code>), testimoni (<code>ASSO</code>, <code>_WITN</code>) e precisione delle date (<code>ABT</code>, <code>BEF</code>, <code>AFT</code>, <code>BET</code>, <code>FROM</code>/<code>TO</code>).

[[File:Doligenweb-v24-gedcom-import-it.png|center|thumb|800px|Importazione di un file GEDCOM per trascinamento]]

===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.

[[File:Doligenweb-v24-guide-it.png|center|thumb|800px|Guida utente integrata]]

''[[#Sommario|⬆ Torna al sommario]]''

==Prerequisiti==
'''Dolibarr:''' versioni supportate:

*'''24.x'''

'''PHP:''' versione 7.2 minimo, testato fino a PHP 8.5.

'''Estensione PHP:''' <code>calendar</code> 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 <code>upload_max_filesize</code> e <code>post_max_size</code>, oppure usate il metodo 2.

===⚙️ Metodo 2: installazione manuale sul server===

Lo zip contiene una cartella <code>htdocs/doligenweb/</code>; la cartella <code>doligenweb</code> deve trovarsi nella directory <code>custom</code> di Dolibarr.

# '''Decomprimere''': <code>unzip module_doligenweb-X.Y.Z.zip -d /tmp/doligenweb_zip</code>
# '''Copiare''': <code>cp -r /tmp/doligenweb_zip/htdocs/doligenweb /percorso/di/dolibarr/htdocs/custom/</code>
# '''Assegnare i permessi''' al server web se necessario: <code>chown -R www-data:www-data /percorso/di/dolibarr/htdocs/custom/doligenweb</code>
# '''Verificare''' che la posizione sia <code>htdocs/custom/doligenweb</code> (e non <code>htdocs/custom/htdocs/doligenweb</code>).
# '''Attivare''' il modulo da Dolibarr.

''[[#Sommario|⬆ Torna al sommario]]''

=Configurazione=

Accesso: '''Home > Impostazioni > Moduli/Applicazioni''', icona delle impostazioni di DoliGenweb.

{| class="wikitable"
! 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 <code>.ged</code> e cronologia delle importazioni
|-
| Esportazione GEDCOM || Generazione di un file <code>.ged</code> filtrato
|-
| Guida utente || Guida completa nella lingua dell'interfaccia
|-
| Informazioni || Informazioni sul modulo
|}

[[File:Doligenweb-v24-setup-it.png|center|thumb|800px|Scheda Parametri della configurazione]]

[[File:Doligenweb-v24-geocode-it.png|center|thumb|800px|Geocodifica in blocco dei luoghi]]

{| class="wikitable"
! 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 <code>SPFX</code> 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).

[[File:Doligenweb-v24-dictionaries-it.png|center|thumb|800px|Dizionari del modulo]]

''[[#Sommario|⬆ Torna al sommario]]''

=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==

{| class="wikitable"
! 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 <code>calendar</code> 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.

''[[#Sommario|⬆ Torna al sommario]]''

=Altre lingue=

* [[Module_DoliGenweb_FR|Documentation française du module DoliGenweb]]
* [[Module_DoliGenweb_EN|English documentation for the DoliGenweb module]]
* [[Module_DoliGenweb_DE|Deutsche Dokumentation für das Modul DoliGenweb]]
* [[Module_DoliGenweb_ES|Documentación en español del módulo DoliGenweb]]

''[[#Sommario|⬆ Torna al sommario]]''

[[fr:Module_DoliGenweb_FR]]
[[en:Module_DoliGenweb_EN]]
[[de:Module_DoliGenweb_DE]]
[[es:Module_DoliGenweb_ES]]

Module DoliGenweb ES

2026-10-21T08:50:05Z

Grandoc:

=Índice=
[[Category:Módulos complementarios]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Información=
{{TemplateModuleInfo
|modulename=DoliGenweb
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=doligenweb}}
|status=stable
|prerequisites=PHP 7.2 mínimo - extensión PHP calendar recomendada
|minversion=24.0.x
|note=
''[[#Índice|⬆ Volver al índice]]''
}}

=Funcionalidades=
DoliGenweb añade la '''genealogía''' a Dolibarr: personas, familias, filiaciones, lugares, fuentes y eventos de vida, con árboles, numeración Sosa, cálculo de parentesco, estadísticas, mapas de migraciones, cronología, contexto histórico e importación/exportación '''GEDCOM'''. Todos los datos permanecen en su Dolibarr y siguen su ergonomía habitual (listas filtrables, fichas con pestañas, notas, documentos, atributos adicionales, permisos por usuario).

Las capturas de pantalla siguientes se realizaron con una genealogía de demostración de la casa de Borbón (Luis XVI, María Antonieta y sus antepasados).

[[File:Doligenweb-v24-home-es.png|center|thumb|800px|Panel del módulo: contadores y últimas fichas modificadas]]

===Seis objetos genealógicos===

*'''Personas''': nombres, partícula, apellido, sufijo, título, apodo, apellido de casada, sexo, profesión (diccionario), foto, enlace a un contacto de Dolibarr.
*'''Familias''': unión entre dos personas, de tipo Matrimonio, Unión, Pareja de hecho o Unión libre, con fecha, lugar, fecha de disolución y testigos.
*'''Relaciones''': vínculo padre o madre / hijo y rango del hijo entre sus hermanos.
*'''Lugares''': municipio, código postal, departamento, país, tipo y coordenadas GPS, con una pestaña '''Mapa'''.
*'''Fuentes''': actas y documentos (tipo, autor, archivo, signatura, URL, texto, archivos adjuntos), citados en las personas, los eventos y las familias con página, calidad y transcripción.
*'''Árboles Sosa''': genealogía de trabajo enraizada en una persona (el ''de cujus''), que activa la numeración '''Sosa-Stradonitz'''.

[[File:Doligenweb-v24-sosa-tree-es.png|center|thumb|800px|Árbol Sosa enraizado en Luis Carlos, hijo de Luis XVI]]

===Ficha de la persona===

La ficha de una persona reúne su identidad (con los elementos del nombre: partícula, sufijo, título, apodo), sus padres, cónyuges, hijos, sus participaciones como testigo o padrino y sus '''eventos de vida''': nacimiento, bautismo, defunción, sepultura, matrimonio, profesión, residencia, censo, servicio militar, testamento, emigración, naturalización… Cada evento lleva una fecha, un lugar, citas de fuentes y una '''precisión de fecha''' (Exacta, Hacia, Antes, Después, Entre, Desconocida). Cada campo dispone de una ayuda.

Unos botones crean directamente el '''padre''', la '''madre''', un '''hijo''' o un '''cónyuge''' desde la ficha, guardando el vínculo en un solo paso.

Pestañas de la persona: Persona, Árboles, Parentesco, Estadísticas, Investigaciones, Migraciones, Cronología, Coherencia, Duplicados, Galería, Fuentes, Eventos históricos, así como Contactos, Notas, Documentos y Agenda según la configuración.

[[File:Doligenweb-v24-individual-card-es.png|center|thumb|800px|Ficha de Luis XVI: identidad, elementos del nombre, padres, uniones e hijos]]

===Árboles genealógicos===

*Modos '''ascendencia''', '''descendencia''' y '''reloj de arena''' (antepasados arriba, descendientes abajo).
*Vista en '''casillas''', '''rueda de ascendencia''' o '''abanico de descendencia'''.
*Color y visualización del lugar de nacimiento, de matrimonio o de defunción, filtro sobre un lugar u ocultación de los lugares.
*Generación del árbol en '''PDF''', del formato A4 al A0 para las grandes impresiones.
*Informes PDF de la persona: ascendencia Sosa, descendencia d'Aboville, ficha familiar y libro de familia.

[[File:Doligenweb-v24-tree-es.png|center|thumb|800px|Ascendencia de Luis Carlos en 4 generaciones, coloreada por lugar de nacimiento]]

[[File:Doligenweb-v24-tree-wheel-es.png|center|thumb|800px|Rueda de ascendencia en 5 generaciones]]

[[File:Doligenweb-v24-tree-hourglass-es.png|center|thumb|800px|Árbol en reloj de arena de Luis XVI]]

===Parentesco===

La pestaña '''Parentesco''' nombra el vínculo entre dos personas en los 5 idiomas (medios hermanos, primos segundos, desfases de generación, parientes políticos), da el grado en derecho civil, los antepasados comunes más cercanos y los caminos de parentesco.

[[File:Doligenweb-v24-kinship-es.png|center|thumb|800px|María Antonieta es prima segunda de Luis XVI, con una generación de desfase]]

===Estadísticas e índices===

*'''Estadísticas''' de toda la genealogía: efectivos y tasas de cumplimentación, edades al fallecer, en la primera unión y de los padres al nacimiento, nacimientos por siglo, hijos por pareja, apellidos, nombres, lugares y profesiones más frecuentes.
*Pestaña '''Estadísticas''' de la persona: completitud de la ascendencia e implejo por generación.
*'''Índice de apellidos''' e '''índice de lugares''' con barra de letras y filtro rápido; cada entrada abre la búsqueda genealógica.
*'''Búsqueda genealógica''' por apellido, nombres, cónyuge, padres, lugar y eventos, con comodines y variantes fonéticas, también desde la búsqueda global de Dolibarr.

[[File:Doligenweb-v24-statistics-es.png|center|thumb|800px|Estadísticas de la genealogía]]

[[File:Doligenweb-v24-surname-index-es.png|center|thumb|800px|Índice de apellidos]]

[[File:Doligenweb-v24-place-index-es.png|center|thumb|800px|Índice de lugares]]

===Investigaciones pendientes y coherencia===

*Pestaña '''Investigaciones''': antepasados Sosa que faltan y actas que faltan (nacimiento, matrimonio, defunción) por generación, con la pista a seguir; cada investigación puede convertirse en una tarea de la agenda vinculada a la persona.
*'''Controles de coherencia''': fechas imposibles o improbables, edades de los padres y de los cónyuges, filiaciones duplicadas o en bucle, con umbrales ajustables.
*'''Duplicados''': detección de duplicados probables (apellido fonético, nombre cercano, fechas compatibles, padres o cónyuge comunes), comparación lado a lado y fusión.

[[File:Doligenweb-v24-research-es.png|center|thumb|800px|Investigaciones pendientes en la ascendencia de Luis XVI]]

[[File:Doligenweb-v24-consistency-es.png|center|thumb|800px|Controles de coherencia]]

===Migraciones y lugares geolocalizados===

*Pestaña '''Migraciones''': lugares de nacimiento de los antepasados Sosa en un mapa, animado generación por generación, con filtro de rama paterna o materna, desplazamientos entre generaciones y distancias por generación.
*Pestaña '''Mapa''' del lugar y elección del mapa base: '''OpenStreetMap''', '''mapa IGN''', '''mapa de Cassini''' o '''mapa de estado mayor'''.
*'''Geocodificación''' de un lugar, o de todos los lugares de una vez desde la configuración, con '''OpenStreetMap Nominatim'''.

[[File:Doligenweb-v24-migration-es.png|center|thumb|800px|Migraciones de los antepasados de Luis Carlos en 6 generaciones]]

[[File:Doligenweb-v24-place-map-es.png|center|thumb|800px|Pestaña Mapa del lugar Versalles]]

===Cronología y contexto histórico===

*La pestaña '''Eventos históricos''' importa de '''Wikidata''' y '''Wikipedia''' los eventos ocurridos durante la vida de la persona y los '''jefes de Estado''' del periodo, para Francia, Suiza, Alemania, el Reino Unido, Bélgica, Italia y España.
*La pestaña '''Cronología''' mezcla en una barra de vida y en una tabla cronológica los eventos de la persona, los de su familia cercana y este contexto histórico, con la edad en cada evento.

[[File:Doligenweb-v24-timeline-es.png|center|thumb|800px|Cronología de Luis XVI con el contexto histórico]]

[[File:Doligenweb-v24-historical-events-es.png|center|thumb|800px|Eventos históricos importados de Wikidata]]

===Fuentes y citas===

La pestaña '''Fuentes''' de la persona lista las citas de sus eventos y de sus uniones. La ficha de una fuente muestra el bloque '''Citada por''' y una pestaña '''Transcripción''' donde la imagen del acta se coloca junto al texto, con una propuesta de transcripción opcional por un modelo de visión '''Ollama''' local.

[[File:Doligenweb-v24-sources-es.png|center|thumb|800px|Fuentes citadas en la ficha de Luis XVI]]

===Compartir con la familia, aniversarios y contactos===

*'''Protección de las personas vivas''' (RGPD): las personas vivas, o nacidas hace menos de N años, se ocultan a los usuarios sin el permiso '''Leer las personas vivas'''; un botón crea el grupo «Genealogía - Familia (solo lectura)».
*'''Aniversarios''' y conmemoraciones del día y de los 7 días siguientes en la página de inicio y en la agenda.
*Vínculo con los '''contactos de Dolibarr''' y selector de e-mailing de los miembros de la familia.
*'''Galería''' de la persona con anotación de las fotos e identificación de las personas.

===Importación y exportación GEDCOM===

*'''Importación''': arrastrar y soltar el archivo <code>.ged</code>, envío en fragmentos de 512 KB, barra de progreso, reanudación de una importación interrumpida e historial de importaciones. Se leen los elementos del nombre (<code>GIVN</code>, <code>SPFX</code>, <code>SURN</code>, <code>NSFX</code>, <code>NPFX</code>, <code>NICK</code>) y el título (<code>TITL</code>); una opción separa la partícula escrita en el apellido cuando el archivo no tiene etiqueta <code>SPFX</code> (caso de Heredis).
*'''Exportación''': archivo '''GEDCOM 5.5.1''' en '''UTF-8''', filtrable por inicio del apellido y por sexo, con ocultación opcional de las personas vivas.
*También se intercambian las fuentes, archivos y citas (<code>SOUR</code>, <code>REPO</code>, <code>PAGE</code>, <code>QUAY</code>), los testigos (<code>ASSO</code>, <code>_WITN</code>) y la precisión de las fechas (<code>ABT</code>, <code>BEF</code>, <code>AFT</code>, <code>BET</code>, <code>FROM</code>/<code>TO</code>).

[[File:Doligenweb-v24-gedcom-import-es.png|center|thumb|800px|Importación de un archivo GEDCOM por arrastrar y soltar]]

===Conversor de calendarios===

La configuración propone un conversor de fechas entre los calendarios '''gregoriano''', '''juliano''', '''republicano francés''', '''hebreo''' y '''musulmán''', con día juliano y edad de la Luna, para transcribir actas antiguas.

===Guía de uso integrada===

Una guía completa en '''francés, inglés, alemán, español e italiano''' se puede consultar directamente desde la configuración del módulo, pestaña '''Guía de usuario''', en el idioma de la interfaz.

[[File:Doligenweb-v24-guide-es.png|center|thumb|800px|Guía de usuario integrada]]

''[[#Índice|⬆ Volver al índice]]''

==Requisitos previos==
'''Dolibarr:''' versiones compatibles:

*'''24.x'''

'''PHP:''' versión 7.2 mínimo, probado hasta PHP 8.5.

'''Extensión PHP:''' <code>calendar</code> recomendada (calendarios republicano, hebreo e islámico del conversor).

'''Acceso a Internet del servidor:''' necesario para el contexto histórico (Wikidata, Wikipedia) y la geocodificación de lugares (OpenStreetMap Nominatim). El resto del módulo funciona sin conexión.

=⚙️ Procedimiento de instalación=

===⚙️ Método 1: instalación desde la interfaz de Dolibarr===

# Vaya a '''Inicio''' > '''Configuración''' > '''Módulos/Aplicaciones'''.
# Abra la pestaña '''Desplegar/instalar un módulo externo'''.
# Haga clic en '''Elegir archivo''' y seleccione el archivo .zip del módulo.
# Haga clic en '''Enviar archivo''' para iniciar la instalación.
# Active el módulo una vez terminada la instalación.

Si Dolibarr rechaza el archivo («El tamaño del archivo es demasiado grande»), aumente el límite '''MAIN_UPLOAD_DOC''' en '''Inicio > Configuración > Seguridad''', pestaña '''Archivos''', o los parámetros PHP <code>upload_max_filesize</code> y <code>post_max_size</code>, o utilice el método 2.

===⚙️ Método 2: instalación manual en el servidor===

El zip contiene una carpeta <code>htdocs/doligenweb/</code>; la carpeta <code>doligenweb</code> debe quedar en el directorio <code>custom</code> de Dolibarr.

# '''Descomprimir''': <code>unzip module_doligenweb-X.Y.Z.zip -d /tmp/doligenweb_zip</code>
# '''Copiar''': <code>cp -r /tmp/doligenweb_zip/htdocs/doligenweb /ruta/a/dolibarr/htdocs/custom/</code>
# '''Dar permisos''' al servidor web si es necesario: <code>chown -R www-data:www-data /ruta/a/dolibarr/htdocs/custom/doligenweb</code>
# '''Comprobar''' que la ubicación es <code>htdocs/custom/doligenweb</code> (y no <code>htdocs/custom/htdocs/doligenweb</code>).
# '''Activar''' el módulo desde Dolibarr.

''[[#Índice|⬆ Volver al índice]]''

=Configuración=

Acceso: '''Inicio > Configuración > Módulos/Aplicaciones''', icono de configuración de DoliGenweb.

{| class="wikitable"
! Pestaña !! Contenido

Module DoliGenweb DE

2026-10-21T08:49:04Z

Grandoc:

=Inhaltsverzeichnis=
[[Category:Zusatzmodule]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Informationen=
{{TemplateModuleInfo
|modulename=DoliGenweb
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=doligenweb}}
|status=stable
|prerequisites=PHP 7.2 mindestens - PHP-Erweiterung calendar empfohlen
|minversion=24.0.x
|note=
''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''
}}

=Funktionen=
DoliGenweb ergänzt Dolibarr um die '''Genealogie''': Personen, Familien, Abstammung, Orte, Quellen und Lebensereignisse, mit Stammbäumen, Sosa-Nummerierung, Verwandtschaftsberechnung, Statistiken, Wanderungskarten, Zeitleiste, historischem Kontext und '''GEDCOM'''-Import/Export. Alle Daten bleiben in Ihrem Dolibarr und folgen seiner gewohnten Bedienung (filterbare Listen, Karten mit Registerkarten, Notizen, Dokumente, ergänzende Attribute, Rechte pro Benutzer).

Die folgenden Bildschirmfotos wurden mit einer Demonstrations-Genealogie des Hauses Bourbon erstellt (Ludwig XVI., Marie-Antoinette und ihre Vorfahren).

[[File:Doligenweb-v24-home-de.png|center|thumb|800px|Übersicht des Moduls: Zähler und zuletzt geänderte Datensätze]]

===Sechs genealogische Objekte===

*'''Personen''': Vornamen, Namenspartikel, Nachname, Suffix, Titel, Spitzname, Ehename, Geschlecht, Beruf (Wörterbuch), Foto, Verknüpfung mit einem Dolibarr-Kontakt.
*'''Familien''': Verbindung zweier Personen vom Typ Ehe, Verbindung, eingetragene Partnerschaft oder freie Verbindung, mit Datum, Ort, Auflösungsdatum und Trauzeugen.
*'''Beziehungen''': Eltern-Kind-Verknüpfung (Vater oder Mutter) und Rang des Kindes unter den Geschwistern.
*'''Orte''': Gemeinde, Postleitzahl, Departement, Land, Typ und GPS-Koordinaten, mit einer Registerkarte '''Karte'''.
*'''Quellen''': Urkunden und Dokumente (Typ, Autor, Archiv, Signatur, URL, Text, angehängte Dateien), zitiert bei Personen, Ereignissen und Familien mit Seite, Qualität und Transkription.
*'''Sosa-Bäume''': Arbeitsgenealogie mit einer Ausgangsperson (dem ''de cujus''), die die '''Sosa-Stradonitz'''-Nummerierung aktiviert.

[[File:Doligenweb-v24-sosa-tree-de.png|center|thumb|800px|Sosa-Baum mit Louis-Charles, Sohn Ludwigs XVI., als Ausgangsperson]]

===Personenkarte===

Die Karte einer Person vereint ihre Identität (mit den Namensbestandteilen: Partikel, Suffix, Titel, Spitzname), Eltern, Ehepartner, Kinder, ihre Rollen als Zeuge oder Pate und ihre '''Lebensereignisse''': Geburt, Taufe, Tod, Bestattung, Heirat, Beruf, Wohnort, Volkszählung, Militärdienst, Testament, Auswanderung, Einbürgerung… Jedes Ereignis hat ein Datum, einen Ort, Quellenzitate und eine '''Datumsgenauigkeit''' (Genau, Etwa, Vor, Nach, Zwischen, Unbekannt). Jedes Feld hat eine Hilfe.

Schaltflächen legen '''Vater''', '''Mutter''', ein '''Kind''' oder einen '''Ehepartner''' direkt von der Karte aus an und speichern die Verknüpfung in einem Schritt.

Registerkarten der Person: Person, Stammbäume, Verwandtschaft, Statistiken, Recherchen, Wanderungen, Zeitleiste, Konsistenz, Dubletten, Galerie, Quellen, Historische Ereignisse sowie je nach Einstellung Kontakte, Notizen, Dokumente und Terminplanung.

[[File:Doligenweb-v24-individual-card-de.png|center|thumb|800px|Karte Ludwigs XVI.: Identität, Namensbestandteile, Eltern, Verbindungen und Kinder]]

===Stammbäume===

*Modi '''Vorfahren''', '''Nachkommen''' und '''Sanduhr''' (Vorfahren oben, Nachkommen unten).
*Ansicht als '''Kästchen''', '''Ahnenrad''' oder '''Nachkommenfächer'''.
*Farbe und Anzeige des Geburts-, Heirats- oder Sterbeorts, Filter auf einen Ort oder ausgeblendete Orte.
*Erzeugung des Stammbaums als '''PDF''', vom Format A4 bis A0 für große Ausdrucke.
*PDF-Berichte der Person: Sosa-Ahnenliste, Nachkommenliste nach d'Aboville, Familienblatt und Familienbuch.

[[File:Doligenweb-v24-tree-de.png|center|thumb|800px|Vorfahren von Louis-Charles über 4 Generationen, nach Geburtsort eingefärbt]]

[[File:Doligenweb-v24-tree-wheel-de.png|center|thumb|800px|Ahnenrad über 5 Generationen]]

[[File:Doligenweb-v24-tree-hourglass-de.png|center|thumb|800px|Sanduhr-Stammbaum Ludwigs XVI.]]

===Verwandtschaft===

Die Registerkarte '''Verwandtschaft''' benennt die Beziehung zwischen zwei Personen in den 5 Sprachen (Halbgeschwister, Cousins zweiten Grades, Generationsverschiebungen, Verschwägerte), gibt den Grad nach Zivilrecht, die nächsten gemeinsamen Vorfahren und die Verwandtschaftswege an.

[[File:Doligenweb-v24-kinship-de.png|center|thumb|800px|Marie-Antoinette ist die Cousine zweiten Grades Ludwigs XVI., um eine Generation verschoben]]

===Statistiken und Register===

*'''Statistiken''' der gesamten Genealogie: Anzahl und Erfassungsquoten, Sterbealter, Alter bei der ersten Verbindung und der Eltern bei der Geburt, Geburten pro Jahrhundert, Kinder pro Paar, häufigste Nachnamen, Vornamen, Orte und Berufe.
*Registerkarte '''Statistiken''' der Person: Vollständigkeit der Ahnenreihe und Ahnenschwund pro Generation.
*'''Namensregister''' und '''Ortsregister''' mit Buchstabenleiste und Schnellfilter; jeder Eintrag öffnet die genealogische Suche.
*'''Genealogische Suche''' nach Nachname, Vornamen, Ehepartner, Eltern, Ort und Ereignissen, mit Platzhaltern und phonetischen Varianten, auch über die globale Suche von Dolibarr.

[[File:Doligenweb-v24-statistics-de.png|center|thumb|800px|Statistiken der Genealogie]]

[[File:Doligenweb-v24-surname-index-de.png|center|thumb|800px|Namensregister]]

[[File:Doligenweb-v24-place-index-de.png|center|thumb|800px|Ortsregister]]

===Offene Recherchen und Konsistenz===

*Registerkarte '''Recherchen''': fehlende Sosa-Vorfahren und fehlende Urkunden (Geburt, Heirat, Tod) pro Generation, mit der zu verfolgenden Spur; jede Recherche kann zu einer Aufgabe der Terminplanung werden, die mit der Person verknüpft ist.
*'''Konsistenzprüfungen''': unmögliche oder unwahrscheinliche Daten, Alter der Eltern und Ehepartner, doppelte oder zirkuläre Abstammung, mit einstellbaren Schwellenwerten.
*'''Dubletten''': Erkennung wahrscheinlicher Dubletten (phonetischer Name, ähnlicher Vorname, vereinbare Daten, gemeinsame Eltern oder Ehepartner), Vergleich nebeneinander und Zusammenführung.

[[File:Doligenweb-v24-research-de.png|center|thumb|800px|Offene Recherchen in der Ahnenreihe Ludwigs XVI.]]

[[File:Doligenweb-v24-consistency-de.png|center|thumb|800px|Konsistenzprüfungen]]

===Wanderungen und geolokalisierte Orte===

*Registerkarte '''Wanderungen''': Geburtsorte der Sosa-Vorfahren auf einer Karte, Generation für Generation animiert, mit Filter auf die väterliche oder mütterliche Linie, Ortswechseln zwischen den Generationen und Entfernungen pro Generation.
*Registerkarte '''Karte''' des Ortes und Wahl der Hintergrundkarte: '''OpenStreetMap''', '''IGN-Karte''', '''Cassini-Karte''' oder '''État-major-Karte'''.
*'''Geokodierung''' eines Ortes oder aller Orte auf einmal über die Konfiguration, mit '''OpenStreetMap Nominatim'''.

[[File:Doligenweb-v24-migration-de.png|center|thumb|800px|Wanderungen der Vorfahren von Louis-Charles über 6 Generationen]]

[[File:Doligenweb-v24-place-map-de.png|center|thumb|800px|Registerkarte Karte des Ortes Versailles]]

===Zeitleiste und historischer Kontext===

*Die Registerkarte '''Historische Ereignisse''' importiert aus '''Wikidata''' und '''Wikipedia''' die Ereignisse während des Lebens der Person und die '''Staatsoberhäupter''' der Zeit, für Frankreich, die Schweiz, Deutschland, das Vereinigte Königreich, Belgien, Italien und Spanien.
*Die Registerkarte '''Zeitleiste''' zeigt auf einem Lebensbalken und in einer chronologischen Tabelle die Ereignisse der Person, ihrer nahen Familie und diesen historischen Kontext, mit dem Alter bei jedem Ereignis.

[[File:Doligenweb-v24-timeline-de.png|center|thumb|800px|Zeitleiste Ludwigs XVI. mit historischem Kontext]]

[[File:Doligenweb-v24-historical-events-de.png|center|thumb|800px|Aus Wikidata importierte historische Ereignisse]]

===Quellen und Zitate===

Die Registerkarte '''Quellen''' der Person listet die Zitate ihrer Ereignisse und Verbindungen auf. Die Karte einer Quelle zeigt den Block '''Zitiert von''' und eine Registerkarte '''Transkription''', in der das Bild der Urkunde neben dem Text steht, mit einem optionalen Transkriptionsvorschlag durch ein lokales '''Ollama'''-Bildmodell.

[[File:Doligenweb-v24-sources-de.png|center|thumb|800px|Auf der Karte Ludwigs XVI. zitierte Quellen]]

===Teilen mit der Familie, Jahrestage und Kontakte===

*'''Schutz lebender Personen''' (DSGVO): lebende Personen oder solche, die vor weniger als N Jahren geboren wurden, werden Benutzern ohne das Recht '''Lebende Personen lesen''' verborgen; eine Schaltfläche legt die Gruppe „Genealogie - Familie (nur Lesen)" an.
*'''Jahrestage''' und Gedenktage des Tages und der nächsten 7 Tage auf der Startseite und in der Terminplanung.
*Verknüpfung mit den '''Dolibarr-Kontakten''' und E-Mailing-Auswahl der Familienmitglieder.
*'''Galerie''' der Person mit Anmerkungen zu den Fotos und Kennzeichnung der Personen.

===GEDCOM-Import und -Export===

*'''Import''': Ziehen und Ablegen der <code>.ged</code>-Datei, Hochladen in Teilen von 512 KB, Fortschrittsbalken, Fortsetzen eines unterbrochenen Imports und Importverlauf. Die Namensbestandteile (<code>GIVN</code>, <code>SPFX</code>, <code>SURN</code>, <code>NSFX</code>, <code>NPFX</code>, <code>NICK</code>) und der Titel (<code>TITL</code>) werden gelesen; eine Option trennt die im Nachnamen geschriebene Partikel ab, wenn die Datei keine <code>SPFX</code>-Angabe hat (wie bei Heredis).
*'''Export''': Datei im Format '''GEDCOM 5.5.1''' in '''UTF-8''', filterbar nach Anfang des Nachnamens und nach Geschlecht, mit optionalem Ausblenden lebender Personen.
*Ebenfalls ausgetauscht werden Quellen, Archive und Zitate (<code>SOUR</code>, <code>REPO</code>, <code>PAGE</code>, <code>QUAY</code>), Zeugen (<code>ASSO</code>, <code>_WITN</code>) und die Datumsgenauigkeit (<code>ABT</code>, <code>BEF</code>, <code>AFT</code>, <code>BET</code>, <code>FROM</code>/<code>TO</code>).

[[File:Doligenweb-v24-gedcom-import-de.png|center|thumb|800px|Import einer GEDCOM-Datei per Ziehen und Ablegen]]

===Kalenderumrechner===

Die Konfiguration bietet einen Datumsumrechner zwischen dem '''gregorianischen''', '''julianischen''', '''französischen Revolutions-''', '''hebräischen''' und '''islamischen''' Kalender, mit julianischem Tag und Mondalter, um alte Urkunden zu übertragen.

===Integriertes Benutzerhandbuch===

Ein vollständiges Handbuch auf '''Französisch, Englisch, Deutsch, Spanisch und Italienisch''' ist direkt in der Konfiguration des Moduls, Registerkarte '''Benutzerhandbuch''', in der Sprache der Oberfläche abrufbar.

[[File:Doligenweb-v24-guide-de.png|center|thumb|800px|Integriertes Benutzerhandbuch]]

''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''

==Voraussetzungen==
'''Dolibarr:''' unterstützte Versionen:

*'''24.x'''

'''PHP:''' Version 7.2 mindestens, getestet bis PHP 8.5.

'''PHP-Erweiterung:''' <code>calendar</code> empfohlen (Revolutions-, hebräischer und islamischer Kalender des Umrechners).

'''Internetzugang des Servers:''' erforderlich für den historischen Kontext (Wikidata, Wikipedia) und die Geokodierung der Orte (OpenStreetMap Nominatim). Der Rest des Moduls funktioniert offline.

=⚙️ Installationsanleitung=

===⚙️ Methode 1: Installation über die Dolibarr-Oberfläche===

# Öffnen Sie '''Start''' > '''Einstellungen''' > '''Module/Anwendungen'''.
# Gehen Sie zur Registerkarte '''Externes Modul bereitstellen/installieren'''.
# Klicken Sie auf '''Datei auswählen''' und wählen Sie die .zip-Datei des Moduls.
# Klicken Sie auf '''Datei hochladen''', um die Installation zu starten.
# Aktivieren Sie das Modul nach Abschluss der Installation.

Lehnt Dolibarr die Datei ab („Die Datei ist zu groß"), erhöhen Sie die Grenze '''MAIN_UPLOAD_DOC''' unter '''Start > Einstellungen > Sicherheit''', Registerkarte '''Dateien''', oder die PHP-Parameter <code>upload_max_filesize</code> und <code>post_max_size</code>, oder verwenden Sie Methode 2.

===⚙️ Methode 2: manuelle Installation auf dem Server===

Das Zip enthält einen Ordner <code>htdocs/doligenweb/</code>; der Ordner <code>doligenweb</code> muss im Verzeichnis <code>custom</code> von Dolibarr landen.

# '''Entpacken''': <code>unzip module_doligenweb-X.Y.Z.zip -d /tmp/doligenweb_zip</code>
# '''Kopieren''': <code>cp -r /tmp/doligenweb_zip/htdocs/doligenweb /pfad/zu/dolibarr/htdocs/custom/</code>
# '''Rechte vergeben''' an den Webserver, falls nötig: <code>chown -R www-data:www-data /pfad/zu/dolibarr/htdocs/custom/doligenweb</code>
# '''Prüfen''', dass der Ort <code>htdocs/custom/doligenweb</code> ist (und nicht <code>htdocs/custom/htdocs/doligenweb</code>).
# '''Aktivieren''' Sie das Modul in Dolibarr.

''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''

=Einrichtung=

Zugang: '''Start > Einstellungen > Module/Anwendungen''', Einstellungssymbol von DoliGenweb.

{| class="wikitable"
! Registerkarte !! Inhalt
=Inhaltsverzeichnis=
[[Category:Zusatzmodule]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Informationen=
{{TemplateModuleInfo
|modulename=DoliGenweb
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=doligenweb}}
|status=stable
|prerequisites=PHP 7.2 mindestens - PHP-Erweiterung calendar empfohlen
|minversion=24.0.x
|note=
''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''
}}

=Funktionen=
DoliGenweb bringt die '''Genealogie''' nach Dolibarr: Personen, Familien, Abstammungen, Orte und Lebensereignisse, mit Vorfahren- und Nachkommenbäumen, Sosa-Nummerierung, historischem Kontext und '''GEDCOM'''-Import/Export. Alle Daten bleiben in Ihrem Dolibarr und folgen seiner gewohnten Ergonomie (filterbare Listen, Karten mit Registerkarten, Notizen, Dokumente, ergänzende Attribute, Rechte pro Benutzer).

===Fünf genealogische Objekte===

*'''Personen''': Nachname, Vorname, Geschlecht, Beruf (Wörterbuch), Foto, optionale Verknüpfung mit einem Dolibarr-Partner.
*'''Familien''': Verbindung zweier Personen vom Typ Ehe, Verbindung, eingetragene Partnerschaft oder freie Partnerschaft, mit Datum, Ort und Auflösungsdatum.
*'''Beziehungen''': Eltern-Kind-Verbindung (Vater oder Mutter) und Reihenfolge des Kindes unter den Geschwistern.
*'''Quellen''': Arbeitsgenealogie ausgehend von einer Person (dem ''Probanden''), die die '''Kekulé-Nummerierung (Sosa-Stradonitz)''' aktiviert.
*'''Orte''': Gemeinde, Postleitzahl, Bundesland, Land, Typ und GPS-Koordinaten, mit OpenStreetMap-Karte.

Das Dashboard des Moduls zeigt die Anzahl der Personen, Familien, Beziehungen und Orte sowie die zuletzt geänderten Datensätze.

===Personenkarte===

Die Personenkarte vereint Identität, Eltern, Ehepartner, Kinder und '''Lebensereignisse''' (Geburt, Taufe, Tod, Beerdigung, Heirat, Beruf...). Jedes Ereignis hat ein Datum, einen Ort, eine Quelle und eine '''Datumsgenauigkeit''': Genau, Etwa, Vor, Nach, Zwischen oder Unbekannt.

Schaltflächen legen '''Vater''', '''Mutter''', ein '''Kind''' oder einen '''Ehepartner''' direkt von der Karte aus an und speichern die Verbindung in einem Schritt.

Verfügbare Registerkarten: Person, Stammbäume, Kontakte, Notizen, Dokumente, Historische Ereignisse (Kontakte, Notizen, Dokumente und Terminplanung werden in der Konfiguration aktiviert).

===Stammbäume===

*Vorfahren oder Nachkommen, von '''2 bis 8 Generationen'''.
*Ansicht in '''Kästchen''' oder als zoombares '''Ahnenrad'''.
*Anzeige des Geburts-, Heirats- oder Sterbeorts, Filter auf einen Ort oder ausgeblendete Orte.
*Erzeugung des Stammbaums als '''PDF''' im Querformat.
*Die letzten Einstellungen werden für jeden Benutzer gespeichert.

===Historischer Kontext===

Die Registerkarte '''Historische Ereignisse''' fragt '''Wikidata''' und '''Wikipedia''' ab, um die Ereignisse während des Lebens der Person und die '''Staatsoberhäupter''' des Zeitraums zu finden, für Frankreich, die Schweiz, Deutschland, das Vereinigte Königreich, Belgien, Italien und Spanien. Die Länder werden anhand der Orte der Person vorausgewählt.

===Geolokalisierte Orte===

Die Schaltfläche '''Koordinaten suchen''' ermittelt Breite und Länge eines Ortes per Geokodierung über '''OpenStreetMap Nominatim''', und der Ort wird auf einer Karte angezeigt.

===GEDCOM-Import und -Export===

*'''Import''': Drag & Drop der <code>.ged</code>-Datei, Upload in Stücken von 512 KB (große Dateien kommen durch, ohne die PHP-Grenzen zu ändern), Fortschrittsbalken, Fortsetzung eines unterbrochenen Imports und Importverlauf.
*'''Export''': Datei im Format '''GEDCOM 5.5.1''' in '''UTF-8''', filterbar nach Anfang des Nachnamens und nach Geschlecht.
*Unterstützte Tags: <code>INDI</code>, <code>FAM</code>, <code>NAME</code>, <code>SEX</code>, <code>BIRT</code>, <code>DEAT</code>, <code>BAPM</code>, <code>CHR</code>, <code>BURI</code>, <code>MARR</code>, <code>OCCU</code>, <code>EVEN</code>, <code>NOTE</code>, <code>SOUR</code>, <code>OBJE</code>, <code>PLAC</code>, <code>TITL</code>, <code>HUSB</code>, <code>WIFE</code>, <code>CHIL</code>, <code>FAMC</code>, <code>FAMS</code>, <code>CHAR</code>, <code>CONC</code>, <code>CONT</code>.

===Kalenderumrechner===

Die Konfiguration bietet einen Datumsumrechner zwischen dem '''gregorianischen''', '''julianischen''', '''französischen Revolutions-''', '''hebräischen''' und '''islamischen''' Kalender, mit julianischem Tag und Mondalter, um alte Urkunden zu übertragen.

===Integriertes Benutzerhandbuch===

Ein vollständiges Handbuch auf '''Französisch, Englisch, Deutsch, Spanisch und Italienisch''' ist direkt in der Modulkonfiguration, Registerkarte '''Benutzerhandbuch''', in der Sprache der Oberfläche verfügbar.

''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''

==Voraussetzungen==
'''Dolibarr:''' unterstützte Versionen:

*'''24.x'''

'''PHP:''' Version 7.2 mindestens, getestet bis PHP 8.5.

'''PHP-Erweiterung:''' <code>calendar</code> empfohlen (Revolutions-, hebräischer und islamischer Kalender des Umrechners).

'''Internetzugang des Servers:''' erforderlich für den historischen Kontext (Wikidata, Wikipedia) und die Geokodierung der Orte (OpenStreetMap Nominatim). Der Rest des Moduls funktioniert offline.

=⚙️ Installationsanleitung=

===⚙️ Methode 1: Installation über die Dolibarr-Oberfläche===

# Öffnen Sie '''Start''' > '''Einstellungen''' > '''Module/Anwendungen'''.
# Gehen Sie zur Registerkarte '''Externes Modul bereitstellen/installieren'''.
# Klicken Sie auf '''Datei auswählen''' und wählen Sie die .zip-Datei des Moduls.
# Klicken Sie auf '''Datei hochladen''', um die Installation zu starten.
# Aktivieren Sie das Modul nach Abschluss der Installation.

Lehnt Dolibarr die Datei ab („Die Datei ist zu groß"), erhöhen Sie die Grenze '''MAIN_UPLOAD_DOC''' unter '''Start > Einstellungen > Sicherheit''', Registerkarte '''Dateien''', oder die PHP-Parameter <code>upload_max_filesize</code> und <code>post_max_size</code>, oder verwenden Sie Methode 2.

===⚙️ Methode 2: manuelle Installation auf dem Server===

Das Zip enthält einen Ordner <code>htdocs/doligenweb/</code>; der Ordner <code>doligenweb</code> muss im Verzeichnis <code>custom</code> von Dolibarr landen.

# '''Entpacken''': <code>unzip module_doligenweb-X.Y.Z.zip -d /tmp/doligenweb_zip</code>
# '''Kopieren''': <code>cp -r /tmp/doligenweb_zip/htdocs/doligenweb /pfad/zu/dolibarr/htdocs/custom/</code>
# '''Rechte vergeben''' an den Webserver, falls nötig: <code>chown -R www-data:www-data /pfad/zu/dolibarr/htdocs/custom/doligenweb</code>
# '''Prüfen''', dass der Ort <code>htdocs/custom/doligenweb</code> ist (und nicht <code>htdocs/custom/htdocs/doligenweb</code>).
# '''Aktivieren''' Sie das Modul in Dolibarr.

''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''

=Einrichtung=

Zugang: '''Start > Einstellungen > Module/Anwendungen''', Einstellungssymbol von DoliGenweb.

{| class="wikitable"
! Registerkarte !! Inhalt
|-
| Einstellungen || Anzeige der Registerkarten Kontakte, Notizen, Dokumente und Terminplanung; Kalenderumrechner
|-
| Ergänzende Attribute || Benutzerdefinierte Felder für Familien, Personen und Orte
|-
| GEDCOM-Import || Hochladen einer <code>.ged</code>-Datei und Importverlauf
|-
| GEDCOM-Export || Erzeugung einer gefilterten <code>.ged</code>-Datei
|-
| Benutzerhandbuch || Vollständiges Handbuch in der Sprache der Oberfläche
|-
| Über || Informationen zum Modul
|}

'''Rechte''': Person, Familie, Beziehung, Quelle und Ort haben jeweils ein Recht '''Lesen''', '''Erstellen/Ändern''' und '''Löschen''' (Menü '''Benutzer & Gruppen''', Registerkarte '''Berechtigungen''').

'''Wörterbücher''': '''Ereignistypen von Personen''' und '''Berufe''' (Menü '''Start > Einstellungen > Wörterbücher''').

''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''

=Verwendung=

# '''Importieren''' Sie eine vorhandene GEDCOM-Datei (Registerkarte '''GEDCOM-Import''' der Konfiguration) oder legen Sie die Personen einzeln an über '''DoliGenweb > Personen > Neue Person'''.
# '''Vervollständigen''' Sie die Datensätze: Eltern, Ehepartner, Kinder, Lebensereignisse mit Daten, Orten und Quellen.
# '''Legen Sie eine Quelle an''' unter '''DoliGenweb > Quellen''' mit Ihrer Ausgangsperson, um die Sosa-Nummern anzuzeigen.
# '''Zeigen Sie den Stammbaum''' in der Registerkarte '''Stammbäume''' einer Person an und drucken Sie ihn als PDF.
# '''Ordnen''' Sie das Leben eines Vorfahren mit der Registerkarte '''Historische Ereignisse''' in die Geschichte ein.
# '''Exportieren''' Sie die Genealogie als GEDCOM, um sie mit einer anderen Software auszutauschen.

Die Bildschirme für GEDCOM-Import und -Export werden derzeit nur auf Französisch angezeigt.

==Fehlerbehebung==

{| class="wikitable"
! Symptom !! Wahrscheinliche Ursache / Lösung
|-
| Das Menü DoliGenweb erscheint nicht || Leserecht dem Benutzer nicht erteilt
|-
| Die Registerkarten Kontakte, Notizen oder Dokumente fehlen || Option in der Registerkarte '''Einstellungen''' deaktiviert
|-
| Revolutions-, hebräischer oder islamischer Kalender fehlen || PHP-Erweiterung <code>calendar</code> fehlt auf dem Server
|-
| Meldung „Kein Geburtsdatum" || Der Person ein datiertes Geburtsereignis hinzufügen
|-
| Kein historisches Ereignis gefunden || Server ohne Internetzugang oder kein Land ausgewählt
|-
| GEDCOM-Import gesperrt || Schaltfläche '''Import entsperren''', dann neu starten
|-
| Falsche Umlaute oder Akzente nach dem Import || GEDCOM-Datei nicht in UTF-8: erneut in UTF-8 exportieren
|-
| Keine Sosa-Nummern sichtbar || Keine aktive Quelle: eine unter '''DoliGenweb > Quellen''' auswählen
|}

Das Dolibarr-Protokoll ('''Start - Einstellungen - Andere - Protokolle''') zeichnet Importe und Aufrufe externer Dienste auf.

''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''

=Andere Sprachen=

* [[Module_DoliGenweb_FR|Documentation française du module DoliGenweb]]
* [[Module_DoliGenweb_EN|English documentation for the DoliGenweb module]]
* [[Module_DoliGenweb_ES|Documentación en español del módulo DoliGenweb]]
* [[Module_DoliGenweb_IT|Documentazione in italiano del modulo DoliGenweb]]

''[[#Inhaltsverzeichnis|⬆ Zurück zum Inhaltsverzeichnis]]''

[[fr:Module_DoliGenweb_FR]]
[[en:Module_DoliGenweb_EN]]
[[es:Module_DoliGenweb_ES]]
[[it:Module_DoliGenweb_IT]]

Module DoliGenweb EN

2026-10-21T08:47:48Z

Grandoc:

=Summary=
[[Category:Add-on modules]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Informations=
{{TemplateModuleInfo
|modulename=DoliGenweb
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=doligenweb}}
|status=stable
|prerequisites=PHP 7.2 minimum - PHP calendar extension recommended
|minversion=24.0.x
|note=
''[[#Summary|⬆ Back to summary]]''
}}

=Features=
DoliGenweb adds '''genealogy''' to Dolibarr: individuals, families, parentage, places, sources and life events, with trees, Sosa numbering, kinship calculation, statistics, migration maps, timeline, historical context and '''GEDCOM''' import/export. All data stays in your Dolibarr and follows its usual ergonomics (filterable lists, tabbed cards, notes, documents, complementary attributes, per-user rights).

The screenshots below were taken with a demonstration genealogy of the House of Bourbon (Louis XVI, Marie-Antoinette and their ancestors).

[[File:Doligenweb-v24-home-en.png|center|thumb|800px|Module dashboard: counters and last modified records]]

===Six genealogical objects===

*'''Individuals''': given names, particle, surname, suffix, title, nickname, married name, sex, occupation (dictionary), photo, link to a Dolibarr contact.
*'''Families''': union between two individuals, of type Marriage, Union, Civil partnership or Free union, with date, place, dissolution date and witnesses.
*'''Relationships''': parent / child link (father or mother) and rank of the child among the siblings.
*'''Places''': town, postcode, department, country, type and GPS coordinates, with a '''Map''' tab.
*'''Sources''': records and documents (type, author, archive repository, call number, URL, text, attached files), cited on individuals, events and families with page, quality and transcription.
*'''Sosa trees''': working genealogy rooted on one individual (the ''de cujus''), which enables '''Sosa-Stradonitz''' numbering.

[[File:Doligenweb-v24-sosa-tree-en.png|center|thumb|800px|Sosa tree rooted on Louis-Charles, son of Louis XVI]]

===Individual card===

The card of an individual gathers their identity (with the name pieces: particle, suffix, title, nickname), parents, spouses, children, roles as witness or godparent and '''life events''': birth, baptism, death, burial, marriage, occupation, residence, census, military service, will, emigration, naturalisation… Each event has a date, a place, source citations and a '''date accuracy''' (Exact, About, Before, After, Between, Unknown). Every field has a help tooltip.

Buttons directly create the '''father''', the '''mother''', a '''child''' or a '''spouse''' from the card, saving the link in a single step.

Tabs of the individual: Individual, Trees, Kinship, Statistics, Research, Migrations, Timeline, Consistency, Duplicates, Gallery, Sources, Historical events, plus Contacts, Notes, Documents and Agenda depending on the setup.

[[File:Doligenweb-v24-individual-card-en.png|center|thumb|800px|Card of Louis XVI: identity, name pieces, parents, unions and children]]

===Family trees===

*'''Ancestors''', '''descendants''' and '''hourglass''' modes (ancestors above, descendants below).
*'''Boxes''' view, '''ancestor wheel''' or '''descendant fan'''.
*Colour and display of the place of birth, marriage or death, filter on one place, or places hidden.
*Tree generated as '''PDF''', from A4 up to A0 for large prints.
*PDF reports of the individual: Sosa ancestry, d'Aboville descendancy, family sheet and family book.

[[File:Doligenweb-v24-tree-en.png|center|thumb|800px|Ancestors of Louis-Charles over 4 generations, coloured by place of birth]]

[[File:Doligenweb-v24-tree-wheel-en.png|center|thumb|800px|Ancestor wheel over 5 generations]]

[[File:Doligenweb-v24-tree-hourglass-en.png|center|thumb|800px|Hourglass tree of Louis XVI]]

===Kinship===

The '''Kinship''' tab names the relationship between two individuals in the 5 languages (half-siblings, second cousins, generation offsets, in-laws), gives the civil-law degree, the closest common ancestors and the kinship paths.

[[File:Doligenweb-v24-kinship-en.png|center|thumb|800px|Marie-Antoinette is the second cousin once removed of Louis XVI]]

===Statistics and indexes===

*'''Statistics''' of the whole genealogy: counts and completion rates, ages at death, at first union and of parents at birth, births per century, children per couple, most frequent surnames, given names, places and occupations.
*'''Statistics''' tab of the individual: ancestry completeness and pedigree collapse per generation.
*'''Surname index''' and '''place index''' with letter bar and quick filter; each entry opens the genealogical search.
*'''Genealogical search''' by surname, given names, spouse, parents, place and events, with wildcards and phonetic variants, also from the Dolibarr global search.

[[File:Doligenweb-v24-statistics-en.png|center|thumb|800px|Statistics of the genealogy]]

[[File:Doligenweb-v24-surname-index-en.png|center|thumb|800px|Surname index]]

[[File:Doligenweb-v24-place-index-en.png|center|thumb|800px|Place index]]

===Research to do and consistency===

*'''Research''' tab: missing Sosa ancestors and missing records (birth, marriage, death) per generation, with the lead to follow; each research can become an agenda task linked to the individual.
*'''Consistency checks''': impossible or unlikely dates, ages of parents and spouses, duplicate or looping parentage, with adjustable thresholds.
*'''Duplicates''': detection of likely duplicates (phonetic surname, close given name, compatible dates, common parents or spouse), side-by-side comparison and merge.

[[File:Doligenweb-v24-research-en.png|center|thumb|800px|Research to do in the ancestry of Louis XVI]]

[[File:Doligenweb-v24-consistency-en.png|center|thumb|800px|Consistency checks]]

===Migrations and geolocated places===

*'''Migrations''' tab: places of birth of the Sosa ancestors on a map, animated generation by generation, with paternal or maternal branch filter, moves between generations and distances per generation.
*'''Map''' tab of the place, and choice of the base map: '''OpenStreetMap''', '''IGN map''', '''Cassini map''' or '''État-major map'''.
*'''Geocoding''' of one place, or of all places at once from the setup, with '''OpenStreetMap Nominatim'''.

[[File:Doligenweb-v24-migration-en.png|center|thumb|800px|Migrations of the ancestors of Louis-Charles over 6 generations]]

[[File:Doligenweb-v24-place-map-en.png|center|thumb|800px|Map tab of the place Versailles]]

===Timeline and historical context===

*The '''Historical events''' tab imports from '''Wikidata''' and '''Wikipedia''' the events that occurred during the individual's life and the '''heads of state''' of the period, for France, Switzerland, Germany, the United Kingdom, Belgium, Italy and Spain.
*The '''Timeline''' tab mixes, on a life bar and in a chronological table, the events of the individual, those of their close family and this historical context, with the age at each event.

[[File:Doligenweb-v24-timeline-en.png|center|thumb|800px|Timeline of Louis XVI with the historical context]]

[[File:Doligenweb-v24-historical-events-en.png|center|thumb|800px|Historical events imported from Wikidata]]

===Sources and citations===

The '''Sources''' tab of the individual lists the citations of their events and unions. The card of a source shows the '''Cited by''' block and a '''Transcription''' tab where the image of the record is placed next to the text, with an optional transcription proposal by a local '''Ollama''' vision model.

[[File:Doligenweb-v24-sources-en.png|center|thumb|800px|Sources cited on the card of Louis XVI]]

===Sharing with the family, anniversaries and contacts===

*'''Protection of the living individuals''' (GDPR): living individuals, or those born less than N years ago, are hidden from users without the '''Read the living individuals''' right; a button creates the group "Genealogy - Family (read only)".
*'''Anniversaries''' and commemorations of the day and of the next 7 days on the home page and in the agenda.
*Link with '''Dolibarr contacts''' and emailing selector of the family members.
*'''Gallery''' of the individual with photo annotation and identification of people.

===GEDCOM import and export===

*'''Import''': drag and drop of the <code>.ged</code> file, upload in 512 KB chunks, progress bar, resume of an interrupted import and import history. The name pieces (<code>GIVN</code>, <code>SPFX</code>, <code>SURN</code>, <code>NSFX</code>, <code>NPFX</code>, <code>NICK</code>) and the title (<code>TITL</code>) are read; an option splits the particle written in the surname when the file has no <code>SPFX</code> tag (as with Heredis).
*'''Export''': '''GEDCOM 5.5.1''' file in '''UTF-8''', filterable by beginning of surname and by sex, with optional hiding of living individuals.
*Sources, repositories and citations (<code>SOUR</code>, <code>REPO</code>, <code>PAGE</code>, <code>QUAY</code>), witnesses (<code>ASSO</code>, <code>_WITN</code>) and date accuracy (<code>ABT</code>, <code>BEF</code>, <code>AFT</code>, <code>BET</code>, <code>FROM</code>/<code>TO</code>) are exchanged too.

[[File:Doligenweb-v24-gedcom-import-en.png|center|thumb|800px|Import of a GEDCOM file by drag and drop]]

===Calendar converter===

The setup provides a date converter between the '''Gregorian''', '''Julian''', '''French Republican''', '''Hebrew''' and '''Islamic''' calendars, with Julian day and Moon age, to transcribe old records.

===Built-in user guide===

A complete guide in '''French, English, German, Spanish and Italian''' can be read directly from the module setup, '''User guide''' tab, in the interface language.

[[File:Doligenweb-v24-guide-en.png|center|thumb|800px|Built-in user guide]]

''[[#Summary|⬆ Back to summary]]''

==Prerequisites==
'''Dolibarr:''' supported versions:

*'''24.x'''

'''PHP:''' version 7.2 minimum, tested up to PHP 8.5.

'''PHP extension:''' <code>calendar</code> recommended (Republican, Hebrew and Islamic calendars of the converter).

'''Server Internet access:''' needed for the historical context (Wikidata, Wikipedia) and place geocoding (OpenStreetMap Nominatim). The rest of the module works offline.

=⚙️ Installation procedure=

===⚙️ Method 1: installation from the Dolibarr interface===

# Go to '''Home''' > '''Setup''' > '''Modules/Applications'''.
# Open the '''Deploy/install external app/module''' tab.
# Click '''Choose file''' and select the module .zip file.
# Click '''Upload file''' to start the installation.
# Enable the module once the installation is complete.

If Dolibarr rejects the file ("The file size is too large"), raise the '''MAIN_UPLOAD_DOC''' limit in '''Home > Setup > Security''', '''Files''' tab, or the PHP settings <code>upload_max_filesize</code> and <code>post_max_size</code>, or use method 2.

===⚙️ Method 2: manual installation on the server===

The zip contains a <code>htdocs/doligenweb/</code> folder; the <code>doligenweb</code> folder must end up in the Dolibarr <code>custom</code> directory.

# '''Unzip''': <code>unzip module_doligenweb-X.Y.Z.zip -d /tmp/doligenweb_zip</code>
# '''Copy''': <code>cp -r /tmp/doligenweb_zip/htdocs/doligenweb /path/to/dolibarr/htdocs/custom/</code>
# '''Grant rights''' to the web server if needed: <code>chown -R www-data:www-data /path/to/dolibarr/htdocs/custom/doligenweb</code>
# '''Check''' that the location is <code>htdocs/custom/doligenweb</code> (not <code>htdocs/custom/htdocs/doligenweb</code>).
# '''Enable''' the module from Dolibarr.

''[[#Summary|⬆ Back to summary]]''

=Setup=

Access: '''Home > Setup > Modules/Applications''', DoliGenweb settings icon.

{| class="wikitable"
! Tab !! Content

File:Doligenweb-v24-tree-wheel-it.png

2026-10-21T08:43:59Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-wheel-it.png

File:Doligenweb-v24-tree-wheel-fr.png

2026-10-21T08:43:57Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-wheel-fr.png

File:Doligenweb-v24-tree-wheel-es.png

2026-10-21T08:43:56Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-wheel-es.png

File:Doligenweb-v24-tree-wheel-en.png

2026-10-21T08:43:54Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-wheel-en.png

File:Doligenweb-v24-tree-wheel-de.png

2026-10-21T08:43:53Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-wheel-de.png

File:Doligenweb-v24-tree-it.png

2026-10-21T08:43:51Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-it.png

File:Doligenweb-v24-tree-hourglass-it.png

2026-10-21T08:43:50Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-hourglass-it.png

File:Doligenweb-v24-tree-hourglass-fr.png

2026-10-21T08:43:48Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-hourglass-fr.png

File:Doligenweb-v24-tree-hourglass-es.png

2026-10-21T08:43:47Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-hourglass-es.png

File:Doligenweb-v24-tree-hourglass-en.png

2026-10-21T08:43:45Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-hourglass-en.png

File:Doligenweb-v24-tree-hourglass-de.png

2026-10-21T08:43:44Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-hourglass-de.png

File:Doligenweb-v24-tree-fr.png

2026-10-21T08:43:42Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-fr.png

File:Doligenweb-v24-tree-es.png

2026-10-21T08:43:40Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-es.png

File:Doligenweb-v24-tree-en.png

2026-10-21T08:43:39Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-en.png

Module DoliGenweb FR

2026-10-21T08:43:38Z

Grandoc:

=Sommaire=
[[Category:Modules complémentaires]]
{{TemplateDocDev}}
{{TemplateDocUtil}}
=Informations=
{{TemplateModuleInfo
|modulename=DoliGenweb
|editor=[[File:Logo atoonet.jpg|link=https://www.atoo-net.com]]
|webbuy={{LinkToPluginDownloadDoliStore|keyword=doligenweb}}
|status=stable
|prerequisites=PHP 7.2 minimum - extension PHP calendar recommandée
|minversion=24.0.x
|note=
''[[#Sommaire|⬆ Retour au sommaire]]''
}}

=Fonctionnalités=
DoliGenweb ajoute la '''généalogie''' à Dolibarr : individus, familles, filiations, lieux, sources et événements de vie, avec arbres, numérotation Sosa, calcul de parenté, statistiques, cartes de migrations, frise chronologique, contexte historique et import/export '''GEDCOM'''. Toutes les données restent dans votre Dolibarr et suivent son ergonomie habituelle (listes filtrables, fiches à onglets, notes, documents, attributs complémentaires, droits par utilisateur).

Les copies d'écran ci-dessous ont été réalisées avec une généalogie de démonstration de la maison de Bourbon (Louis XVI, Marie-Antoinette et leurs ancêtres).

[[File:Doligenweb-v24-home-fr.png|center|thumb|800px|Tableau de bord du module : compteurs et dernières fiches modifiées]]

===Six objets généalogiques===

*'''Individus''' : prénoms, particule, nom, suffixe, titre, surnom, nom d'usage, sexe, profession (dictionnaire), photo, lien vers un contact Dolibarr.
*'''Familles''' : union entre deux individus, de type Mariage, Union, PACS ou Union libre, avec date, lieu, date de dissolution et témoins.
*'''Relations''' : lien parent / enfant (père ou mère) et rang de l'enfant dans la fratrie.
*'''Lieux''' : commune, code postal, département, pays, type et coordonnées GPS, avec un onglet '''Carte'''.
*'''Sources''' : actes et documents (type, auteur, dépôt d'archives, cote, URL, texte, fichiers joints), cités sur les individus, les événements et les familles avec page, qualité et transcription.
*'''Arbres Sosa''' : généalogie de travail enracinée sur un individu (le ''de cujus''), qui active la numérotation '''Sosa-Stradonitz'''.

[[File:Doligenweb-v24-sosa-tree-fr.png|center|thumb|800px|Arbre Sosa enraciné sur Louis-Charles, fils de Louis XVI]]

===Fiche individu===

La fiche d'un individu regroupe son identité (avec les éléments du nom : particule, suffixe, titre, surnom), ses parents, ses conjoints, ses enfants, ses participations comme témoin ou parrain et ses '''événements de vie''' : naissance, baptême, décès, inhumation, mariage, profession, résidence, recensement, service militaire, testament, émigration, naturalisation… Chaque événement porte une date, un lieu, des citations de sources et une '''précision de date''' (Exacte, Environ, Avant, Après, Entre, Inconnue). Chaque champ dispose d'une aide.

Des boutons créent directement le '''père''', la '''mère''', un '''enfant''' ou un '''conjoint''' depuis la fiche, en enregistrant le lien en une seule étape.

Onglets de l'individu : Individu, Arbres, Parenté, Statistiques, Recherches, Migrations, Frise, Cohérence, Doublons, Galerie, Sources, Événements historiques, ainsi que Contacts, Notes, Documents et Agenda selon la configuration.

[[File:Doligenweb-v24-individual-card-fr.png|center|thumb|800px|Fiche de Louis XVI : identité, éléments du nom, parents, unions et enfants]]

===Arbres généalogiques===

*Modes '''ascendance''', '''descendance''' et '''sablier''' (ancêtres au-dessus, descendants au-dessous).
*Vue en '''cases''', '''roue d'ascendance''' ou '''éventail de descendance'''.
*Couleur et affichage du lieu de naissance, de mariage ou de décès, filtre sur un lieu, ou masquage des lieux.
*Génération de l'arbre en '''PDF''', du format A4 au format A0 pour les grands tirages.
*Rapports PDF de l'individu : ascendance Sosa, descendance d'Aboville, fiche familiale et livre de famille.

[[File:Doligenweb-v24-tree-fr.png|center|thumb|800px|Ascendance de Louis-Charles sur 4 générations, colorée par lieu de naissance]]

[[File:Doligenweb-v24-tree-wheel-fr.png|center|thumb|800px|Roue d'ascendance sur 5 générations]]

[[File:Doligenweb-v24-tree-hourglass-fr.png|center|thumb|800px|Arbre en sablier de Louis XVI]]

===Parenté===

L'onglet '''Parenté''' nomme le lien entre deux individus dans les 5 langues (demi-frères, cousins issus de germains, décalages de génération, alliés), donne le degré en droit civil, les ancêtres communs les plus proches et les chemins de parenté.

[[File:Doligenweb-v24-kinship-fr.png|center|thumb|800px|Marie-Antoinette est la cousine issue de germain de Louis XVI, décalée d'une génération]]

===Statistiques et index===

*'''Statistiques''' de toute la généalogie : effectifs et taux de renseignement, âges au décès, à la première union et des parents à la naissance, naissances par siècle, enfants par couple, noms, prénoms, lieux et professions les plus fréquents.
*Onglet '''Statistiques''' de l'individu : complétude de l'ascendance et implexe par génération.
*'''Index des noms''' et '''index des lieux''' avec barre de lettres et filtre rapide ; chaque entrée ouvre la recherche généalogique.
*'''Recherche généalogique''' par nom, prénoms, conjoint, parents, lieu et événements, avec jokers et variantes phonétiques, aussi depuis la recherche globale de Dolibarr.

[[File:Doligenweb-v24-statistics-fr.png|center|thumb|800px|Statistiques de la généalogie]]

[[File:Doligenweb-v24-surname-index-fr.png|center|thumb|800px|Index des noms de famille]]

[[File:Doligenweb-v24-place-index-fr.png|center|thumb|800px|Index des lieux]]

===Recherches à mener et cohérence===

*Onglet '''Recherches''' : ancêtres Sosa manquants et actes manquants (naissance, mariage, décès) par génération, avec la piste à suivre ; chaque recherche peut devenir une tâche de l'agenda liée à l'individu.
*'''Contrôles de cohérence''' : dates impossibles ou improbables, âges des parents et des époux, filiations en double ou en boucle, avec des seuils réglables.
*'''Doublons''' : détection des doublons probables (nom phonétique, prénom proche, dates compatibles, parents ou conjoint communs), comparaison côte à côte et fusion.

[[File:Doligenweb-v24-research-fr.png|center|thumb|800px|Recherches à mener dans l'ascendance de Louis XVI]]

[[File:Doligenweb-v24-consistency-fr.png|center|thumb|800px|Contrôles de cohérence]]

===Migrations et lieux géolocalisés===

*Onglet '''Migrations''' : lieux de naissance des ancêtres Sosa sur une carte, animée génération par génération, avec filtre de branche paternelle ou maternelle, déplacements entre générations et distances par génération.
*Onglet '''Carte''' du lieu, et choix du fond de carte : '''OpenStreetMap''', '''Plan IGN''', '''carte de Cassini''' ou '''carte d'état-major'''.
*'''Géocodage''' d'un lieu, ou de tous les lieux en une fois depuis la configuration, par '''OpenStreetMap Nominatim'''.

[[File:Doligenweb-v24-migration-fr.png|center|thumb|800px|Migrations des ancêtres de Louis-Charles sur 6 générations]]

[[File:Doligenweb-v24-place-map-fr.png|center|thumb|800px|Onglet Carte du lieu Versailles]]

===Frise et contexte historique===

*L'onglet '''Événements historiques''' importe de '''Wikidata''' et '''Wikipédia''' les événements survenus pendant la vie de l'individu et les '''chefs d'État''' de la période, pour la France, la Suisse, l'Allemagne, le Royaume-Uni, la Belgique, l'Italie et l'Espagne.
*L'onglet '''Frise''' mêle sur une barre de vie et dans un tableau chronologique les événements de l'individu, ceux de sa famille proche et ce contexte historique, avec l'âge à chaque événement.

[[File:Doligenweb-v24-timeline-fr.png|center|thumb|800px|Frise de Louis XVI avec le contexte historique]]

[[File:Doligenweb-v24-historical-events-fr.png|center|thumb|800px|Événements historiques importés de Wikidata]]

===Sources et citations===

L'onglet '''Sources''' de l'individu liste les citations de ses événements et de ses unions. La fiche d'une source affiche le bloc '''Cité par''' et un onglet '''Transcription''' où l'image de l'acte est placée à côté du texte, avec une proposition de transcription facultative par un modèle de vision '''Ollama''' local.

[[File:Doligenweb-v24-sources-fr.png|center|thumb|800px|Sources citées sur la fiche de Louis XVI]]

===Partage avec la famille, anniversaires et contacts===

*'''Protection des personnes vivantes''' (RGPD) : les individus vivants, ou nés depuis moins de N ans, sont masqués aux utilisateurs sans le droit '''Lire les personnes vivantes''' ; un bouton crée le groupe « Généalogie - Famille (lecture seule) ».
*'''Anniversaires''' et commémorations du jour et des 7 jours suivants sur la page d'accueil et dans l'agenda.
*Lien avec les '''contacts Dolibarr''' et sélecteur d'e-mailing des membres de la famille.
*'''Galerie''' de l'individu avec annotation des photos et identification des personnes.

===Import et export GEDCOM===

*'''Import''' : glisser-déposer du fichier <code>.ged</code>, envoi par morceaux de 512 Ko, barre de progression, reprise d'un import interrompu et historique des imports. Les éléments du nom (<code>GIVN</code>, <code>SPFX</code>, <code>SURN</code>, <code>NSFX</code>, <code>NPFX</code>, <code>NICK</code>) et le titre (<code>TITL</code>) sont lus ; une option sépare la particule écrite dans le nom quand le fichier n'a pas de balise <code>SPFX</code> (cas d'Heredis).
*'''Export''' : fichier '''GEDCOM 5.5.1''' en '''UTF-8''', filtrable par début de nom de famille et par sexe, avec masquage facultatif des personnes vivantes.
*Sont aussi échangés les sources, dépôts et citations (<code>SOUR</code>, <code>REPO</code>, <code>PAGE</code>, <code>QUAY</code>), les témoins (<code>ASSO</code>, <code>_WITN</code>) et la précision des dates (<code>ABT</code>, <code>BEF</code>, <code>AFT</code>, <code>BET</code>, <code>FROM</code>/<code>TO</code>).

[[File:Doligenweb-v24-gedcom-import-fr.png|center|thumb|800px|Import d'un fichier GEDCOM par glisser-déposer]]

===Convertisseur de calendriers===

La configuration propose un convertisseur de dates entre les calendriers '''grégorien''', '''julien''', '''républicain''', '''hébraïque''' et '''musulman''', avec jour julien et âge de la Lune, pour transcrire les actes anciens.

===Guide d'utilisation intégré===

Un guide complet en '''français, anglais, allemand, espagnol et italien''' est consultable directement depuis la configuration du module, onglet '''Guide utilisateur''', dans la langue de l'interface.

[[File:Doligenweb-v24-guide-fr.png|center|thumb|800px|Guide utilisateur intégré]]

''[[#Sommaire|⬆ Retour au sommaire]]''

==Prérequis==
'''Dolibarr :''' Versions supportées :

*'''24.x'''

'''PHP :''' version 7.2 minimum, testé jusqu'à PHP 8.5.

'''Extension PHP :''' <code>calendar</code> recommandée (calendriers républicain, hébraïque et musulman du convertisseur).

'''Accès Internet du serveur :''' nécessaire pour le contexte historique (Wikidata, Wikipédia) et le géocodage des lieux (OpenStreetMap Nominatim). Le reste du module fonctionne hors ligne.

=⚙️ Procédure d'installation=

===⚙️ Méthode 1 : installation via l'interface Dolibarr===

# Accédez au menu '''Accueil''' > '''Configuration''' > '''Modules/Applications'''.
# Allez dans l'onglet '''Déployer/Installer un module externe'''.
# Cliquez sur '''Choisir un fichier''' et sélectionnez le fichier .zip du module.
# Cliquez sur '''Envoyer fichier''' pour lancer l'installation.
# Activez le module une fois l'installation terminée.

Si Dolibarr refuse le fichier (« La taille du fichier est trop grande »), augmentez la limite '''MAIN_UPLOAD_DOC''' dans '''Accueil > Configuration > Sécurité''', onglet '''Fichiers''', ou les paramètres PHP <code>upload_max_filesize</code> et <code>post_max_size</code>, ou utilisez la méthode 2.

===⚙️ Méthode 2 : installation manuelle sur le serveur===

Le zip contient un dossier <code>htdocs/doligenweb/</code> ; c'est le dossier <code>doligenweb</code> qui doit se retrouver dans le répertoire <code>custom</code> de Dolibarr.

# '''Décompresser''' : <code>unzip module_doligenweb-X.Y.Z.zip -d /tmp/doligenweb_zip</code>
# '''Copier''' : <code>cp -r /tmp/doligenweb_zip/htdocs/doligenweb /chemin/vers/dolibarr/htdocs/custom/</code>
# '''Donner les droits''' au serveur web si nécessaire : <code>chown -R www-data:www-data /chemin/vers/dolibarr/htdocs/custom/doligenweb</code>
# '''Vérifier''' que l'emplacement est bien <code>htdocs/custom/doligenweb</code> (et non <code>htdocs/custom/htdocs/doligenweb</code>).
# '''Activer''' le module depuis Dolibarr.

''[[#Sommaire|⬆ Retour au sommaire]]''

=Configuration=

Accès : '''Accueil > Configuration > Modules/Applications''', icône de réglage de DoliGenweb.

File:Doligenweb-v24-tree-de.png

2026-10-21T08:43:37Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-tree-de.png

File:Doligenweb-v24-timeline-it.png

2026-10-21T08:43:36Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-timeline-it.png

File:Doligenweb-v24-timeline-fr.png

2026-10-21T08:43:34Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-timeline-fr.png

File:Doligenweb-v24-timeline-es.png

2026-10-21T08:43:33Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-timeline-es.png

File:Doligenweb-v24-timeline-en.png

2026-10-21T08:43:31Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-timeline-en.png

File:Doligenweb-v24-timeline-de.png

2026-10-21T08:43:30Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-timeline-de.png

File:Doligenweb-v24-surname-index-it.png

2026-10-21T08:43:28Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-surname-index-it.png

File:Doligenweb-v24-surname-index-fr.png

2026-10-21T08:43:26Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-surname-index-fr.png

File:Doligenweb-v24-surname-index-es.png

2026-10-21T08:43:25Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-surname-index-es.png

File:Doligenweb-v24-surname-index-en.png

2026-10-21T08:43:23Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-surname-index-en.png

File:Doligenweb-v24-surname-index-de.png

2026-10-21T08:43:21Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-surname-index-de.png

File:Doligenweb-v24-statistics-it.png

2026-10-21T08:43:20Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-statistics-it.png

File:Doligenweb-v24-statistics-fr.png

2026-10-21T08:43:18Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-statistics-fr.png

File:Doligenweb-v24-statistics-es.png

2026-10-21T08:43:16Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-statistics-es.png

File:Doligenweb-v24-statistics-en.png

2026-10-21T08:43:15Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-statistics-en.png

File:Doligenweb-v24-statistics-de.png

2026-10-21T08:43:13Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-statistics-de.png

File:Doligenweb-v24-sources-it.png

2026-10-21T08:43:12Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sources-it.png

File:Doligenweb-v24-sources-fr.png

2026-10-21T08:43:10Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sources-fr.png

File:Doligenweb-v24-sources-es.png

2026-10-21T08:43:09Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sources-es.png

File:Doligenweb-v24-sources-en.png

2026-10-21T08:43:07Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sources-en.png

File:Doligenweb-v24-sources-de.png

2026-10-21T08:43:06Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sources-de.png

File:Doligenweb-v24-sosa-tree-it.png

2026-10-21T08:43:04Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sosa-tree-it.png

File:Doligenweb-v24-sosa-tree-fr.png

2026-10-21T08:43:02Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sosa-tree-fr.png

File:Doligenweb-v24-sosa-tree-es.png

2026-10-21T08:43:01Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sosa-tree-es.png

File:Doligenweb-v24-sosa-tree-en.png

2026-10-21T08:42:59Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sosa-tree-en.png

File:Doligenweb-v24-sosa-tree-de.png

2026-10-21T08:42:58Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-sosa-tree-de.png

File:Doligenweb-v24-setup-it.png

2026-10-21T08:42:56Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-setup-it.png

File:Doligenweb-v24-setup-fr.png

2026-10-21T08:42:55Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-setup-fr.png

File:Doligenweb-v24-setup-es.png

2026-10-21T08:42:53Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-setup-es.png

File:Doligenweb-v24-setup-en.png

2026-10-21T08:42:52Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-setup-en.png

File:Doligenweb-v24-setup-de.png

2026-10-21T08:42:50Z

Grandoc: Screenshot upload

Screenshot: Doligenweb-v24-setup-de.png