Open main menu

Gramps β

Difference between revisions of "Addon:Deep Connections Gramplet"

(Issues)
m (See also:: typo)
 
(33 intermediate revisions by 7 users not shown)
Line 1: Line 1:
 +
{{languages|Addon:Deep Connections Gramplet}}
 
{{Third-party plugin}}
 
{{Third-party plugin}}
 +
[[File:DeepConnectionsGramplet-addon-example-50.png|thumb|right|450px|Deep Connections Gramplet - example results]]
  
[[File:Deep-Connections-Gramplet-example-view-41.png|thumb|right|300px|Deep Connections Gramplet - example view in action]]
+
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 built-in [[Gramps_{{Version manual}}_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]].
  
Similar to the [[Gramps_4.1_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]], the Deep Connections Gramplet will find a relationship between the home and active people, if one exists. However, this gramplet will find all relationships.
+
==Usage==
 +
Add the {{man label|Deep Connections}} Gramplet to one of the following Category views: People, Relationships, Charts or Geography.
  
This can take some time, as it thoroughly searches through all relationships. The Deep Connections Gramplet gives you a chain of people that form a related connection between the Active Person and the Home Person.
+
[[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.}}''' .
  
If you receive the message: '''No Home Person set.''' you can follow these instructions to [[Gramps_4.1_Wiki_Manual_-_Navigation#Setting_the_Home_Person|set the Home Person]].
+
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 ==
 
== Issues ==
* Pressing {{man button|Copy}} brings up the '''Clipboard''' but nothing is actually copied to clipboard.
+
* When view expanded the display area does not fill the entire window/dialog.
* When view expanded the display area does not fill the entire window.
+
* {{bug|4458}} Deep Connections Gramplet does not find all possible paths
* {{bug|8169}} Pressing {{man button|Continue}} causes an error.
+
* {{bug|6467}} Deep Connections Gramplet: Doubly redundant relations
* {{bug|6467}} Deep Connections gramplet: Doubly redundant relations (unable to test due to previous error with {{man button|Continue}})
 
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Gramplets]]
 
[[Category:Gramplets]]

Latest revision as of 14:14, 7 May 2022

Gramps-notes.png

Please use carefully on data that is backed up, and help make it better by reporting any comments or problems to the author, or issues to the bug tracker
Unless otherwise stated on this page, you can download this addon by following these instructions.
Please note that some Addons have prerequisites that need to be installed before they can be used.
This Addon/Plugin system is controlled by the Plugin Manager

Deep Connections Gramplet - example results

The Deep Connections Gramplet shows a deep relationship between active person and home person. The Deep Connections Gramplet will find all relationships between the home person and active person, if one exists. Similar to the built-in Relationship Calculator.

Contents

Usage

Add the Deep Connections Gramplet to one of the following Category views: People, Relationships, Charts or Geography.

 
Deep Connections Gramplet - No Home Person set. - message

Make sure you have set the Home Person otherwise you will receive the message: No Home Person set. .

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

You can Pause the Gramplet or Copy the person to the Clipboard or even have the Gramplet 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 Active Person focus to that Person. This also triggers a recalculation of the Deep Connections of the new Active Person to the Home Person.

Left-clicking on a hotlinked Person name will open the Person Editor for that Person.

See also:

Issues

  • When view expanded the display area does not fill the entire window/dialog.
  • 4458 Deep Connections Gramplet does not find all possible paths
  • 6467 Deep Connections Gramplet: Doubly redundant relations