Is there any user documenation module

koyauni - December 13, 2008 - 13:44
Project:Family Tree 2
Version:6.x-1.1
Component:Documentation
Category:support request
Priority:normal
Assigned:Unassigned
Status:postponed
Description

I find it difficult to make use of this module, is there any documentation available so it will guide me through?

#1

Microbe - December 13, 2008 - 16:04

There isn't any documentation on how to use it at the moment. I think that that is something that should come quite soon.

For now though here is a quick guide:


There are two main ways of building your family tree.

  1. Importing a GEDCOM file that has been exported from another program
  2. Adding all nodes/people individually through Drupal

You can import via GEDCOM and then add other things via Drupal if you already have you family tree on another program.

1 GEDCOM

To import a GEDCOM file goto Administer > Content Management > Family Import browse for GEDCOM file and click start import.

2 Adding Manually

NB: It is best to start at the top of your family tree when entering data (oldest first)

  1. First add the parent individuals by creating a node each for them. Create Content > Family: Individual
  2. Then add a Family: Group node for each relationship (husband & wife/partners not parent child)
  3. Then add the child individuals of the parent group by creating a node each for them. Create Content > Family: Individual. When creating the individuals you are able to select an "Ancestry group" which you should select the group node you created for the parents.
  4. Add any individuals that create partners on this level
  5. Repeat steps 2 to 4 until you reach the bottom of the tree.

You don't have to create individuals layer by layer coming down your family tree but it can be easier as you can't select the parent group of an individual until you have created that group




I don't have a lot of time right now to make it more detailed and add helpful pictures.
If there is anything else you would like to know feel free to ask.

I hope this short guide helps
Peter

#2

djphaezer - December 19, 2008 - 22:00

Customizing the Look of the Family Tree Module

I found it really useful to use Views to customize this module for my site.

For example, I wanted to customize the look of the following pages:

/family/
/family/individual/
/family/group/
/family/location/

What I wanted to do is add information to explain to the user what to do, and edit some of the default info on the /family/ page to reflect how I set up my site. Here's what I did:

Log in as Admin
Go to Admin -> Site Building -> Modules
Enable the "PHP Filter" module
Go to Admin -> Site Building -> Views
Click "Edit" on "Node view: family"

On the left side you'll see a menu that says:
* Defaults
* Family Page
* Individuals Page
* Groups Page
* Locations Page

Click on "Family Page"
Under "Basic Settings" select "Header"
This opens up a box to edit the text on the page /family/
I edited replaced the code there with this code:

<p>
Welcome to the family area. Here you can view all the data on the website. In the left menu you can choose to view all individuals, groups and locations. To view a family tree, ascendancy or descendancy go to the page of the family member you want to view and click the associated tab along the top menu.
</p>
<p>
If you have more information to add to this family tree you can add it by clicking <a href="family/group">'Groups'</a>, <a href="family/individual">'Individuals'</a> or <a href="family/location">'Locations'</a> on the side menu or commenting on the page you have information to add to. If you are not sure how to do this please contact the webmaster.
</p>
<div class="item-list" style="font-size: 120%;">
<?php
global $user;
print
"<ul>\n";
print
"<li style=\"padding-top: 5px;\">".l("View your own information","node/".$user->family_link)."</li>\n";
print
"<li style=\"padding-top: 5px;\">".l("View your family tree","node/".$user->family_tree_root."/tree/".$user->family_tree_type, array('html'=>'TRUE','query'=>'len='.$user->family_tree_depth))."</li>\n";
print
"<ul>\n";
?>

</div>
<p>
<h2>List of recent updates:</h2>
</p>

Note that changes were made to the instructions so that they fit my site's menus, links were added to the instructions, and PHP links were added at the bottom.

After you've made your changes, click on "Input Format" and select "PHP Code"
Then click on "Update" and then "Save"

Now check out your new /family/ page...

There are now links there that look like this (see attached example1.jpg)

The process for customizing the other pages (/family/individual/, etc) is basically the same, except that you'll want to make sure that when you edit the "Header" for each of the other pages, you click the "Override" button so that it uses whatever you put in the header for ONLY the /family/individual/ page - otherwise, it will update the default layout.

For example, on each of my other three pages (/family/individual/, /family/group/, and /family/location/) I added a link at the top to direct people to add a new individual, group, or location, like so:

<div class="item-list" style="font-size: 120%;">
<ul>
<li><a href="../node/add/family-individual" style="padding-top: 5px;">Add a new individual</a></li>
</ul>
</div>

<div class="item-list" style="font-size: 120%;">
<ul>
<li><a href="../node/add/family-group" style="padding-top: 5px;">Add a new group</a></li>
</ul>
</div>

<div class="item-list" style="font-size: 120%;">
<ul>
<li><a href="../node/add/family-location" style="padding-top: 5px;">Add a new location</a></li>
</ul>
</div>

And your result is as shown below (example2.jpg)

AttachmentSize
example1.JPG 116.42 KB
example2.JPG 118.18 KB

#3

JohnColeman - February 1, 2009 - 20:59

Hi djp

your suggestions were really helpful, and so is Family Tree 2, and Drupal.

Thanks a lot to everyone.

#4

pyutaros - February 12, 2009 - 05:43
Status:active» postponed

Documentation pending. Unless someone else takes this up, I will not get to it for another couple months.

 
 

Drupal is a registered trademark of Dries Buytaert.