WP Family Tree Renewed – Documentation

 

If you are moving from the old WP Family Tree plugin, please see below for specific steps to upgrade to this plugin with ease.

 

Prerequisite

This plugin requires PHP version 7.0 or greater. You can check what version of PHP you have by going to the Site Health Info page in your WordPress admin. Go to your WordPress dashboard > Tools > Site Health. Click “Info”. Find the PHP version in the Server section. The PHP Version should be a number, 7.0 or higher. If the number is lower, then this plugin will not work on your site.

Install The Plugin

  1. Download the plugin from its main page.
  2. In your WordPress dashboard, go to Plugins > Add New.
  3. Click Upload Plugin.
  4. Click Browse to upload the ZIP file which you just downloaded.
  5. Click Install Now.
  6. Click Activate Plugin to activate the plugin.

Moving from the old WP Family Tree plugin

You can safely upgrade to this plugin (WP Family Tree Renewed) from the original WP Family Tree plugin by Arvind Shah.

Follow these steps to update from the old plugin to this new one:

  1. Download the plugin from its main page.
  2. In your WordPress dashboard, go to the Plugins page.
  3. Deactivate the old “WP Family Tree” plugin by clicking “Deactivate” under the “WP Family Tree” plugin name.
  4. Click Add New at the top of the page.
  5. Click Upload Plugin.
  6. Click Browse to upload the ZIP file which you just downloaded in step one.
  7. Click Install Now.
  8. Click Activate Plugin to activate the plugin.
  9. After that, you can safely delete the old plugin by clicking Delete under the old “WP Family Tree” plugin name.

Top ↑

Usage

Add a Family Member

To add a family member, create a regular post. Assign the “Family” category to this post. By assigning the “Family” category to a post, it becomes a family member.

In the Family tree info box, you can specify:

  • Gender (Improved gender options are coming soon.)
  • Born date (Enter it like 1970-12-31 for December 31, 1970. If you only know the year, or the month, you can enter just the year or year and month. For example 1970-12 for December of 1970)
  • Died date (Enter it like 1970-12-31 for December 31, 1970. If you only know the year, or the month, you can enter just the year or year and month. For example 1970-12 for December of 1970)
  • Mother (This is a selection field that can only select from the other family members.)
  • Father (This is a selection field that can only select from the other family members.)
  • Spouse (This is a selection field that can only select from the other family members.)

Add a featured image to the post. This will be displayed as their portrait on the family tree and in the family directory list, and of course on their individual page.

Display a Family Tree

To display a family tree, create a regular page in your WordPress dashboard. You can name it whatever you life. Then place the family-tree shortcode into it, like this:

[family-tree]

When you preview the page, if the tree is missing some people, you should add the name of the oldest ancestor that you want displayed in the tree. That person will be the top root (ancestor) of that tree. You must set that person’s name equal to root. For example:

[family-tree root="Grandpa John Doe"]

The name must match exactly to the post title of the person’s post. In this example, the name is “Grandpa John Doe” but you must change that name to a name of your own family member’s post title.

Important Step

After you create this family tree page, you must go to the WP Family Tree Settings page, which is in your dashboard > Settings > WP Family Tree. You must complete the “Link to page with family tree” setting. Enter the URL of the page you created for the family tree shortcode. Enter the entire URL, starting with “https://”.

Display Multiple Family Trees

You can show separate family trees to show all the extended families that you may have. Create a page for each family tree. For example, create a page named, “McClaskey Family” and another page named, “Doe Family.”

On the McClaskey Family page, include the shortcode with the name of the oldest McClaskey ancestor. For example:

[family-tree root="Grandpa McClaskey"]

Then on the Doe Family page, include the shortcode with the name of the oldest McClaskey ancestor. For example:

[family-tree root="Grandpa John Doe"]

These is only an example, you must use your own family names.

Create a Family Directory List

You can a have a page that serves as a Family Directory List. This will list all of the people that you have entered under the “Family” category, even if they are not connected to any family.

To create a family directory list, go ahead and create a regular page in your WordPress dashboard. You can name it whatever you life. Then place the family-members shortcode into it, like this:

[family-members]

Get Help

To get help, you can ask a question below. I am also happy to receive requests for new features, or general feedback on what you think about the plugin.

If you discover a problem, you can also create an issue on the plugin’s GitHub page.

Contributors on GitHub are also very welcome. The plugin needs much refactoring and cleanup.

Updated on July 18, 2019

Questions and Comments are Welcome

Your email address will not be published. All comments will be moderated.

Please wrap code in "code" bracket tags like this:

[code]

YOUR CODE HERE 

[/code]