Module Doligenweb EN

Information

Module name Doligenweb
Editor / Editeur Atoo.Net - https://www.atoo-net.com
Download or buy page / Page achat ou téléchargement External module - www.dolistore.com
Status / Statut / Estado Stable
Prerequisites / Prérequis

Dolibarr min version: See on Dolistore    Dolibarr max version: See on Dolistore

Last update date / Date mise à jour fiche / Fecha última actualización 2026-04-17
Note / Nota

Installation

  1. Download the module and place it in the directory htdocs/custom/doligenweb/
  2. From Dolibarr: Home → Setup → Modules/Applications
  3. Find the DoliGenweb module in the Atoo-Net section and activate it
  4. Permissions must be configured per user group (see Rights and permissions)

Module configuration

Access the configuration via Home → Setup → Modules/Applications → DoliGenweb (wrench icon) or directly through the administration menu.

The configuration page has seven tabs.

Tab "Parameters"

This tab contains the general options for the module: default country for historical events, tree display options, import behaviour, etc.

Tab "FamilyExtraFields"

Allows you to define extra attributes (custom fields) associated with Family records. These fields will be available when creating or editing a family.

Tab "IndividualExtraFields"

Allows you to define extra attributes associated with Individual records. These fields extend genealogical data beyond standard GEDCOM fields.

Tab "PlaceExtraFields"

Allows you to define extra attributes associated with Place records. Useful for storing additional geographical or administrative information.

Tab "Import GEDCOM"

This tab allows you to import a genealogical file in the standard .ged (GEDCOM) format.

Import procedure

  1. Drag and drop the .ged file into the designated area, or click the area to browse for files
  2. The selected file is displayed with its name and size (e.g. doligenweb_export_2026-04-13.ged — 629 KB) along with a Done badge once uploaded
  3. The import runs in two steps shown by progress bars:
    • File upload: upload progress to the server (shown in blocks, e.g. 2/2 blocks — 100%)
    • Individuals import: line-by-line processing (e.g. 3627/3627 individuals — 99%)
  4. A scrolling log displays each processed individual in real time with their GEDCOM identifier and rank (e.g. ✓ WALTERS Michael (@I3612@) — 3612/3627)

Template:Note

Import history

The Import history section at the bottom of the page lists previous imports with their date and status.

Tab "Export GEDCOM"

Allows you to export all genealogical data (individuals, families, places) in the standard GEDCOM .ged format, compatible with most genealogy software.

Tab "About"

Displays information about the module version, the author and a link to the documentation.


DoliGenweb Dashboard

Accessible from the DoliGenweb menu in Dolibarr, the dashboard provides a summary view of the genealogical database:

Block Information displayed
INDIVIDUALS Total · Draft · Validated — with quick creation button
FAMILIES Total · Draft · Validated — with quick creation button
PLACES Total · Draft · Validated — with quick creation button

The dashboard also displays the 3 last modified records for each of the three entities (individuals, families, places), with their identifier, label and timestamp of the last modification.


Managing individuals

Individual record

The individual record brings together all the genealogical information for a person.

General information

Field Description
Third party Link to the corresponding Dolibarr third party (optional)
Description Free text field
Last name Family name (displayed in uppercase)
First name First name(s)
Gender Male / Female
Occupation Job or occupation of the individual

Sosa number

Individuals who are part of the main tree display a coloured badge showing their Sosa number and generation (e.g. Sosa 8 (G4)). This number identifies the ancestor's position in the Sosa-Stradonitz numbering system.

Linked family

The Linked family section shows the family or families to which the individual belongs as a spouse, with a link to the family record and the marriage details (date and place).

Spouse, Parents, Children

Three distinct sections display the family relationships:

  • Spouse: link to the spouse individual with their life dates
  • Parents: Father and Mother with their dates and Sosa numbers if applicable
  • Children: list of children with their life dates and Sosa numbers

Each relationship has edit and delete icons.

Life events

A table lists the biographical events of the individual:

Column Content
Event type Birth, Baptism, Death, Marriage, etc.
Event date Date in DD/MM/YYYY format
Date precision Precision indicator (circa, before, after…)
Place Location of the event (city, county, region, country)
Label Associated note or source

Action buttons

At the bottom of the record, the buttons allow:

