Added input field "Timespan" in PlaceUpdate gramplet (#448)

* Added timespan

* Removed trailing whitespace

* PlaceUpdate: add help URL and resize detached dialog

Co-authored-by: Kari Kujansuu <[email protected]>

Author: kkujansuu

PlaceUpdate/PlaceUpdate UI.png

@@ -3,15 +3,16 @@
          name = _("PlaceUpdate"),
          description = _("Gramplet to manipulate multiple places"),
          status = STABLE,
-         version = '1.0.3',
+         version = '1.0.4',
          gramps_target_version = '5.1',
          fname = "PlaceUpdate.py",
          gramplet = 'PlaceUpdate',
          height = 375,
          detached_width = 510,
-         detached_height = 480,
+         detached_height = 520,
          expand = True,
          gramplet_title = _("PlaceUpdate"),
          include_in_listing = True,
+         help_url = "http://gramps-project.org/wiki/index.php/PlaceUpdate_Gramplet",
          navtypes=["Place"],
 )

PlaceUpdate/PlaceUpdate-example.png

@@ -23,6 +23,8 @@
 # Author: [email protected]
 # 9 Jun 2019
 #
+# v1.0.4 (30 Aug 2020): added "timespan"
+#
 # Gramplet to change properties of multiple places at the same time. See README.
 
 import re
@@ -32,9 +34,10 @@
 
 from gramps.gen.plug import Gramplet
 from gramps.gen.db import DbTxn
-from gramps.gen.lib import Place, PlaceRef, PlaceName, PlaceType, Tag
+from gramps.gen.lib import Place, PlaceRef, PlaceName, PlaceType, Tag, Date
 
 from gramps.gui.selectors import SelectorFactory
+from gramps.gui.widgets import MonitoredDate, ValidatableMaskedEntry
 
 from gramps.gen.const import GRAMPS_LOCALE as glocale
 try:
@@ -70,7 +73,8 @@ def __tagnames(self):
     def cb_clear(self, obj):
         self.selected_handle = None
         self.selected_name = ""
-        self.enclosing_place.set_text(_("None"))
+        #self.enclosing_place.set_text(_("None"))
+        self.but_set_enclosing.set_label(_("Select"))
         self.tagcombo.get_child().set_text("")
         self.typecombo.get_child().set_text("")
         self.clear_enclosing.set_active(False)
@@ -82,6 +86,8 @@ def cb_clear(self, obj):
         self.use_regex.set_active(False)
         self.old_text.set_text("")
         self.new_text.set_text("")
+        self.date_object.set()
+        self.date_entry.set_text("")
 
     def __create_gui(self):
         vbox = Gtk.VBox(orientation=Gtk.Orientation.VERTICAL)
@@ -110,20 +116,45 @@ def __create_gui(self):
         self.enclosing_place = Gtk.Label(_("None"))
         self.enclosing_place.set_halign(Gtk.Align.START)
 
+        date_label = Gtk.Label(_('Timespan:'))
+        date_label.set_halign(Gtk.Align.START)
+        self.date_entry = ValidatableMaskedEntry()
+        date_button = Gtk.Button.new_from_icon_name("gramps-date", -1)
+        timespan_tooltip = _("Set timespan for enclosing places")
+        date_label.set_tooltip_text(timespan_tooltip)
+        date_button.set_tooltip_text(timespan_tooltip)
+        self.date_entry.set_tooltip_text(timespan_tooltip)
+        self.date_object = Date()
+        self.track = []
+        self.date_field = MonitoredDate(self.date_entry,
+                                        date_button,
+                                        self.date_object,
+                                        self.uistate, self.track)
+
         pt_grid = Gtk.Grid(column_spacing=10)
         pt_grid.attach(pt_label, 0, 0, 1, 1)
         pt_grid.attach(self.typecombo, 1, 0, 1, 1)
 
         pt_grid.attach(tag_label, 0, 1, 1, 1)
         pt_grid.attach(self.tagcombo, 1, 1, 1, 1)
+
         pt_grid.attach(label1, 0, 2, 1, 1)
-        pt_grid.attach(self.enclosing_place, 1, 2, 1, 1)
+
+        pl_grid = Gtk.Grid(column_spacing=10)
+        pl_grid.set_margin_left(20)
+        #pt_grid.attach(self.enclosing_place, 1, 2, 1, 1)
+
+        pl_grid.attach(date_label, 1, 4, 1, 1)
+        pl_grid.attach(self.date_entry, 2, 4, 1, 1)
+        pl_grid.attach(date_button, 3, 4, 1, 1)
 
         vbox.pack_start(pt_grid, False, True, 0)
