View source for Addon:Deep Connections Gramplet

{{languages|Addon:Deep Connections Gramplet}}
{{Third-party addon}}
[[File:DeepConnectionsGramplet-addon-example-50.png|thumb|right|450px|Deep Connections Gramplet - example results]]

The {{man label|Deep Connections}} Gramplet shows a deep relationship between active person and home person. The Deep Connections Gramplet will find all relationships between the [[Gramps_Glossary#home_person|home person]] and [[Gramps_Glossary#active_person|active person]], if one exists. Similar to the builtin [[Gramps_{{Version manual}}_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].

==Usage==
Add the {{man label|Deep Connections}} Gramplet to one of the following Category views: People, Relationships, Charts or Geography.

[[File:DeepConnectionsGramplet-addon-NoHomePersonSet-message-51.png|thumb|right|350px|Deep Connections Gramplet - No Home Person set. - message]]
Make sure you have [[Gramps_{{Version manual}}_Wiki_Manual_-_Navigation#Setting_the_Home_Person|set the Home Person]] otherwise you will receive the message: '''{{man label|No Home Person set.}}''' .

Select another person from the People list view to make them active then change to the {{man label|Deep Connections}} Gramplet to see the result, this can take some time, as it thoroughly searches through all relationships. The {{man label|Deep Connections}} Gramplet reports a chain of people that form a related connection between the Active Person and the Home Person.

You can {{man button|Pause}} the Gramplet or {{man button|Copy}} the person to the Clipboard or even have the Gramplet {{man button|Continue}} to attempt to find additional connections.
=== Context menu actions ===
Right-clicking inside the gramplet results (but not on a hotlink) will show a pop-up context menu.  The options are: Cut ''(disabled)'', Copy (enabled only when text is has been highlighted), Paste ''(disabled)'', Delete ''(disabled)'', and Select All.

Right-clicking on the titlebar of undocked (detached, torn off) Deep Connections Gramplet will show a pop-up context menu.  The options are: Restore ''(disabled)'', Move, Resize, Minimize ''(disabled)'', Maximize ''(disabled)'', and Close.
=== Hotlink actions ===
Right-clicking on a hotlinked Person name will shift the [[Gramps_Glossary#active_person|Active Person]] focus to that Person. This also triggers a recalculation of the Deep Connections of the new Active Person to the [[Gramps_Glossary#home_person|Home Person]].

Left-clicking on a hotlinked Person name will open the [[Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Edit_Person_dialog|Person Editor]] for that Person.

==See also:==
* The '''[[Gramps_{{Version manual}}_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]]'''
* The '''Relationship to home person''' [[Gramps_{{Version manual}}_Wiki_Manual_-_Settings#Display|Display Preferences]] option for the Status bar
* '''[[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_8#Relation_to_Home_Person|Relation to Home Person]]''' [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_8#Quick_Views|quick view]].
* The Isotammi '''[[Addon:Isotammi_addons#Deep_Connections_Graph|Deep Connection Graph]]''' - local server dashboard gramplet
<!--
* The '''[[Deep_Connections_Gramplet|Deep Connections]]''' gramplet: If this third party addon is installed, it will list the intervening generations through the sibling offspring of a common ancestor. (But it does not list the common ancestor or if both person a connected through the same spouse.) The Gramplet also details the indirect relationships. 
-->

== Issues ==
* When view expanded the display area does not fill the entire window/dialog.
* {{bug|4458}} Deep Connections Gramplet does not find all possible paths
* {{bug|6467}} Deep Connections Gramplet: Doubly redundant relations

[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Gramplets]]