Grandoc at 08:51, 21 October 2026

2026-10-21T08:51:28Z

Grandoc: Created page with "=Sommario= Category:Moduli aggiuntivi {{TemplateDocDev}} {{TemplateDocUtil}} =Informazioni= {{TemplateModuleInfo |modulename=DoliGenweb |editor=File:Logo atoonet.jpg|lin..."

2026-10-20T17:28:27Z

Created page with "=Sommario= Category:Moduli aggiuntivi {{TemplateDocDev}} {{TemplateDocUtil}} =Informazioni= {{TemplateModuleInfo |modulename=DoliGenweb |editor=File:Logo atoonet.jpg|lin..."

New page

=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 porta la '''genealogia''' in Dolibarr: persone, famiglie, filiazioni, luoghi ed eventi della vita, con alberi degli antenati e dei discendenti, numerazione Sosa, contesto storico e importazione/esportazione '''GEDCOM'''. Tutti i dati restano nel vostro Dolibarr e ne seguono l'ergonomia abituale (elenchi filtrabili, schede con schede secondarie, note, documenti, attributi complementari, permessi per utente).

===Cinque oggetti genealogici===

*'''Persone''': cognome, nome, sesso, professione (dizionario), foto, collegamento facoltativo a un soggetto terzo Dolibarr.
*'''Famiglie''': unione tra due persone, di tipo Matrimonio, Unione, Unione civile o Convivenza, con data, luogo e data di scioglimento.
*'''Relazioni''': legame genitore / figlio (padre o madre) e ordine del figlio tra i fratelli.
*'''Fonti''': genealogia di lavoro con radice in una persona (il ''de cujus''), che attiva la numerazione '''Sosa-Stradonitz'''.
*'''Luoghi''': comune, CAP, provincia, paese, tipo e coordinate GPS, con mappa OpenStreetMap.

Il cruscotto del modulo mostra il numero di persone, famiglie, relazioni e luoghi, oltre alle ultime schede modificate.

===Scheda persona===

La scheda di una persona riunisce identità, genitori, coniugi, figli ed '''eventi della vita''' (nascita, battesimo, morte, sepoltura, matrimonio, professione...). Ogni evento ha una data, un luogo, una fonte e una '''precisione della data''': Esatta, Circa, Prima, Dopo, Tra o Sconosciuta.

Alcuni pulsanti creano il '''padre''', la '''madre''', un '''figlio''' o un '''coniuge''' direttamente dalla scheda, registrando il legame in un solo passaggio.

Schede disponibili: Persona, Alberi, Contatti, Note, Documenti, Eventi storici (Contatti, Note, Documenti e Agenda si attivano nella configurazione).

===Alberi genealogici===

*Ascendenti o discendenti, da '''2 a 8 generazioni'''.
*Vista a '''caselle''' o '''ruota degli antenati''' ingrandibile.
*Visualizzazione del luogo di nascita, matrimonio o morte, filtro su un luogo o luoghi nascosti.
*Generazione dell'albero in '''PDF''' orizzontale.
*Le ultime impostazioni vengono memorizzate per ogni utente.

===Contesto storico===

La scheda '''Eventi storici''' interroga '''Wikidata''' e '''Wikipedia''' per trovare 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. I paesi sono preselezionati in base ai luoghi della persona.

===Luoghi geolocalizzati===

Il pulsante '''Cerca coordinate''' ricava latitudine e longitudine di un luogo tramite la geocodifica '''OpenStreetMap Nominatim''', e il luogo viene mostrato su una mappa.

===Importazione ed esportazione GEDCOM===

*'''Importazione''': trascinamento del file <code>.ged</code>, invio a blocchi di 512 KB (i file grandi passano senza toccare i limiti PHP), barra di avanzamento, ripresa di un'importazione interrotta e cronologia delle importazioni.
*'''Esportazione''': file '''GEDCOM 5.5.1''' in '''UTF-8''', filtrabile per inizio del cognome e per sesso.
*Tag supportati: <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>.

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

''[[#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 || Visualizzazione delle schede Contatti, Note, Documenti e Agenda; convertitore di calendari
|-
| Attributi complementari || Campi personalizzati di famiglie, persone e luoghi
|-
| 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
|}

'''Permessi''': Persona, Famiglia, Relazione, Fonte e Luogo hanno ciascuno un permesso '''Leggere''', '''Creare/Modificare''' ed '''Eliminare''' (menu '''Utenti e gruppi''', scheda '''Permessi''').

'''Dizionari''': '''Tipi di eventi individuali''' e '''Professioni''' (menu '''Home > Impostazioni > Dizionari''').

''[[#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, figli, eventi della vita con date, luoghi e fonti.
# '''Create una fonte''' in '''DoliGenweb > Fonti''' con la vostra persona radice per visualizzare i numeri Sosa.
# '''Visualizzate l'albero''' dalla scheda '''Alberi''' di una persona, poi stampatelo in PDF.
# '''Collocate''' la vita di un antenato nella Storia con la scheda '''Eventi storici'''.
# '''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
|-
| 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
|-
| I numeri Sosa non compaiono || Nessuna fonte attiva: selezionarne una in '''DoliGenweb > Fonti'''
|}

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 IT - Revision history

Grandoc at 08:51, 21 October 2026

Grandoc: Created page with "=Sommario= Category:Moduli aggiuntivi {{TemplateDocDev}} {{TemplateDocUtil}} =Informazioni= {{TemplateModuleInfo |modulename=DoliGenweb |editor=File:Logo atoonet.jpg|lin..."