My Custom Tags

A weebtrees 2.1/2.2 custom module to provide custom tags, custom types, custom relationship descriptors, and custom roles in events.

What are the benefits of this module?

• Provide additional GEDCOM custom tags to be used in webtrees
• Provde additional custom types for certain GEDCOM tags:
  • Confirmation (INDI:CONF:TYPE)
  • Education (INDI:EDUC:TYPE)
  • Events (INDI:EVEN:TYPE)
  • Facts (INDI:FACT:TYPE)
  • Graduation (INDI:GRAD:TYPE)
  • Additional custom types for names (INDI:NAME:TYPE)
  • Ordination (INDI:ORDN:TYPE)
• Provide additional custom descriptors for relationships (FAM:_ASSO:RELA, FAM:*:_ASSO:RELA, INDI:ASSO:RELA, INDI:*:_ASSO:RELA)
• Provide additional custom roles in events (*:*:EVEN:ROLE)

Installation

• Download the latest code of the module
• Unzip and copy the folder "my_custom_tags" into the "module_v4" folder of your webtrees installation
• Please note that the provided module code only provides a template as a starting point for your own customization/configuration. The provided template contains an example with a configuration used by the author
• Since the module code is just a template for your own customization, it it not planned to provide any releases

Configuration

• Add/remove GEDCOM custom tags
  • Modifiy the function customTags() in MyCustomTags.php and the function customSubTags() in MyCustomTags.php , //Additonal custom tags
  • As reference how custom tags are defined in webtrees, you can have a look at the code in webtreesTags() in Gedcom.php and webtreesSubTags() in Gedcom.php
• Add/remove types to be used
  • Modifiy the function customTags() in MyCustomTags.php, //Additional types
• Add/remove type definitons
  • Modifiy the function values() in xxxType.php (e.g. EventType.php), //Value in GEDCOM => Value shown in webtrees frontend
• Add/remove additional custom descriptors for relationships
  • Modifiy the function values() in ExtendedRelationIsDescriptor.php, //Value in GEDCOM => Value shown in webtrees frontend
• Add/remove additional custom descriptors for relationships
  • Modifiy the function values() in ExtendedRoleInEvent.php, //Value in GEDCOM => Value shown in webtrees frontend

Webtrees version

The latest release of the module was developed and tested with webtrees 2.1.21 and 2.2.0, but should also run with any other webtrees 2.1/2.2 version.

Translation

The translation is based on gettext and uses .po files, which can be found in /resources/lang/. You can use a local editor like Poedit or notepad++ to add or modify translations.

Currently, the following languages are already available:

• Dutch
• English
• German

If you want to translate custom tags, types, relationship descriptors, or roles in events, you can also add further translations to the code.

Example for translation of types etc.

You can add translation to a fact type in FactType.php with the following modification in the code:

• 'Military Service' => I18N::translate('Military Service'),

Afterwards, the translation has to be provided by a .po file, see above.

License

• GNU General Public License, Version 3
• webtrees
  • webtrees: online genealogy
  • Copyright (C) 2024 webtrees development team
• My Custom Tags (webtrees custom module)
  • Copyright (C) 2024 Jefferson49

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

Github repository

https://github.com/Jefferson49/MyCustomTags