=== Genealogical Tree - Family Tree & Ancestry for WordPress ===
Contributors: akdevs, freemius
Tags: family tree, genealogy, ancestry, pedigree, family history
Requires at least: 5.6
Tested up to: 6.8
Requires PHP: 7.4
Stable tag: 2.2.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build interactive family trees, create ancestor profiles, and display your genealogy data beautifully on any WordPress site.

== Description ==

**Genealogical Tree** is the most comprehensive family tree plugin for WordPress. Whether you are a genealogist, a family historian, or simply want to share your family heritage online, this plugin gives you everything you need to build, manage, and display stunning family trees.

= Why Genealogical Tree? =

* **Easy to use** - Add family members through a familiar WordPress interface. No coding required.
* **Interactive trees** - Visitors can drag, zoom, and explore your family tree on any device.
* **Smart root detection** - The plugin automatically identifies the root ancestor of each family group.
* **Shortcode powered** - Embed trees anywhere using simple shortcodes.
* **Translation ready** - Available in 10+ languages including Arabic, French, German, Spanish, and more.
* **Actively maintained** - Regular updates, security patches, and new features since 2019.

= Free Features =

* Display family trees with unlimited members (up to 5 generations of descendants and 2 generations of ancestors)
* Interactive tree with drag, zoom in, and zoom out
* Automatic root member detection
* Set any member as the tree root
* Record family member details using standard genealogical methods
* Track life events: birth, burial, adoption, engagement, marriage, divorce, and more
* Dedicated member profile pages on the frontend
* Family member listing page with all member details
* Store contact information for each member
* Works with any WordPress theme

= Pro Features =

