Open main menu

Gramps β

Changes

Addon:BirthOrderTool

978 bytes added, 01:26, 8 October 2025
Proposed sort pane
{{Third-party pluginaddon}}[[File:SortChildrenInBirthOrderTool-addon-example-60.png|thumb|right|450px|Sort Children in Birth order - Tool - example window]]The {{man label|Sort Children in Birth order}} tool searches your family tree for families that have children which are not listed in the order of their births and assists in ordering them. Allows bulk updates of the children order.
[[File:BirthOrder==Usage==* Select Menu {{man menu|Tools -> Family Tree Processing -> Sort Children in Birth order...png}} {{man warn|thumbWarning|rightProceeding with this tool may make unexpected changes to your data. While it is possible to '''Undo''' the changes made by this tool, it may be easier to recover from a backup.}} * When the tool starts, it scans you data for families that need sorting. A progress bar appears so that with large databases Gramps doesn't seem to be frozen. This does not make '''any''' changes to your data, and only performs the search and fills the panes if unsorted families are found. Families with children in birth order are not shown. If some children in a family don't have valid birth dates, but others are in order, the family is not shown.* When the scan is complete the results will be shown in the {{man label|450px[[#Sort_Children_in_Birth_order_dialog|Sort Children in Birth Order Tool - example windoworder]]}} window dialog. ===Sort Children in Birth order dialog===The {{man label|Sort Children in Birth order}} window dialog shows three main panes and some buttons.====top pane====The top pane will contain a list of the results of the search.  If nothing appears here, then none of your families have unsorted children.
The * '''Birth Order Tool''' searches your database for families that have children which are not listed in {{man menu|Selecting a family from this list updates the order of their births and assists data in ordering them. Allows bulk updates of both the children orderlower panes.==Usage==}}'''
* Once It is also possible to sort this addon has been installed * Select Menu {{man menu|Tools -list for <code> Family Tree Processing -ID</code> Sort Children in Birth Order.., <code>Father</code>, or <code>Mother</code>, using the header of the list.}}
====Current sort pane====The {{man warnlabel|Warning|Proceeding Current sort}} pane (lower left side) will show the original unmodified list of children with this tool may make unexpected changes to your datatheir birth dates, if any. While it is possible to '''Undo''' the changes made by this tool, it may This cannot be easier to recover from a backupchanged.}}
* When the tool starts, it scans you data for families that need sorting. A progress bar appears so that with large databases Gramps doesn't seem to be frozen. This does not make '''any''' changes to your data, only performs the search and fills the panes if unsorted families are found. Families with children in birth order are not shown. If some children in a family don't have valid birth dates, but others are in order, the family is not shown.* At this point the tool window with three main panes and some buttons should be visible.====Proposed sort pane====** The top pane will contain a list of the results of the search. If nothing appears here, then none of your families have unsorted children. Selecting a family from this list updates the data in the lower panes. It is also possible to {{man label|Proposed sort this list for ID, Father, or Mother, using the header of the list.** The lower left }} pane will show the original unmodified list of children with their birth dates, if any. This cannot be changed.** The (lower right pane side) will show the proposed changes to the children sortfor the Selected family in the top pane results. If the user wants to make additional changes, they can be made directly in the Proposed sort pane. Adjusting the sort manually can be done by selecting a child and using either the {{man button|Up}} or {{man button|Down}} buttons below the pane. When you are satisfied with the changes, if any, you can use the {{man button|Accept}} button to save the proposed sort order to the database.
* Many times, the user will not feel a need to make manual changes, the proposed sort order if acceptable. The tool offers two buttons that allow the user to accept some or all of the listed families.
** The {{man button|Accept All *}} button will accept all the families that have a '<code>*</code>' (Asterisk) next to them. In these families all the children have valid birth dates so that sorting can be done unambiguously. When this button is used, a progress bar appears so that with large databases Gramps doesn't seem to be frozen.
** The {{man button|Accept All}} button will accept '''all''' the families, even those with some missing or invalid birth dates. In these cases, the sorted results is the same as shown in the lower right 'Proposed sort' pane. That is, children with invalid or missing birth dates will be sorted first, followed by those with valid dates. When this button is used, a progress bar appears so that with large databases Gramps doesn't seem to be frozen.
* If you do not want any changes to be made to your data, or you are done with the tool, you can simply press the {{man button|Done}} button.
* The {{man button|Help}} button will bring up show this page.
===Some Notes===
* When changes are accepted, they appear in the 'Undo' list {{man menu|Edit -> Undo History...}} where they can be undone. They can also be undone individually via {{man menu|Edit -> Undo}}. Changes from the {{man button|Accept}} button are listed individually as ''Edit Family'', those from the {{man button|Accept All}} or {{man button|Accept All *}} buttons are listed as ''Edit families'' in the undo list.
==See also==
[[Gramps_5.0_Wiki_Manual_Gramps_{{man version}}_Wiki_Manual_-_FAQ#How_do_I_change_the_order_of_children.3F|How do I change the order of children?]]Use:* The Family Editor Use the [[Gramps_5.0_Wiki_Manual_Gramps_{{man version}}_Wiki_Manual_-_Entering_and_editing_data:_detailed_-_part_1#Children|Children]] tab in the Family Editor to change the order of children in the active family.* This Use this third -party addon {{man label|[[Addon:BirthOrderTool|Sort Children in Birth Order Toolorder]] }} tool which allows bulk updates of the children order. See also:* This [[Gramps_{{man version}}_Wiki_Manual_-_Gramplets#Children|Children]] gramplet in the [[Gramps_{{man version}}_Wiki_Manual_-_Categories#People_Category|People Category]] views displays all children from '''all marriages''' for the active person. Children are displayed as ordered in the family record(s).
==Issues==
[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Tools]]
15,091
edits