Install
This is the repository archive. It installs, but the folder name will carry the branch suffix and updates will not flow.
Install straight from GitHub with WP-CLI:
wp plugin install https://github.com/janfichter/gf3/archive/refs/heads/main.zipContributors: Jan Fichter Developer URL: https://xn----8sbbdpda1c7cwf.xn--p1ai/product-category/genius-family-tree/ Tags: family, tree, genealogy, gedcom Requires at least: 5.0 Tested up to: 7.0 Stable tag: 1.4.3 License: GPLv2 or later License URI: http://www.gnu.org/licenses/gpl-2.0.html
Plugin for creating and displaying interactive family trees on a WordPress site with GEDCOM support, root elements, and advanced navigation.
Description
Genius Family Tree is a powerful tool for creating and visualizing family trees. Version 1.4.3 includes many improvements and new features.
🚀 Key features:
- Interactive tree — create beautiful, scalable family trees using the D3.js library.
- Flexible card design — configure colors, backgrounds, and fonts for cards, card names, and dates; set custom photo placeholders for men and women.
- Multiple family groups — create multiple independent trees by assigning each family member to their own group (shortcode
[family_tree group="ID"]). - Tree root element — you can specify which family member the main tree should be built from (star icon in the members list).
- Navigate from a specific person — each person's page has a "Show in tree" button that builds the tree starting from that person (URL parameters
person_idorcenter_on). - GEDCOM import/export — full support for GEDCOM 5.5.1 format with photos and root element preservation.
- Surname catalog — convenient surname navigation with an alphabetical index (shortcode
[family_surname_catalog]). - Enhanced admin — modern dashboard, columns with portraits, lifespan dates, and root element indicators.
🎯 New features in version 1.4.3:
- Tree toolbar — a toolbar with icons in the lower-right corner of the interactive tree
- Share — share the tree page via VK, Telegram, Odnoklassniki, WhatsApp, Twitter / X, or copy the link
- Zoom controls — plus/minus buttons to increase and decrease the tree scale
- Expand / collapse — fit the tree to the full content width or collapse back to the root person
- Save as image — download the selected tree fragment as a PNG with the plugin logo and site URL watermark
- Disable mouse-wheel zoom — option to zoom only via the toolbar buttons
- Toolbar customization — choose its position and colors of the buttons and icons (including hover)
- Redesigned admin dashboard — plugin logo, description, quick links, and expanded tips of the day
Changelog
1.4.3
- NEW: Toolbar in the lower-right corner of the interactive tree
- NEW: Share button with a dropdown (VK, Telegram, Odnoklassniki, WhatsApp, Twitter / X, copy link)
- NEW: Zoom in/out plus and minus buttons
- NEW: Expand to full content / collapse to the root person toggle button
- NEW: Camera button — save the selected tree fragment as a PNG image with the plugin logo and site URL at the top
- NEW: Option to disable mouse-wheel zoom on the tree
- NEW: Toolbar settings section — configure toolbar position (four corners), button background color, button background on hover, icon color, and icon color on hover
- NEW: Redesigned admin dashboard — plugin logo at the top, plugin description, quick action links, and an expanded "Tip of the day" covering tree, person, catalog, and toolbar customization
1.4.2
- NEW: Restructured "Catalog" settings tab — settings grouped into container, alphabet, and surname sections; letter color settings moved to the alphabet section
- NEW: New option for the inactive alphabet letters background
- NEW: Restructured "Tree Display" settings tab — settings grouped into container and card sections
- NEW: Font settings for card names and dates in the interactive tree (font family, size, and weight)
- NEW: Custom placeholder images for male and female card avatars (JPG, PNG, SVG; square; up to 300×300 px) with a media uploader
- NEW: Default font sizes for all settings tabs (person header, sidebar, and tree cards) are now applied automatically
- IMPROVED: The person page icon in tree cards is anchored to the top-right corner and no longer moves when the card width is changed
- IMPROVED: The portrait in tree cards is now vertically centered within the card
1.4.1
- NEW: Multiple family groups support — each tree can now be in its own group
- NEW: Fully redesigned dashboard in the "Family Tree" section with section tiles, status block, and setup wizard
- NEW: Quick person search on the dashboard
- NEW: Dynamic root element sidebar showing the current root of the selected group
- NEW: Display of ungrouped members list in notifications
- IMPROVED: Correct counting of groups and members (revisions and system posts excluded)
- IMPROVED: Accounting for deleted groups when detecting ungrouped members
- IMPROVED: Modern settings page interface with card layout
- IMPROVED: Unified style for all admin and frontend elements
- FIXED: Settings page headings are now displayed correctly
- FIXED: Plugin version is now displayed in the admin panel
1.3.4
- NEW: Ability to set a global tree root element (star icon in the members list)
- NEW: Meta box for selecting the root element when editing a person
- NEW: Support for
person_idandcenter_onURL parameters for building a tree from a specific person - NEW: "Tree Root" column in the admin panel with visual indicator
- IMPROVED: GEDCOM import automatically restores the root element from the
_ROOT Ytag - IMPROVED: GEDCOM export preserves root element information
- IMPROVED: Tree building priorities: URL > global root > data attribute
- FIXED: Conflict between data-root-id and global root when building the tree
- FIXED: Errors when passing root_member_id to JavaScript
1.3.3
- NEW: Meta box for selecting the tree root element
- NEW: "Tree Root" column in the members list
- IMPROVED: GEDCOM export now includes root element information
- IMPROVED: GEDCOM import automatically restores the root element
1.3.2
- IMPROVED: Improved photo handling during GEDCOM import
- FIXED: Minor bugs in the GEDCOM parser
1.3.1
- IMPROVED: Support for more image formats during GEDCOM import
- ADDED: Error logging during image import
1.3.0
- NEW: "Portrait" and "Lifespan" columns in the admin panel
- IMPROVED: Visual display of members in the list
1.2.3
- NEW: Ability to show a selected person in the family tree via a button on the person's individual page
- IMPROVED: Support for the
center_onURL parameter
1.2.2
- Improved: Shortcode now supports [family_tree root="10" center_on="15"]
- Improved: Bidirectional sync between parents and children
- Improved: Interactive tree performance
1.2.1
- Fixed: Heartbeat API disabled on the plugin settings page
- Improved: Increased stability
1.2.0
- Added: GEDCOM export
- Added: GEDCOM import
- Added: Surname catalog with alphabetical navigation
1.1.0
- Added: Licensing support
- Added: Limit of 50 members in the free version
1.0.0
- Initial release
Requirements
- WordPress 5.0 or higher
- PHP 7.0 or higher
- MySQL 5.6 or higher
- For Pro version: active license
Installation
Installation via WordPress admin
- Download the plugin (.zip archive).
- Log into your WordPress admin (your-site.com/wp-admin).
- Go to "Plugins" → "Add New".
- Click the "Upload Plugin" button (at the top of the page).
- Select the downloaded .zip archive and click "Install".
- After installation, click "Activate Plugin".
Manual installation via FTP
- Extract the plugin archive.
- Connect to your server via FTP.
- Go to the
/wp-content/plugins/folder. - Upload the
genius-family-treefolder to the server. - Go to WordPress admin → "Plugins".
- Find "Genius Family Tree" in the list and click "Activate".
Configuration
Basic settings
- After activating the plugin, a new "Family Tree" item will appear in the menu.
- Click "Family Tree" → "Settings" to access the plugin settings.
- Here you can enter your license key and manage GEDCOM features.
Setting the root element
Method 1 (automatic during import):
- When exporting GEDCOM, the root element is automatically marked with the
_ROOT Ytag. - When importing this file, the root element is automatically restored.
Method 2 (manual):
- Go to "Family Tree" → "All Family Members"
- Find the desired person and click "Edit"
- In the right column, find the "Family Group" meta box
- Select a group, then check the "Make this the root element" checkbox
- Save the post
Method 3 (quick edit):
- In the members list, hover over the desired entry
- Click "Quick Edit"
- Check the "Make this the tree root element" checkbox
- Click "Update"
Shortcodes
Main tree: [family_tree]
Displays an interactive tree from the global root element.
Tree from a specific person: [family_tree root="123"]
Builds a tree from the person with ID 123.
With focus on a person: [family_tree root="123" center_on="456"]
Builds a tree from person 123, but centers on person 456.
Surname catalog: [family_surname_catalog]
Displays an alphabetical catalog of all surnames with links to members.
License activation (Pro version)
- Purchase a license key on the official website.
- Go to "Family Tree" → "Settings".
- Enter the key in the "License Key" field.
- Click "Save Settings".
- After activation, GEDCOM features become available and the 50-member limit is removed.
Frequently Asked Questions
How does the root element system work?
The plugin uses a smart priority system:
- Highest priority: URL parameters (
?person_id=123or?center_on=123) — when navigating from a person's page - Medium priority: Global root from settings — default value for the main tree
- Lowest priority: Data attribute
data-root-id— for backward compatibility
How to navigate to the tree from a specific person?
Method 1: On the person's page, click the "Show in tree" button.
Method 2: Add the parameter ?person_id=123 to the tree page URL (where 123 is the person's ID).
Method 3: Use the ?center_on=123 parameter (for old links).
How to find a person's ID?
The person's ID is displayed in the admin panel in the list of all family members (column "ID") or in the URL when editing the person (e.g., post=123).
What data is saved in GEDCOM?
When exporting, the following are saved:
- All personal data (name, surname, dates, places)
- Family relationships (parents, children, spouses)
- Root element (
_ROOT Ytag) - Photos (URL and local path)
- Notes
Are there any recommendations for filling out data?
- Start with the oldest generation — this will help build relationships correctly.
- Fill in required fields — name, surname, gender.
- Use search when adding relationships — in the father/mother/spouse fields, start typing a name and the system will suggest options.
- Set the root element — this will determine who the main tree is built from.
What are the limitations of the free version?
- Maximum of 50 members
- No GEDCOM export
- No GEDCOM import
- No automatic root element restoration on import
How to remove limitations?
- Purchase a license key on the official website.
- Enter the key in the plugin settings.
- Activate the Pro version.
What to do if the tree is not displayed?
- Check if family members have been added.
- Make sure the
[family_tree]shortcode has been added to a page. - Check if a root element is set (there should be a star icon in the members list).
- Open the browser console (F12 → Console) and check for errors.
- Make sure scripts are not blocked (e.g., by AdBlock).
What to do if the root element is not saved during import?
Make sure that:
- The exported GEDCOM file has the
_ROOT Ytag for the desired person. - You are using the Pro version of the plugin (this feature is only available in the paid version).
- There are no errors in the logs during import.
What to do if the ?center_on=123 link does not work?
Check:
- That a person with that ID exists.
- That this person has relationships (parents/children/spouses).
- Open the browser console — there should be a message
🎯 Using ID from URL (center_on): 123
What to do if errors occur when adding persons?
- Check if the 50-person limit has been reached (in the free version).
- Make sure required fields are filled out (name, surname, gender).
- Check the WordPress error logs (file
/wp-content/debug.log).
What to do if there are problems with the plugin?
Check system requirements:
- WordPress 5.0+
- PHP 7.0+
- MySQL 5.6+
Collect information for support:
- WordPress version
- PHP version
- Plugin version
- Problem description
- Error screenshots (if any)
- Browser console (F12 → Console)
IMPORTANT! Priority technical support is provided to holders of PRO versions of the plugin.
How to update the plugin?
- Create a backup of your site (database + files).
- Deactivate the current version of the plugin.
- Delete the plugin (data will be preserved in the database).
- Install the new version.
- Activate the plugin.
- Check settings and data.
⚠️ Important: Always create a backup of your site before updating plugins!