From e7e1b74aae8fa1da1c87a1aaa03a536378febe6d Mon Sep 17 00:00:00 2001
From: SNoiraud <serge.noiraud@laposte.net>
Date: Wed, 29 Jun 2022 18:36:17 +0200
Subject: [PATCH] Narweb: clarify how to get the API_KEY

Fixes #12646
---
 gramps/plugins/webreport/narrativeweb.py | 28 +++++++++++++++++++++++-
 1 file changed, 27 insertions(+), 1 deletion(-)

diff --git a/gramps/plugins/webreport/narrativeweb.py b/gramps/plugins/webreport/narrativeweb.py
index 82f7f9bea4f..5ceedd92253 100644
--- a/gramps/plugins/webreport/narrativeweb.py
+++ b/gramps/plugins/webreport/narrativeweb.py
@@ -1891,6 +1891,7 @@ def __init__(self, name, dbase):
         self.__googleopts = None
         self.__googlemapkey = None
         self.__olv = None
+        self.googlemapkeyhelp = None
         self.__ancestortree = None
         self.__css = None
         self.__gallery = None
@@ -2491,8 +2492,23 @@ def __add_place_map_options(self, menu):
         addopt("googleopts", self.__googleopts)
 
         self.__googlemapkey = StringOption(_("Google maps API key"), "")
-        self.__googlemapkey.set_help(_("The API key used for the Google maps"))
+        self.__googlemapkey.set_help(_("The API key used for the Google maps.\n"
+                                       "This key is mandatory and must be valid"
+                                      ))
+        if not config.is_set("paths.website-get-api-key"):
+            # The following will be used to change the URL if it changes without
+            # creating a patch. We will only need to change gramps.ini
+            config.register("paths.website-get-api-key",
+                "https://developers.google.com/maps/documentation/javascript/get-api-key")
+        keyvalue = config.get("paths.website-get-api-key")
+        self.googlemapkeyhelp = StringOption(_("How to get the API key"),
+                                             keyvalue)
+        self.googlemapkeyhelp.connect('value-changed', self.url_changed)
+        keytooltip = _("Copy and paste this value in your browser."
+                       "\nThe Google maps service must be selected.")
+        self.googlemapkeyhelp.set_help(keytooltip)
         addopt("googlemapkey", self.__googlemapkey)
+        addopt("googlemapkeyhelp", self.googlemapkeyhelp)
 
         stamenopts = [
             (_("Toner"), "toner"),
@@ -2840,8 +2856,18 @@ def __placemap_options(self):
 
         if (place_active or family_active) and mapservice_opts == "Google":
             self.__googlemapkey.set_available(True)
+            self.googlemapkeyhelp.set_available(True)
         else:
             self.__googlemapkey.set_available(False)
+            self.googlemapkeyhelp.set_available(False)
+
+    def url_changed(self):
+        """
+        This value must be changed only if the url is modified.
+        """
+        api_key_url = self.googlemapkeyhelp.get_value()
+        if api_key_url != "":
+            config.set("paths.website-get-api-key", api_key_url)
 
     def __add_calendar_options(self, menu):
         """