Difference between revisions of "Addon:AddRemoveTagTool"

From Gramps
Jump to: navigation, search
(Option 2 tab)
(Update tool options and add new screenshots)
Line 1: Line 1:
 
{{Third-party plugin}}
 
{{Third-party plugin}}
[[File:Remove Tag Tool.png|thumb|right|450px|Remove Tag Tool - Options dialog]]
+
The {{man label|Add/Remove Tag Tool}} allows you to add or remove one [[Gramps_{{Version manual}}_Wiki_Manual_-_Filters#Tagging|tag]] from a selected set of filtered objects e.g. people, events, etc.
The {{man label|Remove Tag Tool}} allows you to remove one [[Gramps_{{Version manual}}_Wiki_Manual_-_Filters#Tagging|tag]] from a selected set of filtered objects e.g. people.
 
  
 
==Usage==
 
==Usage==
 
Once this plugin has been installed:
 
Once this plugin has been installed:
* Select Menu {{man menu|Tools > Family Tree Processing -> Remove Tag Tool...}}
+
* Select Menu {{man menu|Tools > Family Tree Processing -> Add/Remove Tag Tool...}}
  
 
{{man warn|Undo history warning|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and [[How_to_make_a_backup|backup]] your database.}}
 
{{man warn|Undo history warning|Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and [[How_to_make_a_backup|backup]] your database.}}
Line 13: Line 12:
 
Once you have made your choices which tag should be removed from which objects, you can either choose {{man button|Close}} or {{man button|Execute}} to apply the change.
 
Once you have made your choices which tag should be removed from which objects, you can either choose {{man button|Close}} or {{man button|Execute}} to apply the change.
  
===Option 1 tab===
+
===General options tab===
The '''Option 1''' tab is displayed with the following:
+
[[File:Removetagtool1.png|thumb|right|450px|Remove Tag Tool - General options dialog]]
* '''Category Filter:''' The category from where you want to remove a tag from e.g. people. (always selectable)
+
[[File:Removetagtool2.png|thumb|right|450px|Remove Tag Tool - Filter options dialog]]
* '''Remove Tag Filter:''' The name of the tag you choose to remove. (always selectable, when at least one tag exists in the database)
+
The '''General options''' tab is displayed with the following:
* '''Person Filter:''' A generic or custom filter to restrict the amount of people where you want to remove the tag from. (Only selectable when ''person'' is selected in the ''Category Filter'')
+
* '''Add/Remove Filter:''' Select if you want to add or remove a tag.
* '''Center Person Selector:''' The center person which is needed for some generic filters. (Only selectable when ''person'' is selected in the ''Category Filter'' and the chosen person filter requires a center person)
+
* '''Category Filter:''' The category from where you want to add/remove a tag from e.g. people.
* '''Family Filter:''' A generic or custom filter to restrict the amount of families where you want to remove the tag from. (Only selectable when ''family'' is selected in the ''Category Filter'')
+
* '''Tag Filter:''' The name of the tag you choose to add/remove.
* '''Center Family Selector:''' The center family which is needed for some generic filters. (Only selectable when ''family'' is selected in the ''Category Filter'' and the chosen family filter requires a center family)
+
 
 +
===Filter options tab===
 +
The '''Filter options''' tab is displayed with the following. Each filter is only selectable when the corresponding category was selected:
 +
* '''Person Filter:''' All persons or a custom filter to restrict the amount of persons where you want to remove the tag from.
 +
* '''Family Filter:''' All families or a custom filter to restrict the amount of families where you want to remove the tag from.
 +
* '''Event Filter:''' All events or a custom filter to restrict the amount of events where you want to remove the tag from.
 +
* '''Place Filter:''' All places or a custom filter to restrict the amount of places where you want to remove the tag from.
 +
* '''Source Filter:''' All sources or a custom filter to restrict the amount of sources where you want to remove the tag from.
 +
* '''Citation Filter:''' All citations or a custom filter to restrict the amount of citations where you want to remove the tag from.
 +
* '''Repository Filter:''' All repositories or a custom filter to restrict the amount of repositories where you want to remove the tag from.
 +
* '''Media Filter:''' All media or a custom filter to restrict the amount of media where you want to remove the tag from.
 +
* '''Note Filter:''' All notes or a custom filter to restrict the amount of notes where you want to remove the tag from.
  
===Option 2 tab===
 
The '''Option 2''' tab is displayed with the following:
 
* '''Event Filter:''' All events or a custom filter to restrict the amount of events where you want to remove the tag from. (Only selectable when ''event'' is selected in the ''Category Filter'')
 
* '''Place Filter:''' All places or a custom filter to restrict the amount of places where you want to remove the tag from. (Only selectable when ''place'' is selected in the ''Category Filter'')
 
* '''Source Filter:''' All sources or a custom filter to restrict the amount of sources where you want to remove the tag from. (Only selectable when ''source'' is selected in the ''Category Filter'')
 
* '''Citation Filter:''' All citations or a custom filter to restrict the amount of citations where you want to remove the tag from. (Only selectable when ''citation'' is selected in the ''Category Filter'')
 
* '''Repository Filter:''' All repositories or a custom filter to restrict the amount of repositories where you want to remove the tag from. (Only selectable when ''repository'' is selected in the ''Category Filter'')
 
* '''Media Filter:''' All media or a custom filter to restrict the amount of media where you want to remove the tag from. (Only selectable when ''media'' is selected in the ''Category Filter'')
 
* '''Note Filter:''' All notes or a custom filter to restrict the amount of notes where you want to remove the tag from. (Only selectable when ''note'' is selected in the ''Category Filter'')
 
  
 
==See also==
 
==See also==

Revision as of 10:49, 29 October 2020

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

The Add/Remove Tag Tool allows you to add or remove one tag from a selected set of filtered objects e.g. people, events, etc.

Usage

Once this plugin has been installed:

  • Select Menu Tools > Family Tree Processing -> Add/Remove Tag Tool...
Gnome-important.png
Undo history warning

Proceeding with this tool will erase the undo history for this session. In particular, you will not be able to revert the changes made by this tool or any changes made prior to it. If you think you may want to revert running this tool, please stop here and backup your database.

  • From the Undo history warning dialogue you can choose Stop or Proceed with the tool.

Once you have made your choices which tag should be removed from which objects, you can either choose Close or Execute to apply the change.

General options tab

Remove Tag Tool - General options dialog
Remove Tag Tool - Filter options dialog

The General options tab is displayed with the following:

  • Add/Remove Filter: Select if you want to add or remove a tag.
  • Category Filter: The category from where you want to add/remove a tag from e.g. people.
  • Tag Filter: The name of the tag you choose to add/remove.

Filter options tab

The Filter options tab is displayed with the following. Each filter is only selectable when the corresponding category was selected:

  • Person Filter: All persons or a custom filter to restrict the amount of persons where you want to remove the tag from.
  • Family Filter: All families or a custom filter to restrict the amount of families where you want to remove the tag from.
  • Event Filter: All events or a custom filter to restrict the amount of events where you want to remove the tag from.
  • Place Filter: All places or a custom filter to restrict the amount of places where you want to remove the tag from.
  • Source Filter: All sources or a custom filter to restrict the amount of sources where you want to remove the tag from.
  • Citation Filter: All citations or a custom filter to restrict the amount of citations where you want to remove the tag from.
  • Repository Filter: All repositories or a custom filter to restrict the amount of repositories where you want to remove the tag from.
  • Media Filter: All media or a custom filter to restrict the amount of media where you want to remove the tag from.
  • Note Filter: All notes or a custom filter to restrict the amount of notes where you want to remove the tag from.


See also