Unlock the full potential of your genealogy project with [Genealogical Tree Pro](https://checkout.freemius.com/mode/dialog/plugin/3592/plan/5774/):

**Import & Export**

* Import GEDCOM (.ged) files from Ancestry, FamilySearch, MyHeritage, and other genealogy software
* Export your family data to GEDCOM format for backup or migration

**Advanced Tree Layouts**

* 7 unique tree layouts with extensive customization options
* Switch between horizontal and vertical orientations
* Display member photos in the tree and on profile pages
* Collapsible tree branches for cleaner navigation
* Pedigree tree view for ancestor-focused display

**Data Management**

* Create unlimited family groups
* Create unlimited family trees per group
* Support for multiple spouses and multiple parents
* Display children grouped by each spouse
* Record multiple birth and death records with different sources
* Track multiple contact details and life events per member
* Manage sibling display order

**Customization & Performance**

* AJAX-powered tree loading for large family trees
* Customize tree colors, borders, fonts, and spacing
* Google Fonts integration
* Collaboration tools for multiple contributors to build the family tree together

= Use Cases =

* **Personal genealogy** - Document and share your family history with relatives
* **Church & community records** - Maintain genealogical records for congregations or communities
* **Historical societies** - Publish family trees for public research
* **Heritage websites** - Create a dedicated ancestry website with interactive trees
* **Educational projects** - Teach genealogy and family history concepts

== Installation ==

1. Go to **Plugins > Add New** in your WordPress dashboard
2. Search for **Genealogical Tree**
3. Click **Install Now**, then **Activate**
4. Navigate to **Jeeon Tree > Add New** to start adding family members
5. Use the shortcode `[tree id="X"]` to display your family tree on any page

For detailed setup instructions, visit the [documentation](https://zqe.io/docs/genealogical-tree-documentation/).

== Frequently Asked Questions ==

= How do I create my first family tree? =

After activating the plugin, go to **Jeeon Tree > Add New** to create your first family member. Add parents, spouses, and children through the member editor. The plugin will automatically build the tree structure. Then use the `[tree]` shortcode on any page to display it.

= Can I import data from other genealogy software? =

Yes! The Pro version supports GEDCOM (.ged) file import, which is the standard format used by Ancestry, FamilySearch, MyHeritage, Gramps, and virtually all genealogy software.

= How many family members can I add? =

There is no limit on the number of family members. The free version displays up to 5 generations of descendants and 2 generations of ancestors. The Pro version removes these display limitations.

= Does it work with my theme? =

Genealogical Tree is designed to work with any properly coded WordPress theme. The tree display uses its own styling and will not conflict with your theme.

= Can multiple people contribute to the family tree? =

Yes! The Pro version includes collaboration features that allow multiple users to contribute to building the family tree.

= Is the plugin translatable? =

Yes. The plugin is fully translatable and already includes translations for Arabic, German, Spanish, Persian, French, Italian, Dutch, Portuguese, Russian, and Turkish.

== Screenshots ==

1. Tree Style 1 - Clean tree layout without member images
2. Tree Style 1 - Tree layout with member photos
3. Tree Style 1 - Horizontal orientation with images (Pro)
4. Tree Style 2 - Alternative layout with image support (Pro)
5. Tree Style 3 - Compact layout with customization (Pro)
6. Automatic root detection - Family roots identified automatically
7. Tree management - Admin interface for managing trees
8. Member profile - Individual member page on the frontend
9. Members directory - All family members listed on one page
10. Member editor - Admin area for editing member details
11. Multiple records - Birth, death, contact, and event records (Pro)
12. Shortcode management - Easy shortcode generation for each family group
13. Auto-generated pages - Pages created automatically with shortcodes
14. GEDCOM import - Import interface for .ged files (Pro)
15. Import success - Confirmation after successful GEDCOM import (Pro)

== Links ==

* [Live Demo](https://demo.zqe.io/genealogical-tree/)
* [Documentation](https://zqe.io/docs/genealogical-tree-documentation/)
* [Get Pro Version](https://checkout.freemius.com/mode/dialog/plugin/3592/plan/5774/)
* [GitHub Repository](https://github.com/akdevsfr/genealogical-tree)
* [Support Forum](https://wordpress.org/support/plugin/genealogical-tree/)

== Translations ==

Genealogical Tree is available in the following languages:

* Arabic (ar) / العربية
* German (de_DE) / Deutsch
* Spanish (es_ES) / Espanol
* Persian (fa_IR) / فارسی
* French (fr_FR) / Francais
* Italian (it_IT) / Italiano
* Dutch (nl_NL) / Nederlands
* Portuguese (pt_BR) / Portugues do Brasil
* Russian (ru_RU) / Русский
* Turkish (tr_TR) / Turkce

Want to help translate? Contribute via [translate.wordpress.org](https://translate.wordpress.org/projects/wp-plugins/genealogical-tree/).

== Changelog ==

= 2.2.8 - 14 April 2026 =
* Maintenance - Updated Freemius SDK
* Maintenance - Code formatting fixes

= 2.2.7 - 24 March 2026 =
* Security - Fixed reflected XSS vulnerability via root parameter (CVE-2025-58023)
* Security - Added proper output escaping in tree display HTML attributes
* Maintenance - Tested compatibility with WordPress 6.8

= 2.2.6 - 12 February 2025 =
* Maintenance - Freemius SDK update
* Bug fix - General stability improvements

= 2.2.5 - 28 January 2025 =
* Maintenance - Freemius SDK update
* Bug fix - General stability improvements

= 2.2.3 - 18 March 2024 =
* Maintenance - Freemius SDK update
* New - Addon support

= 2.2.0.5 - 18 December 2022 =
* Bug fix - Fixed AJAX family and spouse loading issue
* Note - This update may affect genealogy data if upgrading from a version before 2.1.9. Please back up your data before updating.

= 2.2.0.4 - 9 December 2022 =
* Bug fix - Fixed default tree settings on tree settings pages

= 2.2.0.3 - 6 December 2022 =
* Bug fix - General fixes
* Maintenance - Updated Freemius SDK to 2.5.3

= 2.2.0.2 - 4 December 2022 =
* Bug fix - Fixed broken family tree display after update

= 2.2.0.1 - 29 November 2022 =
* Bug fix - General fixes

= 2.2.0 - 29 November 2022 =
* Major - Core architecture rewrite
* Bug fix - Multiple stability improvements

= 2.1.9 - 29 May 2022 =
* Bug fix - General fixes

= 2.1.8 - 28 May 2022 =
* New features and bug fixes

= 2.1.7 - 8 March 2022 =
* New features and bug fixes

= 2.1.6 - 3 March 2022 =
* New features and bug fixes

= 2.1.5 - 1 February 2022 =
* New features and bug fixes

= 2.1.4 - 21 January 2022 =
* Bug fix

= 2.1.3 - 06 January 2022 =
* New features and bug fixes

= 2.0.0 - 09 June 2021 =
* Major release with new features and bug fixes

= 1.9.0 - 09 January 2021 =
* Bug fix - AJAX loading improvements

[See full changelog on GitHub](https://github.com/akdevsfr/genealogical-tree/releases)

== Upgrade Notice ==

= 2.2.8 =
Updated Freemius SDK and code formatting fixes.

= 2.2.7 =
Security update: Fixes a reflected XSS vulnerability (CVE-2025-58023). All users should update immediately.

= 2.2.6 =
Freemius SDK update and bug fixes.

= 2.2.0 =
Major core rewrite. Please back up your data before updating if you are on a version older than 2.1.9.
