=== AP Family Trees ===
Contributors: ancestorpress
Tags: family tree, genealogy, GEDCOM, ancestors, pedigree chart
Requires at least: 6.0
Tested up to: 6.8
Requires PHP: 8.0
Stable tag: 1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Publish beautiful, interactive family trees on WordPress. Import GEDCOM files, display multiple chart types, and share your family history online.

== Description ==

**AP Family Trees** is a new, versatile genealogy plugin built for family historians, authors, publishers and institutions who want to publish genealogical research on their WordPress websites. Import from GEDCOM, display interactive charts, and give every ancestor their own profile page.  Insert family member profile 'cards' into other blog content to create lovely 'pull outs' linking to profile pages. The plugin includes multiple ways to access and display family history content and links on your site so you can integrate your genealogical information seamlessly - whether as a full page family tree chart or a small profile linking box on longer text articles.  All within WordPress and without sending your data to a third-party service.

Built by [AncestorPress](https://ancestorpress.com) - tools for family history, built to last.

---

### What You Can Do With the Free Version

- **Import GEDCOM files** from any genealogy application (Family Tree Maker, Gramps, MacFamilyTree, Ancestry, and all standard GEDCOM 5.5 exporters)
- **Display a Descendant Vertical chart** - the classic top-down family tree, pan and zoom enabled
- **Unlimited family members** in a single lineage
- **Living person privacy controls** - suppress details for individuals flagged as living in your GEDCOM data or marked as living in the plugin
- **Configurable chart boxes** - show or hide photos, dates, spouses, and gender indicators; set name and date formats
- **Gender colour indicators** - customisable male/female colours in chart boxes
- **Click any person to re-root the chart** - visitors can make any ancestor or descendant the new starting point
- **Embed on any page** via shortcode or Gutenberg block

---

### Pro

Unlock the full publishing toolkit:

- **Unlimited lineages** - manage separate family histories or multiple GEDCOM files side by side
- **Ancestor Horizontal chart** - the industry-standard pedigree view, left to right
- **Full profile pages** for every person - photo, dates, relationships, notes, and custom fields, embeddable via shortcode or block
- **Compact profile cards** - inline photo, name, and dates card embeddable in any post or page
- **Photo gallery on profiles**
- **GEDCOM notes** displayed on profile pages
- **Custom fields** - unlimited per lineage (text, date, URL, select)
- **Member search** via shortcode or Gutenberg block
- **GEDCOM export** - take your data back at any time
- **Person box links to profile page** - click a name in the chart to open their full profile
- **Chart edit controls** - add and remove people directly from the chart
- **Generations control** - floating panel lets visitors adjust how many generations are shown

---

### Pro Plus

The complete set, including every chart type and export format:

Everything in Pro, plus:

- **Descendant Horizontal chart**
- **Ancestor Vertical chart** - youngest at the bottom, ancestors ascending
- **Descendant Compact Text chart**
- **Hourglass chart** - ancestors and descendants of one person in a single view; ancestors branch left, the person is in the centre, descendants branch right
- **Custom chart colours** - full control over boxes, borders, connectors, name text, and date text
- **PDF export** - print or save the chart directly from the viewer
- **SVG export** - download as a scalable vector file for print or design use
- **Member directory** - sortable by surname, first name, or birth date

---

> All plans use the same plugin. Upgrade at any time by entering a licence key - no reinstall required. Multi-site licensing available on request.

---

= Sample Trees =

Here are some live tree chart examples.

* [Chart A1 Descendant Vertical - Free](https://www.ancestorpress.com/family-trees/default-descendant-family-tree-example/)
* [Chart A2 Descendant Horizontal - Pro Plus](https://www.ancestorpress.com/family-trees/horizontal-descendent-chart-example/)
* [Chart B1 Ancestor Vertical - Pro Plus](https://www.ancestorpress.com/family-trees/default-pedigree-chart/)
* [Chart B2 Ancestor Horizontal - Pro](https://www.ancestorpress.com/family-trees/ancestor-horizontal-chart/)
* [Chart C1 Descendants Compact Text - Pro Plus](https://www.ancestorpress.com/family-trees/descendents-compact-text-chart/)
* [Chart E Hourglass - Pro Plus](https://www.ancestorpress.com/family-trees/hourglass-chart/)
* [Family Index directory example - Pro](https://www.ancestorpress.com/family-index-pages/)
* [Profile block and shortcode cards - Pro](https://www.ancestorpress.com/family-trees/profile-blocks-shortcodes/)




### Who It Is For

AP Family Trees is designed for:

- **Family history researchers** who want to publish their tree online as part of a WordPress site or blog
- **Genealogy societies and archives** that need to present lineage data in a structured, professional format
- **Historians and heritage organisations** building public-facing ancestor resources
- **Anyone who has been using desktop genealogy software** and wants to move their data onto their own website

### What Makes It Different

Most genealogy plugins are either too simple (a basic chart widget with no data management) or too complex (requiring server configuration and database imports). AP Family Trees sits in the middle: a proper data-driven plugin that stores your family data cleanly in WordPress, imports from the standard GEDCOM format used by every major genealogy application, and renders interactive, publication-quality charts and profile pages.

Your data stays on your server. There are no third-party accounts to set up and no monthly subscription to a genealogy platform.

---

= Third-party libraries =

This plugin bundles the following open-source libraries. All are GPL-compatible.

* [php-gedcom](https://github.com/mrkrstphr/php-gedcom) by Kristopher Wilson - MIT licence. Used for parsing GEDCOM files on import.
* [Panzoom](https://github.com/timmywil/panzoom) by Timmy Willison - MIT licence. Used for interactive pan and zoom on family tree charts.
* [Select2](https://select2.org/) by Kevin Brown, Igor Vaynberg, and contributors - MIT licence. Used for searchable dropdowns in the admin interface.
* [Freemius WordPress SDK](https://github.com/Freemius/wordpress-sdk) by Freemius - MIT licence. Used for licence management on Pro and Pro Plus plans.

= Privacy and data =

This plugin does not collect or transmit any personal data from your site or your visitors. All family tree data is stored exclusively in your own WordPress database.

If you activate a paid Pro or Pro Plus licence, the Freemius SDK is used to validate and manage that licence. Freemius may collect basic site and usage data as part of licence activation. This is subject to the [Freemius Privacy Policy](https://freemius.com/privacy/). No licence activation is required to use the free plan.

== Installation ==

1. Upload the plugin files to `/wp-content/plugins/ap-family-trees`, or install the plugin directly from the WordPress plugin repository under **Plugins > Add New**.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Go to **AP Family Trees > Lineages** and click **Create Lineage** to start adding members manually, or go to **AP Family Trees > Import** to create a lineage from a GEDCOM file exported from any genealogy application.
4. Once your lineage has members, go to **AP Family Trees > Charts**, create a chart, and note the chart ID.
5. Use the shortcode `[APFTChart id="1"]` or the **AP Family Trees Chart** Gutenberg block to display your tree on any page or post. Replace `1` with the chart ID shown in AP Family Trees > Charts.

For full documentation, visit [ancestorpress.com](https://ancestorpress.com).

== Frequently Asked Questions ==

= Does it work with GEDCOM files from Ancestry, Family Tree Maker, MacFamilyTree, or Gramps? =

Yes. AP Family Trees imports standard GEDCOM 5.5 files, which is the export format used by all major genealogy applications including Ancestry.com, Family Tree Maker, MacFamilyTree, Gramps, RootsMagic, and Legacy Family Tree.

= Is my family data stored on my own server? =

Yes. All family tree data is stored in your WordPress database and never leaves your server. If you activate a paid Pro or Pro Plus licence, the Freemius SDK is used for licence validation and may collect basic site data as part of that process — see the Privacy and data section above for details. No data is collected on the free plan.

= Can I have more than one family tree? =

The free version supports one family lineage. Pro and Pro Plus support unlimited family lineages, so you can manage separate lineages or multiple GEDCOM imports side by side.

= How do I upgrade from Free to Pro or Pro Plus? =

Purchase a licence from within the plugin - simply go to the Upgrade tab in the plugin sidebar and follow the instructions. No reinstall is required - Pro features unlock immediately.

= Does it handle living persons correctly? =

Yes. Living person privacy controls are included in all versions. Details for individuals flagged as living in your GEDCOM (or marked as living in the plugin) are suppressed on the front end.

= Can visitors interact with the chart? =

All versions include pan, zoom, full screen, and the ability to click any person to re-root the chart. Pro adds a generations control panel so visitors can adjust how many generations are displayed.

= Is it compatible with the Gutenberg block editor? =

Yes. The chart and profile page embeds are available as Gutenberg blocks as well as classic shortcodes.

= Does it work with my theme? =

AP Family Trees outputs standard WordPress HTML and loads its own styles only for the chart and profile components. It is designed to sit cleanly within any well-coded theme. If you encounter a conflict, please raise a support ticket.

= Can I export my data? =

Yes. GEDCOM export is included in Pro and Pro Plus, so you can take your data back to any genealogy application at any time.

== Screenshots ==

1. The Descendant Vertical chart with pan, zoom, and full screen controls (top right hamburger menu)- the default view available on all plans.  Pro plans add extra elements such as images.
2. The Descendant Vertical chart showing clickable icons opening person profile pages or changing the tree root person to focus on different ancestors.
3. The Descendant Vertical chart showing all options enabled (required Pro).
4. The Ancestor Horizontal (pedigree) chart - the industry-standard left-to-right ancestor view, available on Pro and above.  Minimal options enabled and showing only three generations in this example.
5. A full person profile page showing photo, vital dates, relationships, notes, and custom fields (Pro).
6. The GEDCOM import screen - upload and map your file from any genealogy application.
7. Chart box configuration - varies depending on licence.  Control which fields, photos, and colours appear in the chart boxes.
8. The plugin lineages overview - multiple lineages available in the Pro version.
9. Manually add family members in the Add Member screen - additional field options appear on saving.

== Changelog ==

= 1.0 =
* Initial public release.

== Upgrade Notice ==

= 1.0 =
Initial public release.
