Grandoc at 08:47, 21 October 2026

2026-10-21T08:47:48Z

Grandoc: Created page with "=Summary= Category:Add-on modules {{TemplateDocDev}} {{TemplateDocUtil}} =Informations= {{TemplateModuleInfo |modulename=DoliGenweb |editor=File:Logo atoonet.jpg|link=ht..."

2026-10-20T17:26:26Z

Created page with "=Summary= Category:Add-on modules {{TemplateDocDev}} {{TemplateDocUtil}} =Informations= {{TemplateModuleInfo |modulename=DoliGenweb |editor=File:Logo atoonet.jpg|link=ht..."

New page

=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 brings '''genealogy''' to Dolibarr: individuals, families, parent links, places and life events, with ancestor and descendant trees, Sosa numbering, historical context and '''GEDCOM''' import/export. All data stays in your Dolibarr and follows its usual ergonomics (filterable lists, cards with tabs, notes, documents, complementary attributes, per-user rights).

===Five genealogical objects===

*'''Individuals''': last name, first name, gender, occupation (dictionary), photo, optional link to a Dolibarr third party.
*'''Families''': union between two individuals, of type Marriage, Union, Civil partnership or Cohabitation, with date, place and dissolution date.
*'''Relationships''': parent / child link (father or mother) and order of the child among siblings.
*'''Sources''': working genealogy rooted on one individual (the ''de cujus''), which enables '''Sosa-Stradonitz''' numbering.
*'''Places''': town, zip code, state, country, type and GPS coordinates, with an OpenStreetMap map.

The module dashboard shows the number of individuals, families, relationships and places, and the latest modified records.

===Individual card===

The individual card gathers identity, parents, spouses, children and '''life events''' (birth, baptism, death, burial, marriage, occupation...). Each event has a date, a place, a source and a '''date precision''': Exact, About, Before, After, Between or Unknown.

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

Available tabs: Individual, Trees, Contacts, Notes, Documents, Historical events (Contacts, Notes, Documents and Agenda are enabled in the setup).

===Family trees===

*Ancestors or descendants, from '''2 to 8 generations'''.
*'''Boxes''' view or zoomable '''ancestry wheel'''.
*Display of the place of birth, marriage or death, filter on one place, or hidden places.
*Tree generated as a landscape '''PDF'''.
*Last settings are remembered for each user.

===Historical context===

The '''Historical events''' tab queries '''Wikidata''' and '''Wikipedia''' to find 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. Countries are preselected from the individual's places.

===Geolocated places===

The '''Search coordinates''' button finds the latitude and longitude of a place with '''OpenStreetMap Nominatim''' geocoding, and the place is shown on a map.

===GEDCOM import and export===

*'''Import''': drag and drop of the <code>.ged</code> file, upload in 512 KB chunks (large files go through without touching PHP limits), progress bar, resume of an interrupted import and import history.
*'''Export''': '''GEDCOM 5.5.1''' file in '''UTF-8''', filterable by beginning of last name and by gender.
*Supported 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>.

===Calendar converter===

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

===Built-in user guide===

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

''[[#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
|-
| Settings || Show the Contacts, Notes, Documents and Agenda tabs; calendar converter
|-
| Complementary attributes || Custom fields for families, individuals and places
|-
| GEDCOM import || Upload of a <code>.ged</code> file and import history
|-
| GEDCOM export || Generation of a filtered <code>.ged</code> file
|-
| User guide || Complete guide in the interface language
|-
| About || Module information
|}

'''Rights''': Individual, Family, Relationship, Source and Place each have a '''Read''', '''Create/Update''' and '''Delete''' right ('''Users & Groups''' menu, '''Permissions''' tab).

'''Dictionaries''': '''Individual event types''' and '''Occupations''' ('''Home > Setup > Dictionaries''' menu).

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

=Usage=

# '''Import''' an existing GEDCOM file ('''GEDCOM import''' tab of the setup), or create individuals one by one from '''DoliGenweb > Individuals > New individual'''.
# '''Complete''' the records: parents, spouses, children, life events with dates, places and sources.
# '''Create a source''' in '''DoliGenweb > Sources''' with your root individual to display Sosa numbers.
# '''Display the tree''' from the '''Trees''' tab of an individual, then print it as PDF.
# '''Place''' an ancestor's life in History with the '''Historical events''' tab.
# '''Export''' the genealogy as GEDCOM to exchange it with other software.

The GEDCOM import and export screens are currently displayed in French only.

==Troubleshooting==

{| class="wikitable"
! Symptom !! Likely cause / solution
|-
| The DoliGenweb menu does not appear || Read right not granted to the user
|-
| The Contacts, Notes or Documents tabs are missing || Option disabled in the '''Settings''' tab
|-
| Republican, Hebrew or Islamic calendars missing || PHP <code>calendar</code> extension missing on the server
|-
| "No birth date" message || Add a dated birth event to the individual
|-
| No historical event found || Server without Internet access, or no country selected
|-
| GEDCOM import locked || '''Unlock import''' button, then start again
|-
| Wrong accents after import || GEDCOM file not UTF-8 encoded: re-export it as UTF-8
|-
| Sosa numbers do not appear || No active source: select one in '''DoliGenweb > Sources'''
|}

The Dolibarr log ('''Home - Setup - Other - Logs''') traces imports and calls to external services.

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

=Other languages=

* [[Module_DoliGenweb_FR|Documentation française du module DoliGenweb]]
* [[Module_DoliGenweb_DE|Deutsche Dokumentation für das Modul DoliGenweb]]
* [[Module_DoliGenweb_ES|Documentación en español del módulo DoliGenweb]]
* [[Module_DoliGenweb_IT|Documentazione in italiano del modulo DoliGenweb]]

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

[[fr:Module_DoliGenweb_FR]]
[[de:Module_DoliGenweb_DE]]
[[es:Module_DoliGenweb_ES]]
[[it:Module_DoliGenweb_IT]]

Module DoliGenweb EN - Revision history

Grandoc at 08:47, 21 October 2026

Grandoc: Created page with "=Summary= Category:Add-on modules {{TemplateDocDev}} {{TemplateDocUtil}} =Informations= {{TemplateModuleInfo |modulename=DoliGenweb |editor=File:Logo atoonet.jpg|link=ht..."