Module DoliGenweb EN: Difference between revisions
(Created page with "=Summary= Category:Add-on modules {{TemplateDocDev}} {{TemplateDocUtil}} =Informations= {{TemplateModuleInfo |modulename=DoliGenweb |editor=File:Logo atoonet.jpg|link=ht...") Tag: 2017 source edit |
No edit summary Tag: 2017 source edit |
||
| Line 16: | Line 16: | ||
=Features= | =Features= | ||
DoliGenweb | 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=== | ===Individual card=== | ||
The individual | 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=== | ===Family trees=== | ||
*Ancestors | *'''Ancestors''', '''descendants''' and '''hourglass''' modes (ancestors above, descendants below). | ||
*'''Boxes''' view or | *'''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 | *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 | *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]] | |||
The ''' | [[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=== | ===GEDCOM import and export=== | ||
*'''Import''': drag and drop of the <code>.ged</code> file, upload in 512 KB chunks | *'''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=== | ===Calendar converter=== | ||
The setup | 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=== | ===Built-in user guide=== | ||
A complete guide in '''French, English, German, Spanish and Italian''' | 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]]'' | ''[[#Summary|⬆ Back to summary]]'' | ||
| Line 109: | Line 179: | ||
{| class="wikitable" | {| class="wikitable" | ||
! Tab !! Content | ! Tab !! Content | ||
Latest revision as of 08:47, 21 October 2026
Summary
Informations
| Module name | DoliGenweb |
| Editor / Editeur |
|
| Download or buy page / Page achat ou téléchargement | External module - www.dolistore.com |
| Status / Statut / Estado | Stable |
| Prerequisites / Prérequis | PHP 7.2 minimum - PHP calendar extension recommended
Dolibarr min version: See on Dolistore Dolibarr max version: See on Dolistore |
| Last update date / Date mise à jour fiche / Fecha última actualización | 2026-10-21 |
| Note / Nota | ⬆ 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).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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
.gedfile, upload in 512 KB chunks, progress bar, resume of an interrupted import and import history. The name pieces (GIVN,SPFX,SURN,NSFX,NPFX,NICK) and the title (TITL) are read; an option splits the particle written in the surname when the file has noSPFXtag (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 (
SOUR,REPO,PAGE,QUAY), witnesses (ASSO,_WITN) and date accuracy (ABT,BEF,AFT,BET,FROM/TO) are exchanged too.
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.
Prerequisites
Dolibarr: supported versions:
- 24.x
PHP: version 7.2 minimum, tested up to PHP 8.5.
PHP extension: calendar 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 upload_max_filesize and post_max_size, or use method 2.
⚙️ Method 2: manual installation on the server
The zip contains a htdocs/doligenweb/ folder; the doligenweb folder must end up in the Dolibarr custom directory.
- Unzip:
unzip module_doligenweb-X.Y.Z.zip -d /tmp/doligenweb_zip - Copy:
cp -r /tmp/doligenweb_zip/htdocs/doligenweb /path/to/dolibarr/htdocs/custom/ - Grant rights to the web server if needed:
chown -R www-data:www-data /path/to/dolibarr/htdocs/custom/doligenweb - Check that the location is
htdocs/custom/doligenweb(nothtdocs/custom/htdocs/doligenweb). - Enable the module from Dolibarr.
Setup
Access: Home > Setup > Modules/Applications, DoliGenweb settings icon.
| Tab | Content |
|---|
