add GIS integration documentation for farmer registry

Author: anthonymarkQA

docs/user_guide/administration/farmer_geolocation.md

@@ -0,0 +1,27 @@
+# Integrate Geolocation
+
+This guide provides step-by-step instructions for integrating geolocation platforms such as MapTiler with the OpenSPP Farmer Registry module to enhance area-based functionality.
+
+## Prerequisites
+To enable geolocation integration in OpenSPP, ensure the following:
+- Your user account has the System Admin role. Learn more in this guide: {doc}`user_access`
+- Your OpenSPP instance installed Farmer registry base module. Learn more in this gu
+- You have an API Key for MapTiler to enable GIS functionality. You can retrieve this by checking their documentation [here](https://docs.maptiler.com/cloud/api/).
+- Developer mode in OpenSPP is enabled to allow configuration of the MapTiler key. For details, refer to the {doc}`../../developer_guide/developer_mode`
+
+## Objective
+By the end of this guide, you will be able to configure MapTiler integration to support area-based features in the Farmer Registry.
+
+## Process
+
+### Setting Up the API Key for MapTiler
+As a System Admin, log in to your OpenSPP Farmer Registry instance. Go to **Settings**, then select **Technical**, and click **System Parameters**.
+
+![Settings menu with Technical and System Parameters options](farmer_geolocation/farmer_geolocation_system_parameters.png)
+
+Click the **New** button. Set the Key field to **spp_base_gis.map_tiler_api_key** and enter your MapTiler API Key in the **value** field.
+
+![Setup farmer registry maptiler key](farmer_geolocation/farmer_geolocation_maptiler_key.png)
+
+Click the **Save** button to apply the configuration. Refresh your browser to see the changes.
+

…y/setup_farmer_registry_maptiler_key.png …tion/farmer_geolocation_maptiler_key.pngdocs/user_guide/registry_management/setting_up_farmer_registry/setup_farmer_registry_maptiler_key.png renamed to docs/user_guide/administration/farmer_geolocation/farmer_geolocation_maptiler_key.png docs/user_guide/registry_management/setting_up_farmer_registry/setup_farmer_registry_maptiler_key.png renamed to docs/user_guide/administration/farmer_geolocation/farmer_geolocation_maptiler_key.png

@@ -15,6 +15,8 @@ This section provides guides for a variety of administrative tasks and system ma
 
 - {doc}`inventory_configuration`: Learn how to configure the necessary inventory settings to support in-kind and basket entitlements.
 
+- {doc}`farmer_geolocation`: Guide to enabling geolocation integration in the OpenSPP Farmer Registry to improve area-based operations.
+
 - {doc}`incoming_email_configuration`: A guide to setting up automatic email retrieval and processing from a designated incoming mailbox.
 
 - {doc}`outgoing_email_configuration`: A guide to setting up outgoing email servers for automated messaging and data integration.
@@ -41,6 +43,7 @@ User access <user_access>
 Custom fields <custom_fields>
 Indicator fields <indicator_fields>
 Import areas <import_areas>
+Integrate Geolocation <farmer_geolocation>
 Service points <service_points>
 Inventory setup <inventory_configuration>
 Incoming email setup <incoming_email_configuration>

…agement/setting_up_farmer_registry/5.png …farmer_geolocation_system_parameters.pngdocs/user_guide/registry_management/setting_up_farmer_registry/5.png renamed to docs/user_guide/administration/farmer_geolocation/farmer_geolocation_system_parameters.png docs/user_guide/registry_management/setting_up_farmer_registry/5.png renamed to docs/user_guide/administration/farmer_geolocation/farmer_geolocation_system_parameters.png

@@ -9,7 +9,6 @@ Guides for managing registrant data and registry operations:
 
 - {doc}`registry_management/register_individual`
 - {doc}`registry_management/import_export_registrant_data`
-- {doc}`registry_management/setting_up_farmer_registry`
 - {doc}`registry_management/identity_management`
 - {doc}`registry_management/using_change_requests`
 - {doc}`registry_management/using_event_data`
@@ -37,6 +36,7 @@ Administrative tasks and system management:
 - {doc}`administration/indicator_fields`
 - {doc}`administration/import_areas`
 - {doc}`administration/inventory_configuration`
+- {doc}`administration/farmer_geolocation`
 - {doc}`administration/incoming_email_configuration`
 - {doc}`administration/outgoing_email_configuration`
 - {doc}`administration/hardware_integration`

docs/user_guide/administration/index.md

@@ -11,8 +11,6 @@ This section provides essential guides for managing the core of OpenSPP: the reg
 
 - {doc}`register_individual`: Details the process of manually creating individual and group records and associating individuals as members of a group.
 
-- {doc}`setting_up_farmer_registry`: Instructions for installing and configuring the Farmer Registry module, including the generation of sample farmer data.
-
 - {doc}`using_change_requests`: Explains how to use the Change Request module to update registrant information, including the workflow for initiating, validating, and approving changes.
 
 - {doc}`using_event_data`: This guide explains how to use the Event Data feature to record and track significant occurrences related to registrants over time.
@@ -24,7 +22,6 @@ This section provides essential guides for managing the core of OpenSPP: the reg
 
 Register individuals <register_individual>
 Import/Export data <import_export_registrant_data>
-Farmer Registry setup <setting_up_farmer_registry>
 Identity management <identity_management>
 Change requests <using_change_requests>
 Event data <using_event_data>