Button Action
SEND EMAIL Send an email to the individual (if a third party with an email is linked)
SET TO DRAFT Revert the record to draft status
EDIT Open the edit form
CREATE SOURCE Create a documentary source linked to this individual
NEW LIFE EVENT Add a biographical event
CREATE FATHER Create and link an individual as father
CREATE MOTHER Create and link an individual as mother
CREATE CHILD Create and link an individual as child
CREATE SPOUSE Create and link an individual as spouse
DELETE Permanently delete the record

Individual record tabs

The individual record has several tabs:

Tab Content
Individuals General information, family, life events (default tab)
Trees Graphical visualisation of the genealogical tree
Notes Free text notes associated with the individual
Attached files Documents, images or digitised sources
Historical events Historical context contemporary with the individual's life

Genealogical trees

The Trees tab provides an interactive graphical visualisation of the individual's genealogy.

Display options

Option Available values Description
Mode Ancestry · Descendants Displays the ancestors or descendants of the individual
Tree view Boxes · Ancestry wheel Type of graphical representation
Generations 3 to 7 generations Depth of the displayed tree
Place displayed Place of birth · Place of marriage · Place of death · Hide places Geographical information shown in each box

"Boxes" view

Each individual is represented in a coloured box showing:

  • The Sosa number
  • The last name and first name
  • The birth and death years
  • The occupation (if filled in)
  • The place (according to the selected option), displayed in a coloured banner at the top of the box

Boxes are colour-coded by place of origin (each city/region receives a distinct colour), with an interactive legend at the top of the tree allowing filtering by place (click on a place to show/hide the corresponding individuals).

Clicking the button in a box navigates to that individual's record.

"Ancestry wheel" view

The ancestry wheel represents the tree as a concentric semicircle:

  • The reference individual is at the centre
  • Each arc represents an ancestor with their name and dates
  • The colours follow the same place-based colour code as the box view
  • A PDF button allows exporting the wheel as a PDF document

Historical events

The Historical events tab contextualises an individual's life by displaying world events that occurred during their lifetime.

How it works

The page automatically displays historical events corresponding to the individual's years of life (from birth to death), for the selected country.

The Country filter (e.g. Switzerland) allows targeting events from a specific territory.

Two information columns

Column Description
Heads of State Chronological list of the country's leaders during the individual's lifetime, with their biography and the years of their tenure
Historical events Dated list of notable events (wars, treaties, disasters, exhibitions…) with description

Each event has edit and delete icons for authorised users.

Update buttons

Button Action
REFRESH EVENTS Updates the list of historical events from the data source
REFRESH LEADERS Updates the list of heads of state from the data source (Wikidata)

Template:Note


Rights and permissions

The module defines permission levels to be assigned per user group in Setup → Groups and users:

Right Description Effect
Read View genealogical records Allows access to lists and records of individuals, families and places
Create / Modify Create and edit records Allows adding individuals, families, places and events
Delete Delete records Allows deleting individuals, families or places
Import Run a GEDCOM import Allows access to the Import GEDCOM tab and importing files
Export Run a GEDCOM export Allows exporting the database in GEDCOM format

Template:Note


FAQ

The GEDCOM import stops before completion
Check the PHP limits on the server (max_execution_time, memory_limit, post_max_size, upload_max_filesize). For large files (> 500 KB), increase these values in php.ini or .htaccess.
Some individuals display "X" during import
These individuals have no name in the source GEDCOM file. They are still imported and can be completed manually after the import.
Historical events are not displayed
Click REFRESH EVENTS and REFRESH LEADERS. Check that the Dolibarr server has Internet access and that the selected country is correctly configured. Some countries or periods before 1848 may not have data available in Wikidata.
The genealogical tree is empty
The individual does not yet have any linked parents or children. Use the CREATE FATHER, CREATE MOTHER, CREATE CHILD buttons on the individual record to build the tree.
The Sosa number does not appear on an individual
The Sosa number is calculated relative to the root individual of the main tree. If the individual is not attached to the main tree, no Sosa number is assigned to them.
The ancestry wheel PDF is blank or incorrectly formatted
Check that the PDF library is correctly installed and configured in Dolibarr (Home → Setup → PDF).
Extra fields do not appear in records
Extra attributes must be defined in the IndividualExtraFields, FamilyExtraFields or PlaceExtraFields tabs of the module configuration.

See also