+        vbox.pack_start(pl_grid, False, True, 0)
 
-        but_set_enclosing = Gtk.Button(label=_('Select enclosing place'))
-        but_set_enclosing.connect("clicked", self.cb_select)
-        vbox.pack_start(but_set_enclosing, False, True, 10)
+        self.but_set_enclosing = Gtk.Button(label=_('Select'))
+        self.but_set_enclosing.connect("clicked", self.cb_select)
+        #vbox.pack_start(self.but_set_enclosing, False, True, 10)
+        pt_grid.attach(self.but_set_enclosing, 1, 2, 1, 1 )
 
         self.clear_enclosing = Gtk.CheckButton(_("Clear original enclosing places"))
         vbox.pack_start(self.clear_enclosing, False, True, 0)
@@ -207,7 +238,18 @@ def cb_select(self, obj):
         title = selected_parent.get_title()
         if title:
             self.selected_name += " (title={})".format(title)
-        self.enclosing_place.set_text(self.selected_name)
+        #self.enclosing_place.set_text(self.selected_name)
+        self.but_set_enclosing.set_label(self.selected_name)
+
+    def cb_set_enclosing_dates(self, obj):
+        #SelectDate = SelectorFactory('Date')
+        sel = EditDate(None, self.gui.uistate, None)
+        date = sel.run()
+        print("date=", date)
+        if not date:
+            return
+        pass
+
 
     def cb_select_generate_hierarchy(self, obj):
         checked = self.generate_hierarchy.get_active()
@@ -302,6 +344,7 @@ def __set_enclosing_place(self, place):
         print(pname, "<", self.selected_name)
         placeref = PlaceRef()
         placeref.ref = self.selected_handle
+        placeref.set_date_object(self.date_object)
         place.add_placeref(placeref)
 
 
@@ -353,6 +396,7 @@ def __generate_hierarchy(self, place, original_enclosing_places):
                 if parent_handle is not None:
                     placeref = PlaceRef()
                     placeref.ref = parent_handle
+                    placeref.set_date_object(self.date_object)
                     new_place.add_placeref(placeref)
                 parent_handle = self.dbstate.db.add_place(new_place, self.trans)
             else:
@@ -363,6 +407,7 @@ def __generate_hierarchy(self, place, original_enclosing_places):
         if parent_handle is not None:
             placeref = PlaceRef()
             placeref.ref = parent_handle
+            placeref.set_date_object(self.date_object)
             place.set_placeref_list([placeref]) # this removes any previous parent
         return top_place
 

PlaceUpdate/PlaceUpdate-example2.png

@@ -23,7 +23,7 @@ The user interface looks like:
 **Setting enclosing place**
 
 For the enclosing place first select the place that should enclose the other places 
-and click the "Set enclosing place" button. The selected place will be displayed.
+and click the "Select" button next to the "New enclosing place" label. The selected place will be displayed as the label of the button.
 Then select any number of places that should  be enclosed by the first one
 and click the "Apply to selected places" button. 
 
@@ -35,6 +35,8 @@ This can e.g. be used to "move" the places under another place.
 Attempts to set a duplicate enclosing place or a loop (so that a place contains itself) 
 are quietly bypassed.
 
+In the "Timespan" field you can specify relevant the date range if needed. This also affects the generated hierarchy (see below).
+
 
 **Setting place type or tag**
 
@@ -66,6 +68,8 @@ The place type and tag setting affects only the original place.
 
 If the original place is under another place or a new enclosing place is specified then the new hierarchy is placed under the enclosing place.
 
+If a timespan is specified then it applies to all levels in the generated hierarchy.
+
 **Editing place names**
 
 The "Replace text" function allows substituting a specified text string in the place names with another. Regular expressions can also be used.

PlaceUpdate/PlaceUpdate.gpr.py

@@ -105,3 +105,7 @@ msgstr "Paikkojen ominaisuuksien asettaminen"
 #: PlaceTool/PlaceTool.py:272
 msgid "Regex operation failed: {}"
 msgstr ""
+
+msgid "Timespan:"
+msgstr "Aikaväli:"
+