Difference between revisions of "Addon:Deep Connections Gramplet"

From Gramps
Jump to: navigation, search
(Usage)
m (See also:: typo)
(19 intermediate revisions by 5 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: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]].
+
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]].
  
 
==Usage==
 
==Usage==
 
Add the {{man label|Deep Connections}} Gramplet to one of the following Category views: People, Relationships, Charts or Geography.
 
Add the {{man label|Deep Connections}} Gramplet to one of the following Category views: People, Relationships, Charts or Geography.
  
Make sure you have [[Gramps_{{Version manual}}_Wiki_Manual_-_Navigation#Setting_the_Home_Person|set the Home Person]] otherwise you will receive the message: '''No Home Person set.'''.
+
[[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.
+
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}} copy the result or even have the Gramplet {{man button|Continue}} to attempt to find additional connections.
+
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:==
 
==See also:==
 
* The '''[[Gramps_{{Version manual}}_Wiki_Manual_-_Tools#Relationship_Calculator|Relationship Calculator]]'''
 
* 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
 
* The '''Relationship to home person''' [[Gramps_{{Version manual}}_Wiki_Manual_-_Settings#Display|Display Preferences]] option for the Status bar
* '''Relation to Home Person''' [[Gramps_{{Version manual}}_Wiki_Manual_-_Reports_-_part_8#Quick_Views|quick view]].
+
* '''[[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 add-on 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.  
+
* 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|Ctrl+C}} (Copy) brings up the '''Clipboard''' but nothing is actually copied to clipboard. ''Gramps redefined that hotkey ([[Gramps_{{man version}}_Wiki_Manual_-_Keybindings|keybinding]]) combination. Use the right-click pop-up menu instead.''
 
 
* 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/dialog.
 
* {{bug|4458}} Deep Connections Gramplet does not find all possible paths
 
* {{bug|4458}} Deep Connections Gramplet does not find all possible paths
* {{bug|6467}} Deep Connections gramplet: Doubly redundant relations
+
* {{bug|6467}} Deep Connections Gramplet: Doubly redundant relations
  
 
[[Category:Plugins]]
 
[[Category:Plugins]]
 
[[Category:Developers/General]]
 
[[Category:Developers/General]]
 
[[Category:Gramplets]]
 
[[Category:Gramplets]]

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.

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