Open main menu

Gramps β

Changes

Addon:BirthOrderTool

1,404 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.
==What is it For?==If nothing appears here, then none of your families have unsorted children.
The * '''Birth Order Tool{{man menu|Selecting a family from this list updates the data in both the lower panes.}}''' searches your database for families that have children which are not listed in the order of their births and assists in ordering them. ==Usage==
* Once It is also possible to sort this plugin 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 be 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_{{man version}}_Wiki_Manual_-_FAQ#How_do_I_change_the_order_of_children.3F|How do I change the order of children?]]
==Some Notes==* Use the [[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.* Use this third-party addon {{man label|[[Addon:BirthOrderTool|Sort Children in Birth order]]}} tool which allows bulk updates of the children order.
See also:* When changes are accepted, they appear in the 'Undo' list This [[Gramps_{{man menu|Edit -> Undo History...version}} where they can be undone. They can also be undone individually via {{man menu_Wiki_Manual_-_Gramplets#Children|Edit -> Undo}}. Changes from Children]] gramplet in the [[Gramps_{{man button|Acceptversion}} button are listed individually as _Wiki_Manual_-_Categories#People_Category|People Category]] views displays all children from '''all marriages''Edit Family', those from for the {{man button|Accept All}} or {{man button|Accept All *}} buttons active person. Children are listed displayed as 'Edit families' ordered in the undo listfamily record(s).
==Issues==
[[Category:Addons]]
[[Category:Plugins]]
[[Category:Developers/General]]
[[Category:Tools]]
15,091
edits